DISCORD: https://discord.com/invite/Vr46JHm2kd

WIKI: https://docs.maxking.lat/

MaxStaff

MaxStaff is a complete moderation and administration plugin for Paper/Spigot 1.21+ servers, designed for professional staff teams.

It includes staff mode, vanish, punishments, reports, staff chat, CommandSpy, Freeze/SS tools, InvSee, Anti-Xray alerts, client detection, Discord webhooks, local/MySQL storage, and fully configurable GUI menus.

Features

Staff Mode

• Toggle staff mode with /staff
• Saves and restores staff inventory automatically
• Configurable staff items by slot and material
• Includes punish, freeze, player list, random teleport, invsee, vanish, and wall compass tools
• Configurable action bar
• Optional protection to prevent staff from hitting players while in staff mode

Vanish

• Toggle invisibility with /vanish
• Permission-based visibility for other staff members
• Optional auto-vanish on join
• Vanish persistence when MySQL is enabled

Punishment System

• Ban, tempban, mute, tempmute, kick, and warn
• IP ban, temporary IP ban, and IP unban
• Player punishment history
• Advanced /sanction GUI with configurable reasons and durations
• Active sanctions menu with /sanction list
• Silent punishments using /silent
• Group-based punishment limits
• Automatic warn thresholds
• Protection system for protected staff members

Staff Tools

• /freeze and /unfreeze for screen share checks
• Optional automatic ban if a frozen player disconnects
• /invsee for real-time inventory inspection
• /revive to restore recent death inventories
• /fly with configurable speed levels
• /gamemode or /gm with optional GUI selector
• /alts to check accounts associated with the same IP
• /cmdspy with sensitive command argument masking
• /chat mute and /chat clear
• /sc or /staffchat for private staff communication

Reports

• Players can report others using /report <player> <reason>
• Configurable cooldown
• Bypass permission for staff
• Optional online target validation
• Minimum and maximum reason length
• Optional report storage
• Clickable staff notifications
• Discord webhook logs

Detection & Security

• Client Tracker using plugin messaging
• Staff notifications for detected clients
• Custom client signatures
• Configurable Anti-Xray system
• Anti-Xray suspect menu with /xray
• Configurable ore thresholds, cooldowns, and bypass permissions

Integrations

• PlaceholderAPI support
• bStats support with configurable toggle
• Discord webhooks for punishments, reports, freeze, staff mode, chat actions, and xray alerts
• MySQL support through HikariCP
• Local YAML fallback when MySQL is disabled or unavailable

Requirements

| Requirement | Details |
|---|---|
| Java | 21 or higher |
| Server | Paper/Spigot compatible with 1.21+ |
| Build Tool | Maven |
| Optional Dependency | PlaceholderAPI |
| Included Libraries | bStats, HikariCP, MySQL Connector/J |

Installation

1. Download or build the plugin .jar.
2. Place the jar inside your server's plugins/ folder.
3. Restart the server.
4. Edit the generated files in plugins/MaxStaff/:
   • config.yml
   • discord.yml
   • lang/messages_en.yml
   • lang/messages_es.yml
5. Run:

/maxstaff reload

REMEMBER TO CHECK THE WIKI TO STAY UP-TO-DATE ON PERMISSIONS AND COMMANDS

Main Commands

Administration

| Command | Permission | Description |
| ----------------------------------------- | ---------------- | --------------------------------------------------- |
| /maxstaff help | maxstaff.admin | Shows the main help menu |
| /maxstaff reload | maxstaff.admin | Reloads configuration, states, GUI, and staff items |
| /maxstaff cleanupbans | maxstaff.admin | Cleans expired MySQL punishments |
| /maxstaff reset <player> <type> | maxstaff.admin | Resets punishment history |
| /maxstaff take <player> <type> [amount] | maxstaff.admin | Removes punishment history entries |
| /maxstaff debugperm <player> <type> | maxstaff.admin | Debugs punishment permissions |

Staff Tools

