From Terraria Wiki
Jump to: navigation, search
For server set-up tips, see Guide:Setting up a Terraria server. For lists of existing multiplayer servers, see Multiplayer.

A Terraria server provides a platform for players to connect over the internet or other network for multiplayer games. Windows installations of Terraria include its server software.

A server can also be used for standalone single-player gameplay. This offers the ability to adjust the in-game time at will.

The downside to using a server (instead of playing in singleplayer or "Host-and-Play" modes) is that although the hosting computer can be a server and play at the same time, there will be a small amount of lag for the hosting computer's gameplay.

Before You Host[edit | edit source]

The server runs on port 7777 by default, and it must be port-forwarded in order for other players be able to join. If one can't portforward, one may choose to use a VPN service like Hamachi or Tunngle instead (although in those cases, every player needs to install the VPN software). The default max players is 8, but this can be changed during server start-up, as well as within the server configuration file (serverconfig.txt).

How to (Windows)[edit | edit source]

By default, on a 32-bit Windows installation of Terraria, TerrariaServer.exe can be found at:


On a 64-bit Windows installation, it can be found at:


A player then may join the server from the game menu by choosing the Multiplayer option.

How to (Linux)[edit | edit source]

You can use a program as screen to launch the server, so you can put the server into the background without pausing it. It is not necessary, if you keep the terminal where you started the server open.

By default TerrariaServer.exe can be found at: ~/GOG Games/Terraria/game/

or if using Steam: ~/Steam/steamapps/common/terraria/Verify

The binaries for Linux are called TerrariaServer.bin.x86_64 for 64bit or TerrariaServer.bin.x86 for 32bit machines.

A player then may join the server from the game menu by choosing the Multiplayer option.

If you want to use screen, just start screen with:


and now start the sever. To exit screen while leaving the server up push Ctrl + a + d. To resume the session just type:

screen -r

Downloads[edit | edit source]

The vanilla Terraria server software is included with the regular Terraria package (see above), but can also be downloaded:

Dedicated Server GUI is a third-party add-on for the vanilla server that offers graphical controls (the server is normally a command-line program):

Tshock and TDSM are third-party server packages that offer additional functionality, such as in-game commands, whitelists, player passwords, and a plugin interface for added features (such as factions):

Server files[edit | edit source]

The server consists of three files:

  • TerrariaServer.exe - The main server file. Can be run stand-alone.
  • serverconfig.txt - The server config files. Defines all parameters for the server (see below).
  • start-server.bat - A Windows Batch file which starts the server using the serverconfig.txt file. Also contains a loopback to restart the server if it should crash.

List of console commands[edit | edit source]

Once a dedicated server is running, the following commands can be run:

  • help - Displays a list of commands.
  • playing - Shows the list of players. This can be used in-game by typing /playing into the chat.
  • clear - Clear the console window.
  • exit - Shutdown the server and save.
  • exit-nosave - Shutdown the server without saving.
  • save - Save the game world.
  • kick <player> - Kicks a player from the server.
  • ban <player> - Bans a player from the server.
  • password - Show password.
  • password <pass> - Change password.
  • version - Print version number.
  • time - Display game time.
  • port - Print the listening port.
  • maxplayers - Print the max number of players.
  • say <words> - Send a message to all players. They will see the message in yellow prefixed with <Server> in the chat.
  • motd - Print MOTD.
  • motd <words> - Change MOTD.
  • dawn - Change time to dawn (4:30 AM).
  • noon - Change time to noon (12:00 PM).
  • dusk - Change time to dusk (7:30 PM).
  • midnight - Change time to midnight (12:00 AM).
  • settle - Settle all water.
Note that a forward-slash is not required to precede the command, as some command interfaces require. For a list of Tshock commands, refer to this forum thread.

Command line parameters[edit | edit source]

The following is a list of parameters that can be entered when running TerrariaServer initially:

  • -config <config file> - Specifies a configuration file to use (see Server config file below).
  • -port <port number> - Specifies the port to listen on.
  • -players <number> / -maxplayers <number> - Sets the max number of players.
  • -pass <password> / -password <password> - Sets the server password.
  • -motd <text> - Set the server motto of the day text.
  • -world <world file> - Load a world and automatically start the server.
  • -autocreate <#> - Creates a world if none is found in the path specified by -world. World size is specified by: 1(small), 2(medium), and 3(large).
  • -banlist <path> - Specifies the location of the banlist. Defaults to "banlist.txt" in the working directory.
  • -worldname <world name> - Sets the name of the world when using -autocreate.
  • -secure - Adds additional cheat protection to the server.
  • -noupnp - Disables automatic universal plug and play.
  • -steam - Enables Steam support.
  • -lobby <friends> or <private> - Allows friends to join the server or sets it to private if Steam is enabled.

