This guide will walk you through uploading your existing Minecraft world to your Minecraft server so you can continue your single-player adventures with friends or preserve your builds on a dedicated server.
Locating Your Local Minecraft World
Find your world save folder on your local PC:
- Windows:
%appdata%\.minecraft\saves\ - macOS:
~/Library/Application Support/minecraft/saves/ - Linux:
~/.minecraft/saves/
The folder named after your world contains all the world data. Make a backup copy before uploading.
Uploading Your World To Your Server
- Log in to the GhostCap Panel and
Stopyour Minecraft server. - Go to
File Manager. For larger worlds, use SFTP for faster transfers. - Locate the existing
worldfolder and delete it (back it up first if you want to save it). - Upload your local world folder to the server's root directory.
- Rename the uploaded folder to
world(or whatever valuelevel-nameis set to inserver.properties). Startyour server.
Updating server.properties
If your uploaded folder isn't named world, you'll need to update your config:
- Open
server.propertiesinFile Manager. - Change
level-name=to match your folder name. - Save the file and restart your server.
Note
Some Minecraft editions store world data across multiple directories — world, world_nether, and world_the_end. If you see these folders, upload all three to keep your Nether and End progress.
Troubleshooting
- World not loading: Check that the folder name matches
level-nameinserver.propertiesand that all files uploaded successfully. - Version mismatch: Make sure your server version matches the version your world was created in.
- Performance issues: Large worlds need more RAM — consider pre-generating chunks and reviewing our Performance Guide.