| Command | Permission | Description |
| --------------------- | ------------------------ | --------------------------------- |
| /staff | maxstaff.command.staff | Toggles staff mode |
| /vanish | maxstaff.vanish | Toggles vanish |
| /sc or /staffchat | maxstaff.staffchat | Staff-only chat |
| /cmdspy | maxstaff.cmdspy | Toggles command spy |
| /chat mute | maxstaff.chat.admin | Mutes global chat |
| /chat clear | maxstaff.chat.admin | Clears global chat |
| /gm or /gamemode | maxstaff.gamemode | Changes gamemode or opens GUI |
| /fly | maxstaff.fly | Toggles flight |
| /alts <player> | maxstaff.alts | Checks alternate accounts |
| /invsee <player> | maxstaff.invsee | Opens a live inventory inspection |
| /revive | maxstaff.revive | Opens the inventory restore menu |

Freeze / Screen Share

| Command | Permission | Description |
| -------------------- | ----------------- | ----------------------------- |
| /freeze <player> | maxstaff.freeze | Freezes or unfreezes a player |
| /unfreeze <player> | maxstaff.freeze | Unfreezes a player |

Punishments

| Command | Permission | Description |
| ----------------------------------------------- | ------------------------- | ------------------------------ |
| /ban <player> [time] [reason] | maxstaff.punish.ban | Bans a player |
| /tempban <player> <time> [reason] | maxstaff.punish.ban | Temporarily bans a player |
| /mute <player> [time] [reason] | maxstaff.punish.mute | Mutes a player |
| /tempmute <player> <time> [reason] | maxstaff.punish.mute | Temporarily mutes a player |
| /kick <player> [reason] | maxstaff.punish.kick | Kicks a player |
| /warn <player> [reason] | maxstaff.punish.warn | Warns a player |
| /unban <player> | maxstaff.punish.unban | Removes a ban |
| /unmute <player> | maxstaff.punish.unmute | Removes a mute |
| /history <player> | maxstaff.history | Opens punishment history |
| /ban-ip <player/IP> [time] [reason] | maxstaff.punish.banip | Bans an IP |
| /tempban-ip <player/IP> <time> [reason] | maxstaff.punish.banip | Temporarily bans an IP |
| /unban-ip <player/IP> | maxstaff.punish.unbanip | Removes an IP ban |
| /silent <punishment> <player> [time] [reason] | maxstaff.punish.silent | Executes a punishment silently |

Menus & Reports

| Command | Permission | Description |
| --------------------------- | ------------------------- | ----------------------------- |
| /sanction <player> | maxstaff.punish | Opens the punishment GUI |
| /sanction list | maxstaff.sanctions.list | Opens active sanctions menu |
| /report <player> <reason> | maxstaff.report | Reports a player |
| /xray | maxstaff.antixray.alert | Opens Anti-Xray suspects menu |

Permissions

Main Admin Permission

| Permission | Default | Description |
| ---------------- | ------- | -------------------------- |
| maxstaff.admin | OP | Full administrative access |

Staff Permissions

| Permission | Description |
| ------------------------ | ------------------------------------------ |
| maxstaff.command.staff | Allows /staff |
| maxstaff.vanish | Allows /vanish |
| maxstaff.vanish.join | Enables auto-vanish on join |
| maxstaff.see.vanish | Allows seeing vanished staff |
| maxstaff.staffchat | Allows staff chat |
| maxstaff.cmdspy | Allows CommandSpy |
| maxstaff.cmdspy.raw | Allows viewing sensitive command arguments |
| maxstaff.chat.admin | Allows chat moderation |
| maxstaff.gamemode | Allows gamemode command |
| maxstaff.fly | Allows fly command |
| maxstaff.alts | Allows alternate account checks |
| maxstaff.freeze | Allows freeze/unfreeze |
| maxstaff.invsee | Allows inventory inspection |
| maxstaff.revive | Allows inventory restoration |

Punishment Permissions

