Import World

Transfer your existing Minecraft world (singleplayer or from another server) to your ModReady server.

Before You Start

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.

Large Worlds (Over 100MB)?

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:

Windows
  1. Press Windows + R on your keyboard (opens the Run dialog)
  2. Type %appdata%\.minecraft\saves and press Enter
  3. A folder will open with all your worlds listed
Mac
  1. Open Finder
  2. Click Go in the menu bar at the top
  3. Hold the Option key - "Library" will appear
  4. Click LibraryApplication Supportminecraftsaves

Alternative: Press Cmd + Shift + G in Finder and paste: ~/Library/Application Support/minecraft/saves

Linux
  1. Open your file manager
  2. Press Ctrl + H to show hidden files
  3. Navigate to your home folder → .minecraftsaves

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:

Zip Your World (Optional but Recommended)

Create a .zip file of your world folder. This makes uploading faster and easier.

Step 2: Choose Your Upload Method

Which method should I use?
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)

  1. Stop Your Server

    Go to your server dashboard and click Stop. Never upload files while the server is running.

  2. Open File Manager

    Click Files in the left sidebar to open the file manager.

  3. Delete the Old World (Optional)

    If you want to completely replace the existing world, delete the current world folder. Right-click it and select "Delete".

  4. 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.

  5. Extract the Zip

    Right-click your uploaded .zip file and select Unarchive. This will extract the world folder.

  6. 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:

Install it like any other program. When it asks about additional software, you can skip/decline those offers.

Step 2: Find Your SFTP Details

  1. Go to panel.modready.gg
  2. Click on your server
  3. Click Settings in the left sidebar
  4. Look for the SFTP Details section

You'll see something like:

Server Address: sftp://node4.modready.gg:2022
Username: your.email@example.com.abc123de
SFTP Password

Your SFTP password is the same password you use to log into the panel (panel.modready.gg).

Step 3: Connect with FileZilla

  1. Open FileZilla
  2. 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
  1. Click Quickconnect
  2. 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:

  1. On the left side, navigate to your world folder (e.g., %appdata%\.minecraft\saves\MyWorld)
  2. On the right side, you should see your server files (mods, config, etc.)
  3. If there's an existing world folder on the right, right-click it and delete it
  4. Drag your world folder from the left to the right side
  5. Wait for the transfer to complete (you'll see progress at the bottom)
  6. Rename the uploaded folder to world if needed
Pro Tips for FileZilla
  • 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:

  1. Open server.properties in the file manager (or via FileZilla)
  2. Find the line level-name=world
  3. Make sure it matches your world folder name (usually world)
  4. Save the file

Step 4: Start Your Server

Go back to your dashboard and click Start. Your server will now load your imported world!

First Start Takes Longer

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

Missing Nether/End

Mod errors after import

SFTP Connection Failed

Upload keeps failing/timing out

Backup First!

Before importing, consider creating a backup of your current server in case something goes wrong.

Need help? Join our Discord for support!