Staff log

Every stretch of staff mode is a session: when it started, when it ended, on which server, how much of it was AFK, and how many of each action happened in it. /stafflog shows them; the admin panel builds its team board from them.

Module id stafflog, switch modules.staff-log, files under modules/stafflog/.

Sessions

A session opens when a player enters staff mode, or when the module enables while somebody already is, and closes when they leave it, quit, or the module disables. A quit closes the row and the next join opens a new one, so rows are per connection and the summaries add them up.

AFK

Time counts as AFK once the player has been idle for afk-after-seconds: that first stretch of an idle spell is free, everything after it is AFK. Moving to another block, clicking, chatting, running a command and every counted action reset the idle clock. The clock ticks every thirty seconds.

Actions

Modules announce what a staff member did and the log counts it while their session is open on this server: freeze, unfreeze, inspect, enderchest, container, teleport, report_resolve, report_dismiss, helpop_reply, helpop_close, punish, mining_reset and xray_toggle.

Commands

Naming somebody else needs exyliastaff.stafflog.others. /stafflog 30 reads the number as days for your own log. The written book in the hotbar opens yours.

The ranking shows, per member, active time, total time, AFK time and its percentage, sessions, and actions with an hourly rate. Idle time does not count as working.

Configuration

afk-after-seconds: 300
keep-days: 90

Sessions older than keep-days are deleted once a day; 0 keeps everything.

Messages

modules/stafflog/messages.yml: no-sessions with %target% and %days%, never-played, action-line with %action% and %count%, no-actions, no-staff with %days%.

Placeholders

Storage

staff_log_sessions holds one row per session, staff_log_daily one total per player and day. Both need the staff mode module to have anything to record.