Snitch



Snitches are blocks which record the actions of other players in a radius around them. They come in two varieties: noteblocks and jukeboxes. Noteblocks only record player movement, while jukeboxes record all player actions, including breaking blocks and opening chests. Noteblocks and jukeboxes must be reinforced to turn into snitches. Snitches are managed by the JukeAlert plugin (source).

Creation
To create a snitch, place down a noteblock or jukebox and reinforce it. Snitches have a cube area with an 11 block radius, so a total of a 23x23x23 block area centered on the snitch.

Snitches can be given names with the  command.

Breaking Snitches
Snitches have a unique interaction with NameLayer - once broken, they will print the name of the group they are reinforced to, along with the primary owner of the group. This is to allow players to determine who (perhaps with malintent) placed snitches on their land. This does not occur when culled snitches are broken.

Recording Movement
Whenever a player not on a snitch's namelayer group (or a player who is on the snitch's namelayer group, but does not have the SNITCH_IMMUNE permission) enters the snitch's area, a notification is sent to the snitch's namelayer group. Players on the namelayer group must have the SNITCH_NOTIFICATIONS permission to see this notification.

Note that throwing an ender pearl into a snitch field will not trigger the snitch, but moving inside afterwards will.

By default, the notification has the form.

Recording Actions
Both noteblocks and jukeboxes record movement, but only jukeboxes record other player actions. Whenever a player performs an action - such as breaking a block, opening a chest, killing a mob, mounting a horse, etc - in the radius of a jukebox, a log entry is added to the jukebox.

Checking Logs
To read the logs of a jukebox, stand in the radius of the jukebox and use the  command, which will output the logs to chat. You can also use the  command to open a GUI containing the logs. To perform either of these commands, the jukebox must be reinforced to a group you have the  permission on.

can take additional parameters in the syntax. These parameters can be combined in any order.

Dormancy and Culling
Snitches need to be periodically refreshed by a player entering the snitch field who is on the snitch group with the namelayer  permission. Snitches that are not refreshed will first become dormant and lose all functionality but once refreshed will become functional again, if a dormant snitch isn't refreshed however after more time it will become culled. A culled snitch has no functionality but also can't be refreshed, functionality can only be regained by breaking and replacing the snitch block. You can use /jalist to see if your snitches have become dormant or how long is left until a snitch becomes dormant or culled. When you refresh a snitch, the timer on /jalist won't be updated until the daily server restart.

Redstone Interactions
Jukebox snitches can be configured to cause levers on the blocks on or adjacent to the jukebox sides to output a redstone pulse. This behavior which is disabled by default can be enabled with  and disabled by   in radius of snitch.

The direction the lever is placed on changes the action type that causes it to trigger.

Nearby levers will be turned on for a duration of approximately 750ms. This duration can vary due to server lag. Levers that have already been enabled by players will also be turned off after 750ms.

Kira
Kira relays can be set up to automatically send snitch notifications for a discord channel.

Mods
The SnitchMod mod can be useful for managing snitches (1.18+).