Plugins Overview
R3 ships with 30 plugins covering server administration, moderation, statistics, anti-abuse, and more. All plugins are optional and individually configurable.
Enabling Plugins
Add a [[plugins]] entry to your referee.toml for each plugin you want:
toml
[[plugins]]
name = "admin"
enabled = true
[plugins.settings]
max_warnings = 3Set enabled = false to disable a plugin without removing its configuration.
Plugin Categories
Core Administration
| Plugin | Description |
|---|---|
| admin | Core command handler — !kick, !ban, !warn, !tempban, and 50+ commands |
| poweradminurt | Urban Terror specific commands — !slap, !nuke, !gear, team management |
Moderation
| Plugin | Description |
|---|---|
| censor | Filters offensive language from chat with regex patterns |
| censorurt | Urban Terror specific name/clan tag censoring |
| spamcontrol | Prevents chat flooding and message repetition |
| tk | Team kill monitoring and automatic penalties |
| spawnkill | Detects and punishes spawn killing |
Player Management
| Plugin | Description |
|---|---|
| welcome | Greets new and returning players |
| makeroom | Kicks lowest-level player to make room for admins |
| nickreg | Nickname registration and impostor protection |
| namechecker | Name policy enforcement (duplicates, forbidden names, change limits) |
| specchecker | Kicks idle spectators when the server is busy |
| login | Requires admins to authenticate before using commands |
| follow | Follow a player and get notifications about their activity |
Anti-Abuse
| Plugin | Description |
|---|---|
| afk | Detects and handles AFK players |
| pingwatch | Monitors and kicks high-ping players |
| vpncheck | Blocks VPN/proxy connections |
| countryfilter | GeoIP-based country filtering |
| callvote | Controls and filters in-game callvotes |
Statistics
| Plugin | Description |
|---|---|
| stats | In-memory K/D tracking with !stats and !topstats |
| xlrstats | Extended live rankings with ELO skill tracking |
| headshotcounter | Headshot streak tracking and aimbot detection |
| spree | Killing spree announcements |
| firstkill | First kill of each round announcements |
| flagannounce | Flag event announcements (CTF) |
Chat & Logging
| Plugin | Description |
|---|---|
| chatlogger | Logs all chat to daily rotating files and database |
| customcommands | User-defined text commands (!rules, !discord, etc.) |
Server Management
| Plugin | Description |
|---|---|
| adv | Rotating server advertisement messages |
| scheduler | Runs commands on game events (round start, map change, etc.) |
| mapconfig | Executes map-specific RCON commands on map change |
Plugin Dependencies
Some plugins depend on others:
- censor, spamcontrol, tk, login, follow, makeroom, customcommands require the admin plugin
- callvote, spawnkill, headshotcounter, namechecker, specchecker require the iourt43 parser
The admin plugin should always be loaded first.
Permission Levels
Many plugins reference permission levels. R3 uses this hierarchy:
| Level | Value | Description |
|---|---|---|
| Guest | 0 | Default for new players |
| User | 1 | Registered players |
| Regular | 2 | Trusted regulars |
| Moderator | 20 | Can warn, kick, manage players |
| Admin | 40 | Can tempban, use advanced commands |
| Senior Admin | 60 | Can permanently ban, configure server |
| Super Admin | 80 | Full access to all commands |