Switching your Minecraft server to a new hosting provider can feel scary. You've spent months building worlds, configuring plugins, and growing your community. The good news? Transferring a Minecraft server is straightforward if you follow the right steps, and you won't lose any data.
This guide walks you through the entire migration process, whether you're moving from shared hosting to Azion Cloud, from a VPS to managed hosting, or between any two providers.
What You'll Transfer
A complete Minecraft server consists of these components:
- World files — your builds, terrain, structures (the
world/folder) - Plugin/mod files — installed plugins and their configs (
plugins/ormods/) - Server configuration — server.properties, spigot.yml, paper.yml, etc.
- Player data — inventories, achievements, locations (
world/playerdata/) - Server JAR — Paper, Purpur, Forge, or Fabric server file
Step 1: Back Up Everything
Before touching anything, create a complete backup. On your current server:
- Stop the server — never copy files while the server is running
- Download the entire server directory using your panel's file manager or SFTP
- Save the backup to your local computer
If you're using Pterodactyl, go to File Manager → select all files → Archive → download the ZIP.
Keep this backup even after migration is complete. It's your safety net if anything goes wrong.
Step 2: Note Your Current Setup
Before migrating, document your current server setup:
- Minecraft version (e.g., 1.21.1)
- Server software (Paper, Spigot, Purpur, Forge, Fabric)
- Java version (Java 17 or 21)
- RAM allocation (how much RAM your server uses)
- Startup flags (JVM arguments like Aikar's flags)
- Port (default 25565 or custom)
You'll need to match these on the new server to ensure compatibility.
Step 3: Set Up the New Server
On your new hosting provider:
- Create a new server with the same Minecraft version and same server software
- Start it once to generate default files, then stop it
- Delete the default world folder and config files — you'll replace them with yours
Step 4: Upload Your Files
Upload your backed-up files to the new server. The most important files to transfer:
Essential Files
world/ # Your main world (overworld)
world_nether/ # Nether dimension
world_the_end/ # End dimension
plugins/ # All plugins and their configs
server.properties # Server settings
spigot.yml # Spigot configuration
paper.yml or paper-global.yml # Paper configuration
bukkit.yml # Bukkit configuration
For Modded Servers (Forge/Fabric)
mods/ # All mod JAR files
config/ # Mod configurations
world/ # World with mod data
Upload Methods
- Pterodactyl File Manager: Upload a ZIP file and extract it on the server (fastest method)
- SFTP: Connect with FileZilla or WinSCP and upload files directly
Step 5: Verify Configuration
Before starting, check these settings in server.properties:
# Update the server port if needed
server-port=25565
# Update the server IP (usually leave blank for hosted)
server-ip=
# Make sure online-mode matches your old server
online-mode=true
Step 6: Start and Test
- Start the new server
- Check the console for errors — fix any plugin issues
- Join the server and verify:
- Your world loaded correctly
- Plugins are working
- Player data is intact (check /home, /balance, etc.)
Step 7: Update Your DNS/IP
If you use a custom domain (like play.yourserver.com), update the SRV record to point to your new server's IP. DNS changes can take up to 48 hours to propagate globally, though most update within 1-4 hours.
If players connect via IP directly, announce the new IP in your Discord and on your website.
Common Migration Issues
"World not loading" or blank chunks
This usually means the world folder wasn't uploaded to the correct location. Make sure the world/ folder is in the server root, not inside another folder (like backup/world/).
Plugin errors on startup
Some plugins store data using absolute file paths. If these paths changed during migration, the plugin may fail. Check plugin configs for hardcoded paths and update them.
Player data lost
Player data is stored in world/playerdata/ using player UUIDs. If you switched between online-mode and offline-mode, UUIDs change and players lose their data. Always keep online-mode the same on both servers.
Ready to Migrate?
Azion Cloud's Minecraft hosting makes migration easy with Pterodactyl's file manager, SFTP access, and 24/7 support. Our team can even help you transfer your server — just open a ticket on Discord and we'll guide you through the process.