Show who is on duty
List the staff online across the network, grouped by server, with vanish and staff mode markers for those allowed to see them.
/stafflist prints every staff member online on every server of your network, one block per server in alphabetical order. Staff also get a short line when a colleague connects, leaves or changes server.
Before you start#
- Give the rank
exyliastaff.stafflistto see the list. A player is listed when they holdexyliastaff.staff; that is the only thing that makes someone "staff" here. - The module switch is
modules.staff-listinplugins/ExyliaStaff/config.yml. The servers share the list through Redis, like the rest of the network features.
Steps#
Open the list
Run /stafflist (alias /slist), or click your own head, STAFF ONLINE (slot 34), in the staff mode hotbar. The console can run it too.
Read it
The header shows how many staff you can see, then each server with its members. Staff viewers see [V] after the name of a vanished member and [S] after one in staff mode.
Check that it works#
Have a second staff member join another server and run /stafflist: their server appears with their name under it. Staff online right now also see a line such as "Name » connected (server)" when they join.
Going further#
Who sees vanished staff#
A vanished member is shown only to a viewer who holds exyliastaff.staff and whose vanish level is at least the member's. The console sees everyone. Other viewers see plain names, no markers and no vanished members, and the header counts only what the viewer can see. This is on purpose: a list that names who is hidden would undo vanish.
Join, leave and server-change lines#
Staff holding exyliastaff.staff get a line when a colleague connects, disconnects or moves to another server of the network. A server change is two reports (one server loses the member, another gains them), so a disconnect is held back for switch-grace-seconds (default 5); if the member shows up elsewhere in that time it is announced as a change instead of a leave. A vanished member is announced only to staff who could see them in the list. You never get a line about yourself. Empty the announce-join, announce-quit or announce-switch message to switch that line off.
How the servers stay in sync#
Each server publishes its staff on the presence channel when a staff member joins or quits and every heartbeat-seconds. A server not heard from for expire-seconds is dropped from the list. Disabling the module sends an empty list so the others drop the server at once. AFK is not tracked here.
Commands and permissions#
| Command | What it does | Permission |
|---|---|---|
/stafflist | List the staff online on every server. | exyliastaff.stafflist |
| Permission | Who has it | What it allows |
|---|---|---|
exyliastaff.stafflist | Admins (op) | List the staff online. |
Configuration and messages
heartbeat-seconds: 30
expire-seconds: 90
switch-grace-seconds: 5| Key | Default | What it does |
|---|---|---|
heartbeat-seconds | 30 | Seconds between presence reports to the other servers. |
expire-seconds | 90 | Seconds without a report before a server leaves the list. Keep it above heartbeat-seconds. |
switch-grace-seconds | 5 | Time a member who left one server has to appear on another before it counts as a disconnect. |
Messages are in lang/<language>/modules/stafflist/messages.yml: header (%total%), server (%server%), entry (%player%, %markers%), vanished-marker, staff-mode-marker, empty, footer, and the three announcements announce-join, announce-quit (%player%, %server%) and announce-switch (%player%, %from%, %to%). See ExyliaLib messages and colours.
| Placeholder | Shows | Example |
|---|---|---|
%exyliastaff_staff_stafflist_total% | Staff online on every server. | 6 |
%staff_online% (players with exyliastaff.staff on this server) is in Placeholders.
Something missing on this page? Tell us on Discord