Civcraft2Import:Jukealert

Introduction
JukeAlert provides an easy-to-use means by which one can record player activity within an 11 block radius.

Creating Snitches
To create a snitch reinforce a jukebox or a noteblock. This will create an active snitch block. Jukeboxes snitches will save logs and notify you whenever someone enters the 11 block radius of the snitch, whereas noteblock snitches only notify.

"Recommendation: It is highly recommended to properly name your snitches with /janame to make your own life easier when trying to determine the general location of the snitch." Access to a snitch can be controlled with groups. By reinforcing the snitch to a group with /ctr group-name, any member and above on the group will receive snitch notifications.

"Note: If you are receiving a snitch notification and are unsure what group that snitch is part of then use /jalookup x y z to find out."

Checking Snitches
Walk within the radius of the snitch you are in the group for and type /jainfo. This will load the snitch logs for the first page. You can check other pages by typing `/jainfo page-number`. Only jukebox snitches save logs and as such using /jainfo only loads logs for jukebox snitches.

Type of Snitches
"Note: Both snitch types have the same 11 block cuboid."

Cull Time
Snitches stop being active if a moderator or owner does not walk within the radius of the snitch after enough time has passed. Once a snitch reaches hours before cull, then it will stop being active on the next server restart if it isn't updated. To prevent a snitch being culled, a moderator or owner in the same group as the snitch must walk within the radius of the snitch. This resets the time before that snitch will be culled. This is also called refreshing or updating a snitch. Members cannot refresh or update a snitch.

Type /jalist [page-number] to see which snitches are close to being culled. This command requires moderator or owner rank in the citadel group. The list is sorted by lowest to highest cull time. This allows you to easily check which snitches need to be updated.

Lever Triggering
Jukebox Snitches can have additional functionality added to them such that they can cause nearby levers to trigger. This is not default snitch behavior and the owner or moderator of a snitch can opt-in a snitch by using the command /jaToggleLevers 1 and can opt it out (later) by using the command /jaToggleLevers 0 when in nearby proximity to their snitch. Once a snitch has been opted into lever triggering, levers that are on the blocks adjacent to the jukebox sides will be triggered by people not on the snitch group as follows:

When these events trigger, the associated lever will enable briefly and disable shortly thereafter. This is approximately 750ms but will vary directly depending on the amount of server lag. Levers that are already enabled due to user action will not flicker as a result of a juke alert lever toggle event, but said lever will disable in the same approximate 750ms.

NameLayer Ranks and JukeAlert
As mentioned in the NameLayer rank section, different ranks on a group have different powers when it comes to a JukeAlert.

Owners and moderators can create, refresh, change the group the snitch is on, and see the snitches in the group with /jalist.

Members can use /jainfo and /jalookup to check the snitch and see what group it is part of and will receive snitch notifications. However, they can't refresh a snitch to keep it from being culled nor can they see the snitch on /jalist.

Owner can create snitches, add moderators

List of Commands
&lt;&gt; = mandatory [] = optional