Managing worlds on your Terraria Pterodactyl server is straightforward once you understand the panel’s structure. Whether you’re starting fresh or uploading an existing world, this guide walks you through every step — from initial configuration to switching between worlds seamlessly.
Pterodactyl is an open-source game server management panel that runs all game servers inside isolated Docker containers, providing a secure and intuitive interface for both admins and players. It natively supports Terraria, making it one of the most popular choices for hosting dedicated Terraria worlds.
Before your world is created, make sure your server is allocated at least 768 MB of RAM. The world generation process on first startup is resource-intensive, and insufficient memory can cause the server to fail during the initial world build.
To create a new world, navigate to the Startup tab inside your Pterodactyl panel. Set your desired World Name, choose a World Size — 1 for small, 2 for medium, or 3 for large — and select a Difficulty: 0 for Classic, 1 for Expert, 2 for Master, or 3 for Journey Mode. Save your settings and start the server; it will auto-generate the world on first launch.
Your Terraria world files are stored in the path defined by your startup configuration. The recommended directory on a Pterodactyl server is ~/.local/share/Terraria/Worlds/. Make sure your startup command points to this exact location, or the server will not detect your world files.
To upload an existing world from your local PC, go to the File Manager in your Pterodactyl panel and navigate to your configured worlds directory. Click Upload and select your .wld world file. Once uploaded, update the World Name variable in the Startup tab to match the file name exactly, then restart the server.
To switch between worlds, stop your server first, then go to the Startup tab and update the World Name field to the name of the world you want to load. Make sure the corresponding .wld file exists in your worlds directory. Save the changes and restart the server — it will automatically load the new world.
Want to protect your world with a password? In the Startup settings of your Pterodactyl panel, locate the Server Password field and enter your desired password. Players will be prompted to enter it before they can join. You can also set a custom MOTD (Message of the Day) to greet players on connection.
The default Terraria server port is 7777. Pterodactyl assigns this automatically, but if you need to change it, update the port in the panel’s network settings. Always ensure clients connect to the correct port — especially if you’re running multiple Terraria servers, as each one must use a unique port and a different world file.
If your world keeps regenerating every time you restart the server, the most common cause is a mismatch between the World Name in your startup variables and the actual file name of your .wld file. Double-check both values carefully — they must match exactly, including capitalization.
To back up your Terraria world, use the File Manager in Pterodactyl to download your .wld file from the worlds directory. It is strongly recommended to back up your world regularly, especially before installing mods, changing difficulty settings, or updating the server version.
Now that you know how to create, upload, switch, and manage worlds on your Terraria Pterodactyl server, you’re fully equipped to run a smooth multiplayer experience. Keep your worlds backed up, use clearly named files to stay organized, and always stop the server before making world or configuration changes.