BigBrother: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
BigBrother is a staff side auditing plugin. It watches for commands run | BigBrother is a staff side auditing plugin. It watches specific players (staff and trusted roles) for the commands they run and posts a log of each one to a Discord channel, so server owners have a record of what admin actions were taken, by whom, and where.<blockquote>This plugin has no player facing commands. it runs silently in the background and reports to Discord</blockquote> | ||
== What BigBrother Does == | == What BigBrother Does == | ||
* Watches every command run by a player with ''' | * Watches every command run by a player with the '''<code>bigbrother.watched</code>''' permission | ||
* Also tracks '''gamemode changes''' specifically (even ones not typed as a <code>/gamemode</code> command, e.g. from a menu or another plugin) | * Also tracks '''gamemode changes''' specifically (even ones not typed as a <code>/gamemode</code> command, e.g. from a menu or another plugin) | ||
* Sends a report to a '''Discord webhook''' for each one, including: | * Sends a report to a '''Discord webhook''' for each one, including: | ||
| Line 14: | Line 14: | ||
== How It Decides What to Log == | == How It Decides What to Log == | ||
* Only players with ''' | * Only players with the '''<code>bigbrother.watched</code>''' permission are watched, everyone else is never logged. | ||
* <code>/gamemode</code> commands typed directly are '''skipped''' by the command watcher, because the separate gamemode watcher already reports the resulting change (this avoids duplicate reports and also catches gamemode changes that don't come from a typed command) | * <code>/gamemode</code> commands typed directly are '''skipped''' by the command watcher, because the separate gamemode watcher already reports the resulting change (this avoids duplicate reports and also catches gamemode changes that don't come from a typed command) | ||
* Everything else an OP types as a command gets reported | * Everything else an OP types as a command gets reported | ||
== Who's Currently Watched == | |||
<code>bigbrother.watched</code> is granted through LuckPerms '''groups''', not to individual players. Anyone placed in one of these groups is watched automatically, and taking them out of the group stops the logging: | |||
{| class="wikitable" | |||
|+ | |||
!LuckPerms group | |||
|- | |||
|gamestaff | |||
|- | |||
|serverguide | |||
|- | |||
|staff | |||
|- | |||
|OP | |||
|} | |||
To watch an additional group, grant it the <code>bigbrother.watched</code> permission in LuckPerms. To stop watching a group, remove the permission (or remove the players from it). | |||
== What Shows Up in Discord == | == What Shows Up in Discord == | ||
Latest revision as of 16:26, 28 July 2026
BigBrother is a staff side auditing plugin. It watches specific players (staff and trusted roles) for the commands they run and posts a log of each one to a Discord channel, so server owners have a record of what admin actions were taken, by whom, and where.
This plugin has no player facing commands. it runs silently in the background and reports to Discord
What BigBrother Does
- Watches every command run by a player with the
bigbrother.watchedpermission - Also tracks gamemode changes specifically (even ones not typed as a
/gamemodecommand, e.g. from a menu or another plugin) - Sends a report to a Discord webhook for each one, including:
- The player's name, UUID, and skin thumbnail
- The exact command that was run
- The world and coordinates the player was standing in when they ran it
- A timestamp
- Also logs the same info to the server console (if no webhook is set in the plugin config)
How It Decides What to Log
- Only players with the
bigbrother.watchedpermission are watched, everyone else is never logged. /gamemodecommands typed directly are skipped by the command watcher, because the separate gamemode watcher already reports the resulting change (this avoids duplicate reports and also catches gamemode changes that don't come from a typed command)- Everything else an OP types as a command gets reported
Who's Currently Watched
bigbrother.watched is granted through LuckPerms groups, not to individual players. Anyone placed in one of these groups is watched automatically, and taking them out of the group stops the logging:
| LuckPerms group |
|---|
| gamestaff |
| serverguide |
| staff |
| OP |
To watch an additional group, grant it the bigbrother.watched permission in LuckPerms. To stop watching a group, remove the permission (or remove the players from it).
What Shows Up in Discord
Each alert is posted as an embed titled "BigBrother Alert", showing:
| Field | Contents |
|---|---|
| Player | The op's username |
| UUID | Their unique player ID |
| Command | The exact command text, in a code block |
| World | Which world they were in |
| Location | Their X, Y, Z coordinates |
The embed also shows the player's Minecraft skin as a thumbnail and a timestamp of when the command was run.
Server Configuration
Admins set these values in the plugin's config file:
| Setting | What it controls |
|---|---|
| webhook-url | The Discord webhook URL alerts are sent to. required, or nothing will be posted |
| server-name | A label for identifying which server an alert came from. Currently unused |