| Permission | Description |
| --------------------------- | --------------------------------------------------- |
| maxstaff.punish | Allows using /sanction |
| maxstaff.punish.ban | Allows bans and tempbans |
| maxstaff.punish.mute | Allows mutes and tempmutes |
| maxstaff.punish.kick | Allows kicks |
| maxstaff.punish.warn | Allows warnings |
| maxstaff.punish.unban | Allows unbans |
| maxstaff.punish.unmute | Allows unmutes |
| maxstaff.punish.banip | Allows IP bans |
| maxstaff.punish.unbanip | Allows IP unbans |
| maxstaff.punish.silent | Allows silent punishments |
| maxstaff.punish.override | Allows bypassing protected staff |
| maxstaff.punish.protected | Protects staff from being punished without override |
| maxstaff.history | Allows viewing punishment history |
| maxstaff.sanctions.list | Allows viewing active sanctions |

Reports & Detection

| Permission | Description |
| -------------------------- | -------------------------------------------- |
| maxstaff.report | Allows players to report others |
| maxstaff.report.notify | Receives report notifications |
| maxstaff.report.bypass | Bypasses report cooldown |
| maxstaff.client.notify | Receives client detection notifications |
| maxstaff.antixray.alert | Receives Anti-Xray alerts and allows /xray |
| maxstaff.antixray.bypass | Bypasses Anti-Xray detection |

Storage System

MaxStaff supports two storage modes:

Local YAML

Recommended for single-server setups.

database:
  enabled: false

MySQL

Recommended for networks or multi-server setups.

database:
  enabled: true
  host: "localhost"
  port: 3306
  database: "maxstaff_db"
  username: "root"
  password: "your_password"
  use-ssl: true
  server-id: "survival-1"

If MySQL fails, MaxStaff can fall back to local storage.

Discord Webhooks

MaxStaff can send logs to Discord using discord.yml.

Supported webhook categories:

• Punishments
• Reports
• Freeze / Unfreeze
• Chat clear / Chat mute
• Staff mode
• Anti-Xray alerts

Common placeholders:

{server}
{timestamp}
{staff}
{target}
{reason}
{duration}
{player}
{world}
{x}
{y}
{z}

PlaceholderAPI

If PlaceholderAPI is installed, MaxStaff registers internal placeholders:

| Placeholder | Description |
| ------------------------------ | ------------------------------------ |
| %maxstaff_in_staff_mode% | Shows if the player is in staff mode |
| %maxstaff_vanished% | Shows if the player is vanished |
| %maxstaff_frozen% | Shows if the player is frozen |
| %maxstaff_is_spy% | Shows if CommandSpy is enabled |
| %maxstaff_warn_count% | Shows total warnings |
| %maxstaff_ban_count% | Shows total bans |
| %maxstaff_mute_count% | Shows total mutes |
| %maxstaff_kick_count% | Shows total kicks |
| %maxstaff_total_punishments% | Shows total punishments |
| %maxstaff_playtime% | Shows online playtime |

Duration Formats

Supported punishment duration formats:

30s, 15m, 2h, 7d, 2w, perm

Examples:

/ban Steve 7d Xray confirmed
/mute Alex 1h Chat spam
/tempban-ip Steve 14d Punishment evasion
/silent warn Steve Minor toxicity

Recommended Role Permissions

Helper

maxstaff.command.staff
maxstaff.staffchat
maxstaff.report.notify
maxstaff.chat.admin
maxstaff.freeze
maxstaff.history
maxstaff.punish.warn
maxstaff.punish.mute
maxstaff.groups.helper

Moderator

maxstaff.command.staff
maxstaff.vanish
maxstaff.see.vanish
maxstaff.staffchat
maxstaff.cmdspy
maxstaff.chat.admin
maxstaff.freeze
maxstaff.invsee
maxstaff.revive
maxstaff.history
maxstaff.punish
maxstaff.punish.ban
maxstaff.punish.mute
maxstaff.punish.kick
maxstaff.punish.warn
maxstaff.punish.unban
maxstaff.punish.unmute
maxstaff.report.notify
maxstaff.client.notify
maxstaff.antixray.alert
maxstaff.groups.mod

Admin / Owner

maxstaff.admin
maxstaff.cmdspy.raw.owners
maxstaff.punish.override

Support

When requesting support, please provide:

• MaxStaff version
• Server version
• Java version
• Your config.yml without passwords or private data
• Relevant console logs

Notes

MaxStaff is designed to give staff teams a complete moderation toolkit in one plugin, while keeping everything configurable, modular, and easy to adapt to different server types.