Skip to content

Features

Staff tools

Network freeze, hierarchy vanish, staff mode with saved inventory, follow, server manager and staff list in sofyCore.

The staff module is configured in staff.yml and requires Redis. Its messages are in lang/staff/ (English by default).

Freeze

/freeze <player> freezes a player on any server of the network. The state lives in Redis, so the player stays frozen after switching servers or reconnecting. A frozen player gets a visual ice block on the head and restrictions while frozen.

If a frozen player disconnects:

  1. the freeze effects are removed;
  2. the console runs disconnect-commands with %player%, %uuid%, %staff% and %server% (empty by default: no automatic sanction);
  3. staff with sofycore.staff.freeze.notify on every server are notified;
  4. the freeze stays in Redis and applies again on the next join.

Vanish

/vanish hides you from lower ranks across the network:

  • equal or higher ranks see you with the invisibility effect;
  • lower ranks do not see you at all (neither the entity nor the TAB entry);
  • with the ranks module off, only players with sofycore.staff.vanish.see see you.

With the nametags module and hide-vanished: true, your nametag is hidden while vanished.

Staff mode

/staffmode (aliases /mod, /h, /staff) saves your inventory, armor, effects, location, game mode, flight, health, hunger, experience and vanish state, then gives you a protected hotbar and enables vanish. Running it again, or using the bed item, restores everything exactly as it was.

SlotItemAction
0CompassTeleport to the block you look at, or through the wall
1Blaze rodFreeze or unfreeze the player you right-click
2BookOpen the player's staff panel
3ChestOpen the player's inventory
4FeatherWalk or fly speed, up to five levels
5HeadStaff online in the network
6PaperPending reports
7DyeToggle vanish
8BedLeave staff mode

Each item needs sofycore.staff.mode.item.<id> (granted by default): deny it in a rank to hide that item. Materials accept modern and legacy names (RED_BED|BED), so the same file works from 1.8 to 26.x. Custom items can use the COMMAND action.

While in staff mode you cannot break or place blocks, use containers, drop or pick up items, attack or take damage. Chat and commands still work.

Across the network: staff mode is remembered in the database and resumes automatically when you join another server. Each server keeps its own inventory backup in plugins/sofyCore/staffmode/<uuid>.yml, so items are never moved between servers or duplicated after a crash.

Follow

/follow <player> (staff mode only) seats you on top of a player while vanished. If the player switches server, sofyCore looks them up and sends you to their server through the proxy. /unfollow stops.

Server manager

  • Alerts when a server goes online or offline, for staff with sofycore.staff.servermanager.notify.
  • Remote commands: /sm <server|*> <command> runs a console command on one or every server. Requires sofycore.staff.servermanager.run and ADMIN authority by default.
  • Server list: /sm listservers and /sm info <server> with players, slots, version and TPS (on Paper).

Staff list

/staffonline lists the staff online in the network; the /stafflist menu does the same. Clicking a name needs sofycore.staff.list.goto. Vanished staff only appear to those who could see them.