2026-05-26 00:59:39 -04:00
2026-05-26 13:31:21 -04:00
2026-05-26 13:31:21 -04:00

Staff

Staff tools for KweebecNet: punishments, history, cross-server staff chat, player lookup.

What it does

  • Punishments: ban, tempban, mute, tempmute, kick, warn. All persist to MySQL. Bans + mutes propagate across all servers in the network within milliseconds (via NetworkCore's MessageBus).
  • History: every action a player has ever received is queryable with /history <player>.
  • Staff chat: /sc <message> broadcasts to every staff member online on any server.
  • Player lookup: /lookup <player> shows UUID, online status, current/last server, active punishments.

Requires

  • NetworkCore with mysql.enabled: true and a healthy MySQL connection
  • A working network.auth_token configured the same way as for NetworkCore (since this plugin uses the cross-server bus)
  • Hytale permission nodes assigned to your staff group(s). Grant networkstaff.* for full access, or pick specific nodes - see docs/03_Commands.md.

If MySQL isn't configured in NetworkCore, Staff refuses to start and logs a clear error. Fix NetworkCore first, then restart.

Read before changing

See docs/ for the full breakdown:

Why this is critical

This plugin enforces who can be on the network. Bugs here mean:

  • A banned player gets back in (the network looks compromised to your community)
  • A staff member loses access (the network looks broken to staff)
  • A mute leaks across worlds incorrectly (chat gets weird)

Treat changes to enforcement code (BanEnforcer, ChatEnforcer, PunishmentService) the same way you'd treat changes to NetworkCore - read the docs and ask a higher-up before merging.

The non-enforcement pieces (lookup, history, staff chat formatting) are lower-stakes; you can iterate on those more freely.

S
Description
stuff that staff members need
Readme 166 KiB
Languages
Java 100%