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.