moderation
This is an old revision of the document!
Table of Contents
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. |
Founder is derived from the current host/session and is not written to roles.json.
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. |
Common Confusion
ttt_clearroleremoves assignable roles, but not the session Founder (Host) role.
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.
moderation.1778814282.txt.gz · Last modified: 2026/05/15 03:04 by frank_lee_smith