Admin Roles, Prints, and Banning

This page covers server role assignment commands and the commands used to print current role state.

Files

File	What it does
`roles.json`	Stores Moderator, Admin, and Owner role assignments. This is the role file server owners can edit or update in-game/via console commands.
`bans.json`	Dedicated-server host/admin bans.

Moderation Roles

Dedicated servers store Moderator, Admin, and Owner assignments in roles.json in the same data area as server_settings.json.

Use SteamID64 values. Invalid or zero IDs are ignored. Founder is derived from the active host/session and is not written to roles.json.

Example:

roles.json

[
  {
    "steamId": 76561190000000000,
    "role": "admin"
  },
  {
    "steamId": 76561190000000001,
    "role": "moderator"
  },
  {
    "steamId": 76561190000000002,
    "role": "owner"
  }
]

Role Hierarchy

Role	Inherits	Main purpose
User	None	Normal player.
Moderator	User	Reports, kick, gimp/mute/gag, skip-rounds, chat moderation, and moderation audit visibility.
Admin	Moderator	Ban, slay, session rule editing, and forced map votes.
Owner	Admin	Permission editing and session recovery.
Founder	Owner	Current host/founder authority. Derived per session.

Assignment Commands

Use SteamID64 values.

Command	What it does	Persists?
`ttt_setrole STEAMID64 ROLE`	Replaces assignable roles with one role. ROLE is `mod`, `admin`, or `owner`.	Yes, to `roles.json`.
`ttt_clearrole STEAMID64`	Removes Moderator, Admin, and Owner from a player.	Yes, to `roles.json`.

Print Commands

ttt_listroles Prints ranked role assignments, including Moderator, Admin, and Owner.

Banning

Bans are persistent host bans on dedicated servers. Dedicated servers write them to bans.json and mirror active bans into the live session so the mod menu can display and revoke them. P2P lobby bans are session-only and do not write bans.json.

Command	What it does	Persists?
`ban PLAYERNAME [HOURS]`	Bans a connected player by partial name. Omit hours for a permanent ban.	Dedicated only, to `bans.json`.
`banid STEAMID64 [HOURS]`	Bans a SteamID64 directly. Omit hours for a permanent ban.	Dedicated only, to `bans.json`.
`unban STEAMID64`	Removes the active ban for that SteamID64.	Dedicated only, removes from `bans.json`.

Admins can also ban, ban by SteamID, and unban from the mod menu.

Terror Town Wiki

Table of Contents