How to install and switch custom mods, modpacks, and maps on a server

Running custom content on a Minecraft server requires matching the right mod loader, Java version, and folder structure. This intermediate guide covers how to install individual mods, upload full custom modpacks, and switch maps safely.

Prerequisites: Loaders, Java versions, and RAM

Before uploading files, your server must run software that supports your content. Vanilla software only runs custom maps and datapacks. Paper, Purpur, and Spigot run server-side plugins. To run mods or modpacks, you must install a compatible mod loader: Fabric (latest loader 0.20.1), Quilt, Forge, or NeoForge.

Your server also needs the exact Java version required by your Minecraft release:

If you are unsure which runtime to select in your control panel, use our Java version lookup tool. Additionally, mods and loaded chunks increase memory usage alongside single-thread CPU demand. You can estimate your memory needs with our RAM calculator (/tools/ram-calculator/). Across the 57 hosts and 331 plans tracked on hosting.9minecraft.net, 4 GB plans cost from $3.60 to $30.00 per month (median $9.89), while 8 GB plans for larger modpacks range from $5.28 to $60.00 per month (median $20.47).

How to install individual custom mods

When adding mods to adding new mobs, structures, magic spells, or adventures, both the server and every connecting player must usually have the exact same mod files and loader version installed.

  1. Stop the server: Always shut down the server from your control panel before changing files to prevent corruption.
  2. Verify the mod loader: Ensure Fabric, Quilt, Forge, or NeoForge is installed and has been started at least once (with eula=true set in eula.txt) so that it generates the mods directory.
  3. Filter client-only mods: Remove mods that only change client visuals, HUDs, or shaders. Installing client-only mods on a dedicated server frequently causes startup crashes.
  4. Upload the JAR files: Connect to your server via SFTP (or use the panel file manager) and upload your .jar mod files into the /mods folder. Check that you also uploaded any required library or dependency mods.
  5. Start and check logs: Start the server and watch the console. If a mod is missing a dependency or mismatches the Minecraft version, the log will state which file failed to load.

How to upload a custom modpack to a server

Many shared hosts include a one-click modpack installer, which is the easiest way to start a standard modpack server. However, if you built a custom pack or downloaded one that is not in your host's list, you can upload it manually via SFTP.

  1. Get the server pack: Download the dedicated server files for the modpack if the author provides them. If you only have a client profile from your launcher, copy the mods, config, kubejs, and defaultconfigs folders, and delete any client-only mods from the mods folder.
  2. Prepare the server directory: Stop the server. If you are starting fresh, delete or back up the existing mods, config, and world folders.
  3. Install the exact loader version: Check the modpack manifest to see which loader and build number it uses, then select or upload that exact loader JAR on your host.
  4. Upload via SFTP: Compress your custom modpack folders into a single .zip archive, upload it to the server root directory using an SFTP client, and unarchive it using your host's web file manager.
  5. Configure startup and properties: Ensure the correct Java version is selected and review server.properties (for example, in 26.3 defaults include view-distance=10, simulation-distance=10, and white-list=true). If you manage a VPS or dedicated server with root access, you can use our start script generator or Docker compose generator to set up the launch command.

How to upload a custom map or world

Uploading a custom survival spawn, adventure map, or pre-generated world works the same way on both vanilla and modded servers.

  1. Stop the server: Ensure the server is completely offline so no chunks are being saved.
  2. Prepare the world folder: On your computer, open the custom map folder. A valid Java Edition world folder contains a level.dat file and subfolders such as region and data directly inside it.
  3. Zip and upload: Compress the world folder into a .zip file, upload it to the main server directory via SFTP, and extract it so the folder sits in the root directory (for example, /my_custom_map).
  4. Update server.properties: Open server.properties and find the level-name= line. Change the value from world to the exact name of your uploaded folder (level-name=my_custom_map). You can also build a clean configuration file with our server.properties generator.
  5. Start the server: Boot the server. It will load the new directory instead of generating a new default world.

Switching modpacks and maps without losing data

You cannot safely load an existing world into a completely different modpack. When you remove mods that added custom blocks, biomes, structures, or entities, the game either deletes those missing registry entries from the world or refuses to start. Updating a single modpack to a newer version is usually fine, but switching between different modpacks requires a fresh world.

To switch modpacks without wiping your old progress permanently:

Tools for this

Questions

Can I install mods and modpacks on any hosting plan?

You can install mods and modpacks on any plan that provides full file access (such as SFTP) and lets you run custom JAR files or select mod loaders like Fabric, Quilt, Forge, or NeoForge. You also need enough RAM for the pack you choose; you can filter hosts by memory and features using our plan finder.

Can I switch Minecraft modpacks later without wiping my world?

Switching to a completely different modpack while keeping the same world is not recommended because missing modded blocks, items, and biomes will corrupt or strip the map. Instead, back up and download your current world folder first so you can restore it later, then generate a fresh world for the new modpack.

Can I use mods, modpacks, or custom maps on free server hosts?

Many free hosts allow mods, plugins, and custom maps, though they often restrict you to downloading mods from a built-in list rather than uploading custom JAR files via SFTP. Keep in mind that free hosts usually stop the server when nobody is online, place starts in a queue, or show ads. Alternatively, you can self-host a custom modpack on your own PC and use a tunnel like playit.gg if you cannot port forward TCP port 25565.

What is the easiest way to start a Minecraft modpack server?

The easiest method is choosing a shared host that includes a one-click modpack installer in its control panel. It automatically downloads the server files, installs the matching mod loader, and sets the required Java version.

Related guides

See all →