====== 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:

<file json roles.json>
[
  {
    "steamId": 76561190000000000,
    "role": "admin"
  },
  {
    "steamId": 76561190000000001,
    "role": "moderator"
  },
  {
    "steamId": 76561190000000002,
    "role": "owner"
  }
]
</file>

===== 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.