DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
FREEDOM251

Freedom251 › Blog › Dedicated Server

Terraria Server Commands for Admins and Hosts

By Freedom251 Team · · 9 min read

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For a vanilla Terraria dedicated server, enter commands directly in the server console without a leading slash. Use save to write the current world to disk and exit to save and shut down normally; use kick for an immediate removal and ban for persistent moderation. The default listening port is 7777, and launch options or a configuration file make the same settings repeatable.

Where Terraria server commands work

This command reference applies to the vanilla PC dedicated server run by TerrariaServer. The console accepts commands as plain text, so type save, not /save. The slash convention belongs to in-game chat: players can type /playing there to see connected players, while an administrator uses playing in the server console. The official command list is maintained in the Terraria dedicated-server reference.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A dedicated server is separate from the normal game client. It can continue running while no administrator is playing, which makes its console the place to perform moderation, maintenance, status checks and shutdowns. Host & Play uses the game’s in-session hosting flow instead; its controls and lifetime are tied to the player who is hosting.

Complete vanilla console command reference

The table shows the documented commands and what each one changes or reports. Commands that accept an argument use the syntax shown; replace the text inside angle brackets with your value.

#1 Best Overall
505 Games Terraria 71501866
  • In Terraria, every world is unique-from the floating islands in the sky to the deepest level of The Underworld. Adventure to the ends of the earth, and defeat villainous bosses along the way. The world is your canvas!
Command What it does Typical use
help Displays the available command list. Check the commands supported by the running server.
playing Lists connected players. Confirm who is currently online before maintenance or moderation.
clear Clears the server console display. Remove old output from view without changing the world.
save Saves the world immediately. Create an explicit save before maintenance or a backup.
exit Saves the world and shuts down the server. Normal, safe server termination.
exit-nosave Shuts down without saving the current session’s changes. Intentionally discard the session, not routine maintenance.
kick <player name> Removes one player from the current session. Stop disruptive behavior while allowing a later reconnect.
ban <player name> Adds a player to the server’s ban list. Prevent that player from reconnecting under the ban-list rules.
password Displays the current server password. Verify the access setting from the console.
password <pass> Changes the password for the running server. Rotate access credentials without restarting.
version Prints the server version. Check the version when diagnosing client or server compatibility.
time Displays the current in-game time. Inspect the world clock before changing it.
port Reports the listening port used by the running server. Verify which port is active after startup.
maxplayers Reports the configured player limit. Confirm capacity without opening the startup configuration.
say <message> Broadcasts a yellow server message to players. Announce restarts, rules or scheduled maintenance.
motd Displays the current message of the day. Review the text players receive as the server message.
motd <message> Changes the message of the day. Set persistent welcome or policy text.
dawn Sets the in-game clock to dawn. Move the world to the start of the daytime cycle.
noon Sets the in-game clock to noon. Set midday immediately.
dusk Sets the in-game clock to dusk. Move the world to the evening transition.
midnight Sets the in-game clock to midnight. Set the world to the middle of the nighttime cycle.
settle Settles all water. Apply the server’s water-settling operation when supported.
death, pvpdeath, alldeath, allpvpdeath Display death statistics where supported. Inspect the corresponding death counters.

Kick versus ban: choosing the right moderation command

Use kick for a temporary removal

kick <player name> ends the player’s current connection. It does not add the name to the ban list, so the player can reconnect if the server password and other access conditions allow it. Use it for a one-off disruption, an accidental connection, or a player who needs to leave immediately.

Use ban for persistent denial of access

ban <player name> adds the player to the server’s ban list. This is the appropriate command when removing the connection is not enough and future connections must be refused. Confirm the spelling of the player name before submitting it; a name error can leave the intended account connected while affecting another entry.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

How to unban someone

The documented unban process is manual. Stop or otherwise safely manage the server before editing its administrative files, make a backup of banlist.txt, then remove the banned player’s name and IP address from that file. Preserve the file’s formatting and restart or reload the server as required by your installation. Keeping the backup gives you a way to restore the previous ban list if the edit is wrong.

Rank #2
Terraria Boss Rush: Hardmode Edition T-Shirt
  • Gaming Boss Battles design. Boss Rush: Hardfashion Edition items are perfect for fans of Terraria or anyone who likes cool video game clothes! These Terraria items feature the hardmode bosses and is a great way to show your enthusiasm for Terraria!
  • Part of the official Terraria merchandise line from Re-Logic, the creators of Terraria! If you are a terraria fan or should know one, get this design to give yourself or others who play terraria a great gift.
  • Lightweight, Classic fit, Double-needle sleeve and bottom hem

Saving a world and shutting down safely

Routine maintenance sequence

  1. Tell players what is happening with say <message>, for example a short maintenance notice.
  2. Run save and wait for the console to finish processing the command.
  3. Perform the maintenance that does not require the process to stop, or continue to the shutdown step.
  4. Run exit when the server should close. This command saves the world as part of the normal shutdown path.

