BigBrother - Revision history

Aquila at 16:26, 28 July 2026

2026-07-28T16:26:51Z

← Older revision		Revision as of 16:26, 28 July 2026
Line 1:		Line 1:
	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<blockquote>This plugin has no player facing commands. it runs silently in the background and reports to Discord</blockquote>		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 '''~~OP status~~'''		* 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 '''OP''' are watched~~. '''regular players are~~ never logged~~'''~~		* 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 ==

Aquila at 11:15, 28 July 2026

2026-07-28T11:15:03Z

← Older revision		Revision as of 11:15, 28 July 2026
Line 1:		Line 1:
	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<blockquote>This plugin has no player-facing commands. it runs silently in the background and reports to Discord</blockquote>		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<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 ==

Aquila at 21:20, 27 July 2026

2026-07-27T21:20:41Z

← Older revision		Revision as of 21:20, 27 July 2026
Line 50:		Line 50:
	\|-		\|-
	\|webhook-url		\|webhook-url
	\|The Discord webhook URL alerts are sent to — '''required''', or nothing will be posted		\|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]]

Aquila at 21:04, 27 July 2026

2026-07-27T21:04:02Z

← Older revision		Revision as of 21:04, 27 July 2026
Line 55:		Line 55:
	\|A label for identifying which server an alert came from		\|A label for identifying which server an alert came from
	\|}		\|}
			[[Category:Plugins]]

Aquila: Created page with "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 ch..."

2026-07-27T21:03:47Z

Created page with "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<blockquote>This plugin has no player-facing commands. it runs silently in the background and reports to Discord</blockquote> == What BigBrother Does == * Watches every command run by a player with '''OP status''' * Also tracks '''gamemode ch..."

New page

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<blockquote>This plugin has no player-facing commands. it runs silently in the background and reports to Discord</blockquote>

== What BigBrother Does ==

* Watches every command run by a player with '''OP status'''
* 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:
** 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'''
* <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

== What Shows Up in Discord ==
Each alert is posted as an embed titled '''"BigBrother Alert"''', showing:
{| class="wikitable"
|+
!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:
{| class="wikitable"
|+
!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
|}