Dedicated Server Settings

Server hosting for TTT is still early and subject to change. This page documents the current dedicated-server setup as of 5/14/26.

This page does not explain how to install or start a baseline s&box dedicated server. For general s&box dedicated server setup, see:

s&box Dedicated Servers

How to make a s&box server

For the easiest server hosting, your best option is using physgun. You can even get 30% off with code “TTT”!

Basics

Live package ident:

thieves.terrortown

Native startup map:

Choose the startup map with the native s&box launch command. The map ident after the game ident is the boot map. TTT also uses that boot map as the empty-server reset map.

Launch Example

Typical dedicated launch shape (replace ports and map with your values):

-headless +game thieves.terrortown thieves.rooftops +hostname "Test" +port 00000 +net_query_port 00000 +net_hide_address 0

Configuration Files

TTT currently uses three operator-facing files:

File	Purpose
`server_settings.json`	Small dedicated-server bootstrap config: lobby max players/privacy and curated map rotation.
`config/convar/game.json`	Native s&box saved ConVars. Most gameplay/rule settings live here now.
`roles.json`	Moderator/Admin/Owner role assignments written by TTT role commands.

server_settings.json

server_settings.json lives under the package's game data folder.

Example:

data/thieves/terrortown/server_settings.json

The game creates this file with active defaults the first time a dedicated server starts without one.

Current editable shape:

server_settings.json

{
  "SchemaVersion": 2,
  "Lobby": {
    "MaxPlayers": 24,
    "Privacy": 0
  },
  "MapVote": {
    "Maps": "thieves.rooftops;thieves.whitehouse;thieves.minecraft_t5"
  }
}

server_settings.json Fields

Field	Default	Description
`SchemaVersion`	2	Generated by the game for future migrations. Leave this alone.
`Lobby.MaxPlayers`	24	Maximum player count for the lobby. Keep this aligned with any external server-manager player limit.
`Lobby.Privacy`	0	Lobby privacy: 0 public, 1 private, 2 friends only. Public dedicated servers should use 0.
`MapVote.Maps`	Curated built-in map list	Dedicated map vote rotation. Separate map idents with semicolons, commas, or newlines.

Map Vote Rotation

Dedicated map vote pool example:

"MapVote": {
  "Maps": "thieves.rooftops;thieves.dolls;throwupproducs.islandtropical"
}

Separate map idents with semicolons, commas, or newlines.

orgident.mapident;orgident.mapident

Duplicate entries are collapsed. Maps outside the built-in curated list are ignored for dedicated map vote rotation. Make sure at least one valid map remains.

You can print the current built-in map whitelist from the server console with:

t.server.maps

Deprecated Or Ignored Settings

Old Setting	Current Status
`Server.StartupMap`	Removed. Use the native `+game org.game org.map` launch argument.
Scalar `Lobby` gameplay fields such as `MaxRounds`, `RoundTimeMinutes`, `KarmaEnabled`, `ProximityVoiceRange`, etc.	Removed from `server_settings.json`. Use the matching saved ConVar instead.
`MapVote.Whitelist`	Migrated to `MapVote.Maps` if `Maps` is missing.
`MapVote.Blacklist`	No longer the dedicated rotation model. If only `Blacklist` is present, defaults are backfilled into `MapVote.Maps`.

Terror Town Wiki

Table of Contents