Use exit-nosave only when you deliberately want to discard changes made during the current session. Closing the console window with its window controls is not the recommended shutdown method because it bypasses the explicit save-and-exit path. If you need a backup, run save first and then copy the resulting world data after the server has stopped.

Password, MOTD and announcements

Changing access credentials

password with no argument prints the current password in the console. password <pass> replaces it for the running server. Treat the displayed value as sensitive: anyone who can read the console can see it, so avoid leaving console output exposed when administering a public instance.

Choosing between say and motd

say <message> is an immediate broadcast and appears as a yellow server message. It is suited to a restart warning or a live rule reminder. motd <message> changes the message of the day, while plain motd prints the current text so you can check it before making an edit. Use the MOTD for information that should remain part of the server’s welcome message rather than a one-time alert.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Terraria Bunny Plush
  • Product Type:Toy Figure
  • Item Package Dimension:11.6 cm L X 14.4 cm W X 15.8 cm H
  • Item Package Weight:0.1 kg
  • Country Of Origin: China

Time, status and capacity controls

Run time to inspect the in-game clock, then use dawn, noon, dusk or midnight to set a specific phase. These are live world controls; they are different from launch-time options in a configuration file.

For a quick operational check, run playing, port, maxplayers and version. Together they show who is connected, where the process is listening, the configured player limit and the server version. The death-stat commands are available where that feature is supported; if a particular build does not provide a statistic, do not treat the absence as a server failure.

Launch arguments and repeatable configuration

Commands control a running process. Launch arguments choose how that process starts. TerrariaServer documents these options, among others:

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
Terraria PS Vita Game
  • 14 Different environments (including dungeons, floating islands, jungles) that go to the extremities of the earth, up in the sky and all the way down to the very deepest depths of the world.
  • Hundreds of weapons, armour and other items to craft, with character advancement.
  • Explore to find different materials and make exotic potions, laser guns, magic wands, flamethrower, diving gear, speed boots, grappling hooks, chainsaws, magic mirrors, etc.
  • 29 Different block types to build whatever you imagine!
  • NPCs and a swarm of enemies (over 150 types) including goblins, wyverns, unicorns, and-GASP-clowns!
Option Purpose
-config <file path> Loads settings from a configuration file.
-port <number> Selects the listening port at startup.
-players <number> or -maxplayers <number> Sets the player limit at startup.
-pass <password> or -password <password> Sets the startup password.
-motd <message> Sets the startup message of the day.
-world <world path> Selects the world to load.
-autocreate <size> Requests automatic world creation when applicable.
-banlist <file path> Selects the ban-list file.
-secure Enables the documented secure-server mode.
-noupnp Disables UPnP.
-steam and -lobby Enable the corresponding documented Steam and lobby startup modes.
-ip <address> Chooses the IP address to bind at startup.

A config file is useful when the server must be restarted consistently. A typical file can contain lines such as:

port=7777
password=example-password
motd=Welcome to the server
worldpath=Worlds/example.wld
banlist=banlist.txt
secure=1

Keep the file in a protected location because it can contain the password. The exact world path must match the file location on your machine. Starting with -config <file path> makes the selected settings repeatable instead of requiring manual entry after every restart.

Ports and internet access

The default and the active port

The documented default Terraria server port is 7777. Use port in the running console to see the active listening port. Use -port <number> on the command line, or port=7777 in a config file, to select it at startup.

Best Value
Sale
CyberPowerPC Gamer Xtreme VR Gaming PC, Intel Core i5-13400F 2.5GHz, GeForce RTX 5060 8GB, 16GB DDR5, 1TB PCIe 4.0 SSD, WiFi Ready & Windows 11 Home (GXiVR8060A40)
  • System: Intel Core i5-13400F 2.5GHz 10 Cores | Intel B760 Chipset | 16GB DDR5 | 1TB PCIe 4.0 NVMe SSD | Windows 11 Home
  • Graphics: NVIDIA GeForce RTX 5060 8GB Graphics | 1x HDMI | 2x DisplayPort
  • Connectivity: 1 x USB-C 3.2 | 2 x USB-A 3.2 | 6 x USB-A 2.0 | 1 x LAN | WiFi 6 | Bluetooth 5.3 | 7.1 Channel Audio
  • Tempered Side Case Panel | Custom RGB Lighting | Keyboard and Mouse
  • 1 Year Parts & Labor Warranty, Free Lifetime Tech Support

When port forwarding is involved

An internet-accessible self-hosted server may require port forwarding on the network router. The forwarded external port must match the port selected by the server, and the host machine’s local firewall must allow the server process. If players on the same local network can connect but internet players cannot, check the router rule, the host firewall and the address shared with remote players before changing in-game commands.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If the console reports a different value from 7777, use that reported value for the current session. Changing a router rule alone does not change the port on which TerrariaServer listens; change the startup option or config value and restart the process.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Host & Play or dedicated server?

