Importing a world

From MineOS Wiki
Jump to navigation Jump to search

Importing a world through the web-ui is easy. To import, you must first have a valid archive of your world.

Creating an importable archive

Archives from MineOS

The .tar.gz files created from any variant of MineOS are suitable for easy import. Simply copy the file to your MineOS server in the directory: /var/games/minecraft/import

Create an archive from any Linux system

Create a .tar.gz or .tgz or .zip file from your existing Linux server. To ensure that the file format is acceptable to the importer, you can follow these steps: (in this example 'pvpone' is the directory containing the world files)

Import foreign.png

Create an archive on other OSes

MineOS can import from archives regardless of their origin OS, e.g., Windows and OS/X. Since these OSes are highly graphical in nature and have many different software programs to accomplish the tasks (7zip, Windows (builtin), etc), they cannot be documented here, but they produce the same .zip or .tar.gz that is compatible with Linux's decompression tools.

Creating a Server from an Archive

Importing with the web-ui

The web-ui supports imported servers from any OS (including Windows/OSX) via the 'Create Server from Archive' tab. All .tar.gz, .tgz, and .zip files dropped in the /var/games/minecraft/import directory are listed. Click 'Create Server From' and give the server an new name to extract the files to its new location in /var/games/minecraft/servers/[servername].

If no files appear in the 'archive to import' dropdown, double-check the file is in /var/games/minecraft/import, and has read permissions to all users.

Importing via SFTP

If you have any troubles importing using the archive/import method, another way to accomplish this is via SFTP. This is a common approach for moving servers from non-linux platforms, as Windows machines typically do not create .tar.gz files (or you are otherwise unable to make a fitting .zip). Simply copy your world to /var/games/minecraft/servers/myserver, where myserver is anything you choose. The resulting structure should look like:




The myserver directory must contain the file. Ensure the myserver directory and all contained files within are chowned by mc (or other non-root user) and they will appear automatically in the web-ui.

Confirm your directory structure

A neat trick to check if your server's directories match the expected structure is by viewing a highly-modified tree directory listing like above:

<syntaxhighlight> cd /var/games/minecraft ls -R | grep ":$" | sed -e 's/:$//' -e 's/[^-][^\/]*\//--/g' -e 's/^/ /' -e 's/-/|/' </syntaxhighlight>

After importing

Whenever importing a server, you should check the configuration files in the web-ui to ensure the server runs with the desired amount of memory, particular port, etc. Imported servers from not from MineOS get allocated by default 256MB of memory, using port 25565.