BigBrother: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 50: | Line 50: | ||
|- | |- | ||
|webhook-url | |webhook-url | ||
|The Discord webhook URL alerts are sent to | |The Discord webhook URL alerts are sent to'''. required''', or nothing will be posted | ||
|- | |- | ||
|server-name | |server-name | ||
|A label for identifying which server an alert came from | |A label for identifying which server an alert came from. '''Currently unused''' | ||
|} | |} | ||
[[Category:Plugins]] | [[Category:Plugins]] | ||
Revision as of 21:20, 27 July 2026
BigBrother is a staff side auditing plugin. It watches for commands run by server operators (OPs) 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 OP status
- 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 OP are watched. regular players are 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
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 |