Overview
StaffModeX is a moderation suite for Minecraft administrators. It focuses on silent investigation, vanish, GUI-based moderation, and network-aware synchronization. It also includes examine menus, freeze handling, warning and report storage, CPS testing, ore-finder alerts, configurable armor and action bars, and optional webhook notification delivery.
Silent investigationVanish, follow, phase, random teleport, player browsing, and staff-only information tools.
Staff operation modeHotbar swaps, action bar, effects, armor sets, command gating, and restore behavior.
Case handlingReports, warnings, infractions, notes, IP lookup, and optional webhook fan-out.
Cross-server visibilityRedis-backed online staff state, remote staff items, and MySQL synchronization.
Compatibility and runtime notes
Runtime target: 1.8 → 26.1.x
Folia-compatible project target
| Area | Support | Notes |
|---|
| Server versions | 1.8 → 26.1.x | StaffModeX is designed for this version range. |
| Proxy environments | BungeeCord / Velocity network workflows | Redis sync plus BungeeCord connect messaging are part of StaffModeX. |
| Database | Optional MySQL | Warnings and reports can be synchronized for multi-server moderation. |
| Redis | Optional | Staff mode, staff chat, vanish visibility, and online-staff data are network-aware. |
| PlaceholderAPI | Soft dependency | Expansion registration and placeholder replacement utilities are included. |
| Extra hook | PremiumVanish toggle | The configuration includes a vanish hook toggle for PremiumVanish integration. |
Feature modules
The staff mode core handles entry, exit, configurable gamemode changes, restoration, whitelisted commands, blocked commands, action bars, effects, join alerts, quit suppression, and optional console command execution on enter / leave.
The examine GUI exposes food state, connection details, gamemode, location tools, player notes, freeze action, warn flow, and inventory preview. This is one of the main reasons the plugin feels like a workflow suite instead of a collection of raw commands.
The Redis layer tracks online staff, server names, staff chat, and network-side staff mode data. The staff list menu can show local online staff, remote online staff, and offline staff separately. Remote entries can trigger a BungeeCord connect payload so moderators can move to the correct server.
CPS testing is built into the hotbar flow with configurable timing and threshold rules. Ore-finder notifications track configured ores and streaks to help staff identify suspicious mining behavior. Reports can optionally emit webhook notifications for external moderation channels.
Commands
| Command | Purpose | Notes |
|---|
/staffmode | Toggle staff mode | Primary entry point for the moderation loadout and restore workflow. |
/vanish | Toggle vanish | Can be used independently or alongside staff mode. |
/freeze <player> | Freeze a player | Supports the dedicated freeze workflow and visual feedback. |
/examine <player> | Open examine UI | Starts the GUI-based investigation flow. |
/report <player> <reason> | Submit a report | Can route into report storage and optional webhook delivery. |
/warn <player> <reason> | Issue a warning | Feeds into the broader infraction history. |
/infraction <player> <reason> | Issue an infraction | Direct infraction command path. |
/infractions <player> | View infraction history | Review moderation history through command flow. |
/ip <player> | Check player IP | Controlled by the IP feature toggle and permission. |
/helpop <message> | Request staff help | Includes a configurable cooldown. |
/staffchat | Toggle staff chat | Can synchronize across the network when Redis is enabled. |
/staffmodex reload | Plugin administration | The main command currently exposes reload behavior via the admin path. |
Permissions
Core staff access
staffmodex.staffmode
staffmodex.vanish
staffmodex.staffchat
staffmodex.freeze
staffmodex.examine
staffmodex.teleport
staffmodex.heal
Moderation records
staffmodex.report.receive
staffmodex.warning
staffmodex.warning.receive
staffmodex.infractions
staffmodex.ip
Visibility and bypass
staffmodex.vanish.pvp
staffmodex.vanish.see
staffmodex.freeze.bypass
staffmodex.inventory.bypass
Administrative / operational
staffmodex.join
staffmodex.view_joins
staffmodex.build
staffmodex.admin
Configuration guide
Redis block
Controls cross-server features. Configure host, port, password, SSL, and connection pool settings. Use this when you want synchronized staff mode, vanish visibility, staff chat, and staff-list awareness across multiple servers.
MySQL block
Enable this for synchronized warnings and reports between multiple servers. StaffModeX uses an async data workflow for these records.
CPS settings
Tune the CPS test duration, ignore-long-interval threshold, minimum sample count, and dangerous threshold used to classify output.
Armor and staff visuals
Define multiple armor sets by permission, leather colors, and equipped pieces. Pair this with action bars for clear state visibility during moderation.
Ore-finder
Enable or disable ore tracking, set streak thresholds, configure notification cooldowns, and list the materials to monitor.
Vanish behavior
Control whether vanish auto-enables with staff mode, whether staff status is required, which potion effects apply, and whether the PremiumVanish hook is enabled.
Staff mode rules
Set restore location, join alerts, hidden quit behavior, mode-switch alerts, whitelisted commands, blocked commands, enter/leave console commands, and long-duration effects.
Report webhook
Deliver reports to an external channel with configurable username, avatar URL, and message content blocks using placeholders for server, player, reporter, reason, and time.
Hotbar layout
The current config exposes staff hotbar items such as phase, random teleport, vanish, players, staff list, freeze, CPS, examine, follow, and an optional knockback rod. Each slot can be enabled, disabled, and assigned version-safe material aliases. The fill item and menu styling are also configurable.
Suggested moderation workflows
Routine patrol
Enter staff mode, auto-apply vanish, use players and stafflist tools, jump between suspicious locations, and use examine before escalating.
Escalated investigation
Freeze the player, inspect location and inventory, review connection and CPS information, log notes, then issue a warn or infraction if needed.
Network moderation
Use Redis-backed staff lists to see staff activity on other servers and click remote staff entries to move to the correct server through the proxy path.
Integrations and external systems
PlaceholderAPI
Soft dependency with expansion registration when installed.
Redis
Cross-server staff state, staff chat, and staff list awareness.
MySQL
Shared warning and report storage for multi-server environments.
Proxy transfer
BungeeCord plugin messaging is used for remote server connection actions.
PremiumVanish hook
Optional vanish hook exposed by config.
Webhooks
External report notification delivery for staff operations channels.