Content generated with AI — it may contain mistakes.

ExyliaStaff/GuidesUpdated in v1.8.0

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.

Page 11 of 383 min read

/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.stafflist to see the list. A player is listed when they hold exyliastaff.staff; that is the only thing that makes someone "staff" here.
  • The module switch is modules.staff-list in plugins/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#

CommandWhat it doesPermission
/stafflistList the staff online on every server.exyliastaff.stafflist
PermissionWho has itWhat it allows
exyliastaff.stafflistAdmins (op)List the staff online.
Configuration and messages
plugins/ExyliaStaff/modules/stafflist/config.yml
yaml
heartbeat-seconds: 30
expire-seconds: 90
switch-grace-seconds: 5
KeyDefaultWhat it does
heartbeat-seconds30Seconds between presence reports to the other servers.
expire-seconds90Seconds without a report before a server leaves the list. Keep it above heartbeat-seconds.
switch-grace-seconds5Time 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.

PlaceholderShowsExample
%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