Import World
Transfer your existing Minecraft world (singleplayer or from another server) to your ModReady server.
Make sure your world was created with the same Minecraft version (or older) as your server. You cannot import a world from a newer version to an older one.
If your world is larger than 100MB, the web file manager may time out. Use SFTP with FileZilla instead - it's faster and more reliable for large files!
Step 1: Prepare Your World
From Singleplayer
First, you need to find your Minecraft saves folder on your computer:
- Press Windows + R on your keyboard (opens the Run dialog)
- Type
%appdata%\.minecraft\savesand press Enter - A folder will open with all your worlds listed
- Open Finder
- Click Go in the menu bar at the top
- Hold the Option key - "Library" will appear
- Click Library → Application Support → minecraft → saves
Alternative: Press Cmd + Shift + G in Finder and paste: ~/Library/Application Support/minecraft/saves
- Open your file manager
- Press Ctrl + H to show hidden files
- Navigate to your home folder → .minecraft → saves
Alternative: Open a terminal and run: nautilus ~/.minecraft/saves
Inside the saves folder, you'll see a folder for each world. The folder name matches the world name you chose in-game.
From Another Server
Download the world folder from your old server's file manager. If you have multiple dimensions, also grab:
world_nether(orworld/DIM-1for some servers)world_the_end(orworld/DIM1for some servers)
Zip Your World (Optional but Recommended)
Create a .zip file of your world folder. This makes uploading faster and easier.
- Windows: Right-click the folder → "Send to" → "Compressed (zipped) folder"
- Mac: Right-click the folder → "Compress"
Step 2: Choose Your Upload Method
| World Size | Recommended Method |
|---|---|
| Under 100MB | Web File Manager (easiest) |
| 100MB - 1GB | SFTP with FileZilla (recommended) |
| Over 1GB | SFTP with FileZilla (required) |
Option A: Web File Manager (Small Worlds)
-
Stop Your Server
Go to your server dashboard and click Stop. Never upload files while the server is running.
-
Open File Manager
Click Files in the left sidebar to open the file manager.
-
Delete the Old World (Optional)
If you want to completely replace the existing world, delete the current
worldfolder. Right-click it and select "Delete". -
Upload Your Zip File
Click Upload at the top of the file manager and select your world.zip file. Wait for the upload to complete.
-
Extract the Zip
Right-click your uploaded .zip file and select Unarchive. This will extract the world folder.
-
Rename the Folder
Make sure your world folder is named exactly
world(lowercase). If it has a different name, right-click it and select "Rename".
Option B: SFTP with FileZilla (Large Worlds)
SFTP is the best way to upload large files. It's faster, more reliable, and won't time out like web uploads.
Step 1: Download FileZilla
FileZilla is a free, easy-to-use SFTP client:
- Windows/Mac/Linux: Download FileZilla Client
Install it like any other program. When it asks about additional software, you can skip/decline those offers.
Step 2: Find Your SFTP Details
- Go to panel.modready.gg
- Click on your server
- Click Settings in the left sidebar
- Look for the SFTP Details section
You'll see something like:
Server Address: sftp://node4.modready.gg:2022
Username: your.email@example.com.abc123de
Your SFTP password is the same password you use to log into the panel (panel.modready.gg).
Step 3: Connect with FileZilla
- Open FileZilla
- At the top, you'll see the Quickconnect bar with these fields:
| Field | What to Enter |
|---|---|
| Host | The server address (e.g., sftp://node4.modready.gg) |
| Username | Your SFTP username from the panel |
| Password | Your panel login password |
| Port | 2022 |
- Click Quickconnect
- If asked about an unknown host key, click OK or Always trust this host
Step 4: Upload Your World
Once connected, you'll see two panels:
- Left side: Your computer's files
- Right side: Your server's files
- On the left side, navigate to your world folder (e.g.,
%appdata%\.minecraft\saves\MyWorld) - On the right side, you should see your server files (mods, config, etc.)
- If there's an existing
worldfolder on the right, right-click it and delete it - Drag your world folder from the left to the right side
- Wait for the transfer to complete (you'll see progress at the bottom)
- Rename the uploaded folder to
worldif needed
- Transfer speed: SFTP is typically 5-10x faster than web upload
- Resume failed transfers: If a transfer fails, FileZilla can resume where it left off
- Upload multiple files: You can drag multiple folders/files at once
- Don't zip: With SFTP, you can upload the folder directly - no need to zip!
Step 3: Configure server.properties
Your server needs to know which folder contains your world:
- Open
server.propertiesin the file manager (or via FileZilla) - Find the line
level-name=world - Make sure it matches your world folder name (usually
world) - Save the file
Step 4: Start Your Server
Go back to your dashboard and click Start. Your server will now load your imported world!
The first startup after importing a world may take longer than usual as the server processes the new files. This is normal.
Common Issues
World not loading / Generating new world
- Check that your world folder is named exactly
world - Make sure
level-namein server.properties matches the folder name - Verify the world files are in the root of the
worldfolder, not a subfolder
Missing Nether/End
- For Paper/Spigot servers, dimensions need separate folders:
world_netherandworld_the_end - For Vanilla/Forge/Fabric, dimensions are inside the world folder as
DIM-1andDIM1
Mod errors after import
- Your world might have blocks/items from mods that aren't installed
- Install the same mods that were used in the original world
- Check the console for specific missing mod errors
SFTP Connection Failed
- Double-check the port is
2022(not 22) - Make sure you're using your panel password, not a different password
- Try using
sftp://prefix in the host field - Check that your server address matches what's shown in Settings
Upload keeps failing/timing out
- Use SFTP instead of the web file manager for large files
- Check your internet connection
- Try uploading during off-peak hours
Before importing, consider creating a backup of your current server in case something goes wrong.
Need help? Join our Discord for support!