Server config file[edit | edit source]

It is possible to start the dedicated server using a configuration file that enters the above parameters automatically. The config file must be called using the -config parameter. The file can have any name, but must be in the same folder as TerrariaServer.exe. If a server config file is defined and the file is not located during the server boot, then the server will ask the user to input the parameters as it would if run without a defined config file.

The following is a list of available config commands:

  • maxplayers=8 - Sets the max number of players allowed on a server. Value must be between 1 and 255
  • world=C:\Users\Defaults\My Documents\My Games\Terraria\Worlds\world1.wld - Load a world and automatically start the server.
  • port=7777 - Set the port number
  • [email protected]* - Set the server password
  • motd=Please don’t cut the purple trees! - Set the message of the day
  • worldpath=C:\Users\Defaults\My Documents\My Games\Terraria\Worlds\ - Sets the folder where world files will be stored
  • autocreate=3 - Creates a new world if none is found. World size is specified by: 1(small), 2(medium), and 3(large).
  • difficulty=0 - Sets world difficulty when using -autocreate. Options: 0(normal), 1(expert)
  • worldname=World - Sets the name of the world when using autocreate
  • banlist=banlist.txt - The location of the banlist. Defaults to "banlist.txt" in the working directory.
  • secure=1 - Adds additional cheat protection.
  • Item - you can get any item you want that is not banned in the server

Comment lines can be included using the hash symbol (#). Lines that begin with # will be skipped entirely.

Banning and un-banning[edit | edit source]

The command "ban <player>" will ban the indicated player from the server. A banned player, when he/she tries to login, will be displayed the message:You are banned for [duration]: [reason]- [modname]. A banned player may then be un-banned by editing the file "banlist.txt," which is located in the Terraria folder. This document contains a list of all currently banned players. To un-ban a player, delete the player's name and IP address from the list.

System requirements[edit | edit source]

  • Windows Operating System
  • 500 MB free RAM for a small world (RAM depends on world size and number of players)
  • .NET Framework 4.0
  • XNA Framework

An easy method of installing .NET and XNA is to simply install the Terraria client, which should install both as part of its regular installation.

Notes[edit | edit source]

  • The server will auto-save the world now and then, but will only save on shutdown when using the exit command. That said, consider saving manually prior to shutdown.
  • When you launch a server, it will ask if you want to auto port forward, however this doesn't always work.
  • Servers are often set up using Hamachi. This removes the need of having to port-forward, but relies on a third party program.

LAN[edit | edit source]

  1. Connect using a network cable (a switch, or router can be used to increase the amount of players/computers connected to the server).
  2. Right click the network icon on your toolbar and open Network and Sharing center.
  3. Click on the network connection (should say unidentified network).
  4. Open properties and highlight Internet Protocol Version 4 (TCP/IPv4) then click properties again.
  5. Set the IP addresses of all computers like so: IP address; 192.168.1.x (where x is the computer, ex. for computer running server, then and ,etc. for all other computers. None of them can have the same IP address.
  6. The Subnet mask will populate itself
  7. The Default gateway is the first hop the computer looks for to "see" the network. It should be pointing to the IP address of your router. If your (adhoc) LAN doesn't have a router, point it to the computer running the server.
  8. You will then save changes by exiting that window then go to the Status page and click on network properties.
  9. (IN PROGRESS eta 8/16/15)

History[edit | edit source]

    • Dedicated servers can now be launched with -forcepriority to override server settings file's process priority.
    • Dedicated server can now use -ip again to set their local IP address.
  • You should now have an easier time reporting errors if they happen on a server.
    • You will now be able to enter the password every time when entering or creating a server.
    • Many issues with the dedicated server and its configurations have been resolved.
    • Fixed an issue where users would be unable to invite each other when in "Invite Only" mode.
  • Fixed crashes when starting the dedicated server in a language other than English.
  • 1.0.2:
    • Servers now listen to all IP addresses on the hosting PC, regardless of how many network connections are active.
    • Typing "localhost" instead of your own local IP address will connect to your own same-PC server.
    • The games default port is no longer 31337; it is now 7777.
    • Client will now resolve a hostname into its IP address, for example, if ran a server, you could type as the IP address and be able to connect.
  • Pre-Release: Introduced.
Terraria-related software
Servers  •   Map viewers  •   Inventory editors  •   Mods