About Watchlist
Watchlist is a lightweight but powerful tool that alerts admins when specific players connect to the server. Whether you're online or offline, you'll get real-time in-game notifications and Discord alerts with fully configurable message templates and role pings. The built-in UI makes managing the watchlist easy, with support for sorting, filtering, teleporting, and note-taking. Players can be added or removed manually or straight from RustAdmin with custom commands. Very useful tool to keep you and your staff one step ahead.
Configuration
{
"Discord Webhook URL": "https://discord.com/api/webhooks/your/webhook/url", (Your Webhook URL)
"Ping Role": false, (Whether to ping a role when player comes online on discord, e.g: @Admin)
"Role ID": 0, (Discord Roll Id to ping)
"Purge Watchlist on Wipe": false,
"Purge Players List on Wipe": false,
"Enable UI": true,
"UI Color Scheme (Options: dark, light, rust)": "dark",
"Custom Colors": {
"PrimaryBackground": "0 0 0 0.95",
"SecondaryBackground": "0.15 0.15 0.15 1",
"HeaderBackground": "0.1 0.1 0.1 1",
"ButtonPrimary": "0.2 0.7 0.2 0.9",
"ButtonSecondary": "0.3 0.3 0.3 1",
"ButtonDanger": "0.7 0.2 0.2 0.9",
"TextPrimary": "1 1 1 1",
"TextSecondary": "0.7 0.7 0.7 1",
"OnlineIndicator": "0.2 0.8 0.2 1",
"OfflineIndicator": "0.8 0.2 0.2 1",
"RowEven": "0.12 0.12 0.12 0.95",
"RowOdd": "0.15 0.15 0.15 0.95",
"ActiveItem": "0.4 0.4 0.4 1",
"AlertBackground": "0.8 0.2 0.2 0.95",
"AlertText": "1 1 1 1"
},
"UI Scale": 1.0,
"Main UI Position": {
"AnchorMin": "0.2 0.1",
"AnchorMax": "0.8 0.9"
},
"Font Size": {
"Title": 20,
"Header": 14,
"Normal": 12,
"Small": 10
},
"UI Animation": true,
"Enable Sound Alert": true,
"Alert Sound": "assets/bundled/prefabs/fx/notice/item.select.fx.prefab",
"Alert Duration (seconds)": 10.0,
"Show Visual Alert": true,
"Send Discord Add/Remove Notifications": true,
"Max Cached Players": 3000,
"Player Cache Retention Days (0 = disabled)": 30,
"Player Cache Save Delay Seconds": 60,
"Alert Cooldown Seconds": 120,
"Startup Alert Grace Seconds": 60,
"Auto Expire Days (0 = disabled)": 0,
"Send Prune Discord Notifications": true,
"Prune Report Max Per Embed": 10,
"Prune Report Include Notes": false,
"Enable Diagnostics": false,
"Max Audit Log Entries": 500
}
COMMANDS
Chat:
/watchlist
Opens the Watchlist UI (requires permission)
/wl <steamid> "<note>"
Adds a player to the watchlist with a note (requires watchlist.admin permission)
/wlr <steamid>
Removes a player from the watchlist (requires watchlist.admin permission)
/wlist
Lists all watched players in chat (requires watchlist.admin permission)
Console:
watchlist.add <steamid> "<note>"
Adds a player to the watchlist Example: watchlist.add 76561198000000000 "Suspected Cheater"
watchlist.remove <steamid>
Removes a player from the watchlist watchlist.list Lists all watched players in the server console
wl <steamid> "<note>"
Adds a player to the watchlist with a note (can be used via rcon)
wlr <steamid>
Removes a player from the watchlist (can be used via rcon)
wlist
Lists all watched players in the server console (can be used via rcon)
purgewl
Clears the entire watchlist (requires watchlist.admin permission)
PERMISSIONS
watchlist.admin
Full access to all commands and features
watchlistui.toggle
Allows UI toggle via `/watchlist` command
RUSTADMIN INTEGRATION
You can integrate Watchlist directly with **RustAdmin** to add or remove players with a single click.
Add to Watchlist
Command to Execute: wl ${playerSteamid} "From RustAdmin"
Tick "Show Command Output in a Dialog" (optional)
Remove from Watchlist
Command to Execute: wlr ${playerSteamid}
Tick "Show Command Output in a Dialog" (optional)
