How to Upload a Custom Map to Your Minecraft Server
Learn how to upload adventure maps, parkour maps, and downloaded worlds to your server.
You can upload custom maps like adventure maps, parkour courses, or downloaded worlds from sites like Planet Minecraft and CurseForge.
Uploading a Custom Map
Download the map
Download the custom map file from a trusted source. It will typically be a .zip file containing a world folder.
Extract the map
Extract the .zip on your computer. You should have a folder containing region/, level.dat, and other world files.
Stop your server
Access the XGamingServer panel and stop your server.
Remove or rename the existing world
Go to Files. Either delete the world folder or rename it (e.g., world_backup) to keep it.
⚠️ Warning: Deleting the world folder permanently removes your current world. Create a backup via
Backupsfirst.
Upload the custom map
Upload the extracted world folder to Files. Make sure the folder name matches the level-name in your server.properties:
level-name=worldIf your map folder is named something like MyAdventureMap, either rename it to world or change level-name to match.
Start your server
Start the server. It will load the custom map.
Troubleshooting
- Wrong spawn point: Use
/setworldspawn [x] [y] [z]inConsoleto set the correct spawn - Missing Nether/End: Some custom maps don't include these dimensions — they'll generate fresh
- Version mismatch: Ensure the map was made for your Minecraft version or older. Newer maps won't work on older server versions
💡 Tip: For large map files, use SFTP instead of the web uploader for faster transfers. See Configure SFTP.
📝 Note: The world folder must contain
level.datat its root. If the folder structure isMapName/world/level.dat, move the innerworldfolder contents up one level.
See also: Upload Existing Save | Configure SFTP
If you need help, join our Discord.
How is this guide?
