Back to Guides
Server ManagementIntermediate

How to Upload a Custom World to Your Server

Complete guide to transferring single-player worlds, downloaded maps, or custom worlds to your Minecraft server.

Blockhead Support Team
14 minutes
Uploading a custom world allows you to use your single-player creations, downloaded adventure maps, or pre-built worlds on your multiplayer server.
1

Prepare Your World for Upload

Get your world files ready for server use:

Locate Your World Files:

  • Windows: %appdata%\\.minecraft\\saves\\
  • macOS: ~/Library/Application Support/minecraft/saves/
  • Linux: ~/.minecraft/saves/

Essential World Files:

  • level.dat: World settings and player data
  • level.dat_old: Backup of level.dat
  • region/: Overworld chunk data
  • DIM-1/: Nether dimension data
  • DIM1/: End dimension data
  • playerdata/: Individual player inventories
  • data/: Maps, structure data, scoreboard
Make a backup of your world before uploading. Server conversions can sometimes cause data loss.
2

Check World Compatibility

Ensure your world is compatible with the server:

Version Compatibility:

  • World version must match or be older than server version
  • Newer worlds cannot be used on older servers
  • Check version in level.dat using NBT editor
  • Server will attempt to upgrade older worlds automatically

Modded World Considerations:

  • Server must have same mods installed
  • Mod versions should match exactly
  • Missing mods will delete modded blocks/items
  • Consider using same modpack on server
3

Compress World Files

Create an archive for easier upload:

Creating a ZIP Archive:

  1. Select all world files and folders
  2. Right-click and choose "Compress" or "Send to ZIP"
  3. Name the archive (e.g., "myworld.zip")
  4. Verify all files are included in archive

Command Line Compression:

# Windows (PowerShell) Compress-Archive -Path "WorldName\*" -DestinationPath "WorldName.zip" # macOS/Linux zip -r WorldName.zip WorldName/ # or tar -czf WorldName.tar.gz WorldName/
4

Upload Using File Manager

Transfer files through web-based file manager:

  1. Access server panel: Login to your hosting control panel
  2. Stop the server: Ensure server is offline
  3. Navigate to server root: Find main server directory
  4. Delete/rename old world: Backup existing world folder
  5. Upload archive: Use upload button in file manager
  6. Extract files: Unzip archive in server directory
  7. Rename to "world": Ensure folder is named correctly
Most hosting panels have a 100MB upload limit. For larger worlds, use FTP or SFTP instead.
5

Upload Using FTP/SFTP

Transfer large worlds via FTP client:

FTP Client Setup:

  1. Download FTP client (FileZilla, WinSCP, Cyberduck)
  2. Get FTP credentials from hosting panel
  3. Connect using provided host, username, password
  4. Navigate to server root directory

Upload Process:

  1. Delete or rename existing "world" folder
  2. Upload your world folder directly
  3. Ensure folder is named "world"
  4. Verify all files transferred successfully
  5. Check file permissions (755 for folders, 644 for files)

FileZilla connection example:

Host: sftp://server.example.com Username: minecraft Password: ******** Port: 22 (SFTP) or 21 (FTP)
6

Configure Server Properties

Update server settings for your custom world:

Essential server.properties Settings:

# World folder name level-name=world # World seed (leave blank for uploaded worlds) level-seed= # Default gamemode gamemode=survival # Difficulty setting difficulty=normal # Spawn protection radius spawn-protection=16 # Level type (for new chunks) level-type=minecraft\:normal

Dimension Folders:

  • Overworld: Main "world" folder
  • Nether: world/DIM-1/ → world_nether/
  • End: world/DIM1/ → world_the_end/
7

Handle Multiple Dimensions

Properly set up Nether and End dimensions:

Single-Player to Server Structure:

# Single-player structure: WorldName/ ├── region/ ├── DIM-1/ │ └── region/ ├── DIM1/ │ └── region/ └── level.dat # Server structure: world/ ├── region/ └── level.dat world_nether/ └── region/ world_the_end/ └── region/

Conversion Steps:

  1. Rename main world folder to "world"
  2. Move DIM-1 contents to "world_nether"
  3. Move DIM1 contents to "world_the_end"
  4. Delete empty DIM folders
8

Verify and Test World

Ensure your world uploaded correctly:

  1. Start the server: Watch console for errors
  2. Check spawn location: Verify you spawn in correct area
  3. Test all dimensions: Enter Nether and End portals
  4. Verify structures: Check that builds are intact
  5. Test functionality: Redstone, command blocks, etc.
  6. Check player data: Inventories and locations

Common console messages:

[Server thread/INFO]: Preparing level "world" [Server thread/INFO]: Preparing start region for dimension overworld [Server thread/INFO]: Preparing spawn area: 0% [Server thread/INFO]: Done! For help, type "help"
9

Troubleshoot Upload Issues

Fix common problems with world uploads:

Common Issues and Solutions:

  • World not loading: Check folder name is "world"
  • Spawn in wrong location: Delete playerdata folder
  • Missing chunks: Verify all region files uploaded
  • Corrupted world: Re-upload from fresh backup
  • Version mismatch: Update server to match world
  • Permission denied: Fix file/folder permissions

Reset World Settings:

# Reset spawn point /setworldspawn # Set spawn for all players /gamerule spawnRadius 0 # Force chunk reload /forceload add ~ ~
Your custom world is now live on your server! Players can explore your creations and continue building in multiplayer.

Need More Help?

Our support team is available 24/7 to help with any Minecraft server issues.