This guide covers how to set up your Craftopia dedicated server on Legion Hosting, configure startup variables, edit the server configuration, set world generation options, connect to your server, and manage saves. Craftopia is an open-world survival crafting game that blends farming, dungeon exploration, hunting, and automation. For admin commands, player management, and troubleshooting, see Craftopia Admin Commands.
1. First Start
- Log in to GPanel and select your Craftopia server.
- Go to the Startup tab and review the configurable variables (see the table in Section 2).
- Set SERVER_NAME to a name for your server.
- Set SERVER_PASSWORD if you want to restrict access. Leave it blank for a public server.
- Set MAX_PLAYERS to the desired player limit.
- Return to the Console tab and click Start.
- Wait for the console to confirm the server has started. The first launch may take a few minutes as the server generates default configuration files and world data.
2. GPanel Startup Variables
The following variables are available in the GPanel Startup tab. These are passed to the server on each start.
| Variable | Required | Description |
|---|---|---|
SERVER_NAME |
Yes | The name displayed in the server browser when players search for servers. |
SERVER_PASSWORD |
No | Optional password players must enter to join. Leave blank for a public server. |
MAX_PLAYERS |
No | Maximum number of concurrent players. Default varies by server plan. |
WORLD_SEED |
No | Seed for world generation. Use the same seed to recreate identical terrain. Leave blank for random. |
DIFFICULTY |
No | Game difficulty setting. Affects enemy strength, resource availability, and survival challenge. |
3. Server Configuration
For advanced settings beyond what the startup variables offer, you can edit the server configuration file directly. Stop your server before making changes.
File Location
ServerSetting.iniOpen this file using the Files tab in GPanel or connect via SFTP. The file uses an INI format with sections and key-value pairs. If the file does not exist, start and stop the server once to generate it.
Key Settings
| Setting | Default | Description |
|---|---|---|
ServerName |
Craftopia Server |
The server name displayed to players in the server browser. |
ServerPassword |
(empty) | Password required to join. Empty means public access. |
MaxPlayers |
16 |
Maximum concurrent players allowed on the server. |
WorldSeed |
(random) | Seed for procedural world generation. Same seed produces the same island layouts. |
Difficulty |
Normal |
Game difficulty. Options include Easy, Normal, Hard, and Very Hard. |
AutoSaveInterval |
300 |
Auto-save interval in seconds. Default is every 5 minutes. |
Example Configuration
[Server]
ServerName=My Legion Craftopia
ServerPassword=
MaxPlayers=16
WorldSeed=82451937
Difficulty=Normal
AutoSaveInterval=3004. World Generation and Difficulty
Craftopia generates a world of islands with different biomes, dungeons, and resources. The world seed determines the layout of these islands.
World Seed
- Set the
WorldSeedvalue in the config or theWORLD_SEEDstartup variable to any integer. - The same seed always produces the same island arrangement, which is useful for sharing a specific world layout.
- Leave blank for a random world. The seed only affects initial generation -- changing it on an existing world requires creating a new save.
Difficulty Settings
The difficulty level affects enemy health, damage output, and overall survival challenge:
- Easy -- Reduced enemy difficulty, more forgiving resource costs. Good for casual play and building.
- Normal -- Standard balanced gameplay experience.
- Hard -- Tougher enemies with more health and damage. Resources may be scarcer.
- Very Hard -- Maximum challenge. Enemies are highly dangerous and survival requires careful preparation.
5. How to Connect
Option A -- Steam Server Browser
- Launch Craftopia via Steam.
- From the main menu, select Multiplayer.
- Open the Server Browser and search for your server by name.
- Select your server and click Join. Enter the password if one is set.
Option B -- Direct Connect
- Launch Craftopia via Steam.
- From the main menu, select Multiplayer.
- Choose the Direct Connect option.
- Enter your server's IP address and port from GPanel's Network tab:
<your-server-ip>:<port> - Enter the server password if prompted and click Connect.
6. Save Management
Auto-Save
The server auto-saves at the interval specified in the configuration (default: every 300 seconds / 5 minutes). Auto-saves happen in the background without interrupting gameplay.
Save File Location
Save files are stored on the server in the world save directory:
Saves/This directory contains the full world state including island data, player inventories, built structures, farms, and automation setups.
Manual Backups via SFTP
- Stop the server from GPanel to ensure all data is written to disk.
- Connect to your server via SFTP. See How to Upload Files via SFTP for instructions.
- Download the entire
Saves/directory. - Store the backup in a safe location on your computer.
Restoring a Save
- Stop the server from GPanel.
- Connect via SFTP and navigate to the save directory.
- Upload your backed-up save files, replacing the existing ones.
- Start the server from GPanel. The server will load the restored save.
Related Articles
- Craftopia Admin Commands
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Server Startup Guide
Need Help?
If you run into issues with your Craftopia server that are not covered here, open a support ticket and include your server IP, a description of the problem, and any relevant error messages from the GPanel console.
