Content generated with AI — it may contain mistakes.

ExyliaStaff/GuidesUpdated in v1.8.0

Show staff a status line

Put one line above the hotbar that shows which staff toggles are on and how the server is doing, and change what it says.

Page 21 of 383 min read

A staff member on duty has half a dozen toggles running at once. The action bar puts them on one line above the hotbar, with a tick or a cross each, next to the server's TPS, MSPT and CPU. It redraws itself every second, and there is no command to learn.

Before you start#

  • The module switch is modules.action-bar in plugins/ExyliaStaff/config.yml, on by default. You can also switch it from /staffadmin settings (Modules, then the communication card).
  • The line is drawn for players in staff mode, and for players who are vanished while off duty. Nobody else sees it.
  • TPS, MSPT and CPU in the shipped line are %server_tps%, %server_mspt% and %server_cpu_process:percent%, provided by ExyliaLib's server placeholders.

Steps#

See the default line

Run /staff. Above your hotbar you read STAFF ▎ ✔ Vanish · ✔ Alerts · ✖ Chat ▎ TPS 20.0 · MSPT 12.3 · CPU 8%. The first three are the toggles for vanish, mining alerts and staff chat.

Open the text file

Open plugins/ExyliaStaff/lang/<language>/modules/actionbar/messages.yml. staff-mode is the line shown on duty, vanish is the line shown when you are hidden off duty. Both are plain text, so colours and gradients work in them.

Add or remove a toggle

To show a toggle, write %staff_actionbar_check_<placeholder>% followed by its name. The placeholder goes without its percent signs: %staff_actionbar_check_staff_vanished% asks %staff_vanished% and prints a green tick when it is on, a red cross when it is off. To remove one, delete its piece of the line.

Reload

Run /staffadmin reload. The bar redraws with the new text at once.

Check that it works#

Run /staff and read the bar, then /staff again to leave: it goes away. Run /vanish without staff mode and a yellow VANISH ▎ Hidden and off duty line appears; /vanish again removes it. If you are on duty and vanished you read the staff line, since that one already shows the vanish tick.

Going further#

Change how often it redraws#

refresh-ticks in modules/actionbar/config.yml is the pause between redraws, 20 by default (once a second). The client fades an action bar after about three seconds, so keep it well under 60.

Change the ticks and crosses#

icon-on (default {success}✔) and icon-off (default {error}✖) in the same messages.yml are what a toggle prints. true, yes, on, 1 and enabled get the tick; everything else, including a placeholder that does not resolve, gets the cross. A module that is switched off shows a cross, which is more honest than an error across the screen.

Show any value, not only toggles#

Anything PlaceholderAPI resolves can go in the line: %server_tps%, a balance, the number of open reports. Ticks and crosses are only for true or false placeholders.

Turn one line off#

Leave staff-mode or vanish empty and that situation shows no bar. To turn the whole thing off, set modules.action-bar: false and restart, or stop it from the module list in /staffadmin modules.

Technical details
KeyFileDefaultWhat it means
refresh-ticksmodules/actionbar/config.yml20Ticks between redraws.
staff-modelang/<language>/modules/actionbar/messages.ymlthe line aboveShown while in staff mode. It wins over vanish.
vanishsameVANISH ▎ Hidden and off duty ▎ TPS … · MSPT …Shown while vanished with staff mode off. Without it nothing on screen says you are hidden, since /vanish alone has no hotbar or sidebar.
icon-on, icon-offsame{success}✔, {error}✖What a toggle prints.

The module id is actionbar. The client has one action bar: if another plugin writes to it, the newest writer wins and ExyliaStaff puts its line back on the next check.

PlaceholderShowsExample
%exyliastaff_staff_actionbar_check%Turns another boolean placeholder into a tick or a cross. Write the name after it, for example staff_actionbar_check_mining_alerts_active.true

Something missing on this page? Tell us on Discord