Decision factor Host & Play Dedicated server
Setup effort Simpler in-game route; start hosting from the game client. Requires launching and managing TerrariaServer separately.
Must the host remain in-game? The hosting player’s game session is the host. No administrator needs to remain in the game client; the server process runs independently.
Persistence when no player is present Tied to the host session. Can remain available while no player is connected, provided the process and machine stay running.
Network configuration Uses the game’s hosting flow, with requirements determined by that setup. An internet-facing installation may require port forwarding and firewall configuration.
Administrative control Convenient for a small session started by one player. Provides a separate console for commands, repeatable startup options, ban-list management and independent administration.

Choose Host & Play when convenience and a short, player-led session matter most. Choose a dedicated server when the world should have an independently managed process, scheduled maintenance, persistent availability or a clearly separated administrator console.

Quick Recap

Bestseller No. 1
Bestseller No. 2
Terraria Boss Rush: Hardmode Edition T-Shirt
Terraria Boss Rush: Hardmode Edition T-Shirt
Lightweight, Classic fit, Double-needle sleeve and bottom hem
$19.99
Bestseller No. 3
Terraria Bunny Plush
Terraria Bunny Plush
Product Type:Toy Figure; Item Package Dimension:11.6 cm L X 14.4 cm W X 15.8 cm H; Item Package Weight:0.1 kg
$17.78
Bestseller No. 4
Terraria PS Vita Game
Terraria PS Vita Game
Hundreds of weapons, armour and other items to craft, with character advancement.; 29 Different block types to build whatever you imagine!
$40.99
SaleBestseller No. 5
CyberPowerPC Gamer Xtreme VR Gaming PC, Intel Core i5-13400F 2.5GHz, GeForce RTX 5060 8GB, 16GB DDR5, 1TB PCIe 4.0 SSD, WiFi Ready & Windows 11 Home (GXiVR8060A40)
CyberPowerPC Gamer Xtreme VR Gaming PC, Intel Core i5-13400F 2.5GHz, GeForce RTX 5060 8GB, 16GB DDR5, 1TB PCIe 4.0 SSD, WiFi Ready & Windows 11 Home (GXiVR8060A40)
Graphics: NVIDIA GeForce RTX 5060 8GB Graphics | 1x HDMI | 2x DisplayPort; Tempered Side Case Panel | Custom RGB Lighting | Keyboard and Mouse
$1,285.00

Practical administrator workflows

Starting a planned maintenance window

  1. Check the current audience with playing.
  2. Send a warning with say <message>.
  3. Run save before stopping services or copying world data.
  4. Use exit to close the server cleanly.
  5. After restarting, run version, port, maxplayers and playing to verify the expected process is running.

Handling a disruptive player

  1. Use playing to confirm the exact connected name.
  2. Run kick <player name> for a temporary removal.
  3. If the behavior warrants a lasting restriction, use ban <player name> and record the action in your administrative notes.
  4. For a later reversal, back up and edit banlist.txt, removing the player’s name and IP address.

Changing the world’s schedule for an event

  1. Run time if you need to know the current phase.
  2. Choose one of dawn, noon, dusk or midnight.
  3. Use say <message> to tell players why the clock changed.
  4. Run save when the event’s world changes should be retained.

Common mistakes and recovery steps

  • Typing a slash in the console: Dedicated-server commands do not require a leading slash. Use the slash form only for the documented chat command /playing.
  • Closing the window to stop the server: Use exit so the world is saved through the normal shutdown path.
  • Using exit-nosave accidentally: Treat it as a deliberate discard operation, not a faster version of exit.
  • Confusing a kick with a ban: A kick ends the current connection; a ban adds a persistent ban-list entry.
  • Editing the ban list without a backup: Copy banlist.txt first, then remove both the player name and IP address for an unban.
  • Forwarding the wrong port: Compare the router rule with the value printed by port and the startup value supplied by -port or port=.
  • Changing a runtime value when the problem is at startup: Password, MOTD, world, player limit and port can be selected with launch arguments or a config file; restart after changing those startup settings.
  • Assuming every statistic command exists in every build: death, pvpdeath, alldeath and allpvpdeath are documented where supported, so check help on the running server.

Quick command checklist

  • Discover available commands: help
  • See connected players: playing
  • Broadcast an alert: say <message>
  • Save without stopping: save
  • Stop and save: exit
  • Stop and intentionally discard current changes: exit-nosave
  • Remove one player: kick <player name>
  • Ban one player: ban <player name>
  • Inspect network and capacity: port and maxplayers
  • Inspect or set the clock: time, dawn, noon, dusk, midnight

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Dedicated Servergame server administrationhostingPC gamingserver commandsTerraria

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.