Track staff activity
See how long each staff member was on duty, how much of it was idle and what they did, with a ranking for the whole team.
Every stretch in staff mode is recorded as a session: when it started, how long it lasted, how much of it was idle, which server it was on and how many freezes, inspections, resolved reports and so on it held. /stafflog opens those sessions as a menu, with a ranking and a summary on top. Use it to see who actually works the shift.
Before you start#
- The module switch is
modules.staff-loginplugins/ExyliaStaff/config.yml, on by default. It needs the staff mode module: sessions are only recorded while a player is in staff mode. - Staff read their own log with
exyliastaff.stafflog. Reading somebody else's, the summary of another member and the ranking needexyliastaff.stafflog.others. Both are op by default.
Steps#
Open your own log
Run /stafflog, or click the written book in the staff mode hotbar. The menu lists your sessions of the last seven days, one entry each. A green entry is the session you are in now. Each shows its duration, AFK time, server and the actions counted in it. For another window, give the days: /stafflog 30.
Read the totals
Run /stafflog summary. One card holds the last 7 days and another the last 30: sessions, total time, active time, AFK time and the actions counted.
Look at somebody else
Run /stafflog sessions <player> [days] for their sessions, or /stafflog summary <player> for their totals. Both need exyliastaff.stafflog.others. Their name goes after sessions on purpose, so the command offers its four screens first and not every player on the network.
Rank the team
Run /stafflog top [days]. Every staff member with a session in that window is listed, most active first. Each head shows active time, total time, AFK time with its percentage, sessions, and actions with a rate per hour.
Check that it works#
Enter staff mode with /staff, run a command such as /freeze <player> and leave. Then run /stafflog: you should see one session of a few minutes with freeze: 1 in its actions. If it says you have no sessions, the module is off or you never entered staff mode in this window.
Going further#
How idle time is counted#
The ranking sorts by active time, which is time on duty minus idle time, because time online is a number anybody can raise by leaving the client open. A staff member counts as idle after afk-after-seconds (default 300) without moving to another block, clicking, chatting or running a command, and every counted action also resets the clock. The first five minutes of an idle stretch are free; only what comes after is AFK. The clock is checked every thirty seconds.
The AFK module has its own idle timer, used by random teleport; the log keeps its own afk-after-seconds.
What gets counted#
While a session is open on this server, the log counts what the other modules announce: freeze, unfreeze, inspect, enderchest, container, teleport, report_resolve, report_dismiss, helpop_reply, helpop_close, punish, mining_reset and xray_toggle. Actions done on another server count in that server's session.
What a session is#
A session opens when a player enters staff mode, or when the module starts while somebody already is. It closes when they leave staff mode, quit, or the module stops. A quit closes the row and the next join opens a new one, so rows are per connection and the summaries add them up.
Keep less, or more#
keep-days (default 90) deletes sessions older than that once a day. 0 keeps everything. With the network linked, Exylia Staff Web reads the same sessions for its team activity page.
Show minutes on a scoreboard#
%staff_stafflog_today% gives the minutes in staff mode today, live session included, and %staff_stafflog_week% the last seven days.
Technical details
afk-after-seconds: 300
keep-days: 90Module id stafflog, files under modules/stafflog/. Tables: staff_log_sessions (one row per session) and staff_log_daily (one total per player and day). Messages are in lang/<language>/modules/stafflog/messages.yml: no-sessions with %target% and %days%, never-played, action-line with %action% and %count%, no-actions and no-staff with %days%. The three menus are in lang/<language>/menus/stafflog/ (sessions.yml, summary.yml, top.yml).
| Command | What it does | Permission |
|---|---|---|
/stafflog [days] | Open your own staff log (7 days by default). | exyliastaff.stafflog |
/stafflog sessions <player> [days] | Open another staff member's sessions. | exyliastaff.stafflog.others |
/stafflog top [days] | Rank every staff member by activity. | exyliastaff.stafflog.others |
/stafflog summary [player] | Open a summary of staff activity. Another member's needs stafflog.others. | exyliastaff.stafflog |
| Permission | Who has it | What it allows |
|---|---|---|
exyliastaff.stafflog | Admins (op) | Read your own staff log. |
exyliastaff.stafflog.others | Admins (op) | Read another staff member's log. |
| Placeholder | Shows | Example |
|---|---|---|
%exyliastaff_staff_stafflog_today% | Minutes in staff mode today. | 95 |
%exyliastaff_staff_stafflog_week% | Minutes in staff mode over the last seven days. | 640 |
Something missing on this page? Tell us on Discord