MaxStaff

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
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:

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

Administration Commands:

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.

MySQL
Recommended for networks or multi-server setups.
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:
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:
Examples:
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.