# How to Upload a Custom Map to Your Minecraft Server (/docs/minecraft/upload-custom-world)



You can upload custom maps like adventure maps, parkour courses, or downloaded worlds from sites like Planet Minecraft and CurseForge.

Uploading a Custom Map [#uploading-a-custom-map]

<div className="fd-steps">
  <div className="fd-step">
    Download the map [#1-download-the-map]

    Download the custom map file from a trusted source. It will typically be a `.zip` file containing a world folder.
  </div>

  <div className="fd-step">
    Extract the map [#2-extract-the-map]

    Extract the `.zip` on your computer. You should have a folder containing `region/`, `level.dat`, and other world files.
  </div>

  <div className="fd-step">
    Stop your server [#3-stop-your-server]

    Access the [XGamingServer panel](https://panel.xgamingserver.com) and stop your server.
  </div>

  <div className="fd-step">
    Remove or rename the existing world [#4-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 `Backups` first.
  </div>

  <div className="fd-step">
    Upload the custom map [#5-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=world
    ```

    If your map folder is named something like `MyAdventureMap`, either rename it to `world` or change `level-name` to match.
  </div>

  <div className="fd-step">
    Start your server [#6-start-your-server]

    Start the server. It will load the custom map.
  </div>
</div>

Troubleshooting [#troubleshooting]

* **Wrong spawn point:** Use `/setworldspawn [x] [y] [z]` in `Console` to 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](/docs/minecraft/configure-sftp).

> 📝 **Note:** The world folder must contain `level.dat` at its root. If the folder structure is `MapName/world/level.dat`, move the inner `world` folder contents up one level.

See also: [Upload Existing Save](/docs/minecraft/upload-custom-world) | [Configure SFTP](/docs/minecraft/configure-sftp)

If you need help, join our [Discord](https://discord.xgamingserver.com/).