StaffModeration v1.6.11
The Complete Moderation, Staff Management & Discord Bot Suite for Serious Minecraft Servers
by KervsDev
────────────────────────────────────────
OVERVIEW
StaffModeration is an all-in-one moderation and staff management plugin built for Minecraft servers that are serious about running a clean, professional, well-staffed community. Instead of stacking five or six separate plugins — a punishment plugin, a staff-tools plugin, a report system, an anti-cheat trap, a tier-testing plugin, and a Discord bot — StaffModeration merges all of it into a single plugin with one config, one database, and one consistent experience for your staff team.
Beyond the core moderation toolkit, StaffModeration ships with a deeply integrated Discord bot that includes a built-in AI chat assistant (OpenRouter-powered), AI image generation, text-to-speech in voice channels, full slash command support, Discord-to-Minecraft rank sync, a daily rewards system, pre-registration and launch-day tools, and a full license key system for resellers or multi-server networks. Every part of the plugin — punishments, staff tools, Discord behavior, embeds, and AI settings — is fully configurable.
Whether you're running a small SMP or a large multi-staff network, StaffModeration is designed to give your staff team everything they need to moderate effectively without leaving Minecraft, while keeping your community informed and engaged through Discord.
Requires: KervsCore
Soft-depends on: LuckPerms, PlaceholderAPI
────────────────────────────────────────
PUNISHMENT SYSTEM
Full ban, tempban, IP ban, mute, tempmute, and kick system with a shared, unified punishment history per player.
Permanently ban a player.
Ban for a set duration (7d, 12h, 30m), automatically lifted on expiry.
Ban a player's IP to prevent alt-account ban evasion.
Multiple ways to reverse a ban, including by unique Ban ID when a player's name can't be resolved.
Browse the full ban history with reasons, dates, durations, and issuing staff member.
Same depth of control for chat mutes.
Immediate removal from the server.
Punishment Presets: Server owners can pre-define standardized punishments directly in the config (e.g. Cheating = 7-day Tempban, Duping = 14-day Tempban, Harassment = 7-day Tempmute, Spamming = 1-day Tempmute). Staff apply these with one click from the GUI instead of manually typing durations and reasons — keeping punishment severity consistent across your entire staff team, no matter who's online.
────────────────────────────────────────
🕵️ STAFF TOOLS
Everything your staff team needs to investigate and handle suspicious players, built directly into the plugin.
Locks a player in place with a full-screen title warning, and alerts staff if the frozen player tries to disconnect. Ideal for holding a suspect before a screenshare.
Freezes global chat server-wide during raids, drama, or spam incidents.
Go invisible to regular players while on duty, with fake join/quit messages so vanish is undetectable.
Live, syncing view of a player's inventory. Staff can optionally interact with it directly, and the plugin automatically flags/alerts if a banned or illegal item is detected.
Quality-of-life staff utility commands, plus shortcuts /gmc, /gms, /gma, /gmsp — no need for separate utility plugins.
Central command that opens the StaffMod GUI and houses every subcommand: gui, toggle, tier, ss, chat, redstone, optimizer, maintenance, update.
Staff Mode (via /sm toggle) puts a staff member "on duty": auto-vanish, auto-fly, and a preset moderation kit are applied instantly, then cleared again the moment staff mode is turned off — keeping staff inventories clean between sessions.
Screenshare (SS) locks a suspected player into a screenshare state with on-screen warnings. If the player disconnects mid-screenshare ("SS dodging"), they're automatically flagged for evasion.
Deploys a convincing fake cheater stash — spawner, double chest, shulker box, and ender chest — used to catch x-ray or cheat-using players exploring your world. Staff can save stash templates, deploy at saved or current locations, list every active stash, and remove them on command.
────────────────────────────────────────
PLAYER REPORTS
Any player can report a rule-breaker, with a configurable cooldown to prevent spam. Staff are notified instantly.
In-game menu for staff to review, resolve, or place reports under observation.
Reports can also be fully managed from Discord via the /report resolved and /report observed slash commands — no need to be logged into the game to triage reports.
────────────────────────────────────────
TIER TESTING SYSTEM
A complete PvP skill-ranking system built in.
Players queue up for a live tier test.
Staff-side control over the testing arena and results.
Live Discord embed shows the current tier queue in real time, and results/queue activity broadcast automatically to a dedicated channel — configurable directly from Discord with /tier queue-config.
────────────────────────────────────────
DISCORD ACCOUNT LINKING & RANK SYNC
Generates a code in-game; finish linking in Discord with /link code:<code>.
Players can unlink themselves; staff can unlink anyone.
Force-syncs in-game rank (via LuckPerms) to a linked Discord role AND nickname. Sync one player or every linked player at once, in-game or with the /syncrank and /syncrankplayer Discord slash commands.
Link Rewards: Automatically run configurable console commands the first time a player links their account (e.g. granting crate keys), fully editable in config.
────────────────────────────────────────
FULL DISCORD BOT INTEGRATION
StaffModeration doesn't just send webhooks — it runs a complete, slash-command-driven Discord bot:
AI Assistant
Moderation & Server Management, Right From Discord
Community & Growth Tools
Reseller / Network Tools
-
Fully Configurable
────────────────────────────────────────
SERVER & ACCOUNT MANAGEMENT
Reload every config file with a clean, timed summary of what reloaded successfully — no restart required.
Put the server into maintenance mode with a live Discord announcement, and close it out the same way.
Broadcast in-game and to Discord in one command.
Manually trigger an interactive, Discord-driven "Chat Code" community event.
In-game reference for using the plugin, linking accounts, and setting up the Discord bot from scratch.
────────────────────────────────────────
PERFORMANCE & OPTIMIZATION TOOLS
────────────────────────────────────────
PERMISSIONS
All permissions default to OP only unless noted otherwise.
(Full permission list included in the plugin's plugin.yml and in-game /staffhelp menu.)
────────────────────────────────────────
REQUIREMENTS
────────────────────────────────────────
WHY STAFFMODERATION?
One plugin replaces a punishment plugin, a staff-tools plugin, a report system, an anti-cheat trap, a tier-testing plugin, and a full-featured Discord bot with AI chat, TTS, and image generation — all sharing one config, one database, and one consistent staff experience. Built for active SMP communities and staff teams that need professional-grade moderation without juggling ten separate plugi
ns.
────────────────────────────────────────
SUPPORT
Questions, bug reports, or feature requests — reach out via the resource's Discord/support link or open a ticket. Update logs and changelogs are posted with every release.
The Complete Moderation, Staff Management & Discord Bot Suite for Serious Minecraft Servers
by KervsDev
────────────────────────────────────────
OVERVIEWStaffModeration is an all-in-one moderation and staff management plugin built for Minecraft servers that are serious about running a clean, professional, well-staffed community. Instead of stacking five or six separate plugins — a punishment plugin, a staff-tools plugin, a report system, an anti-cheat trap, a tier-testing plugin, and a Discord bot — StaffModeration merges all of it into a single plugin with one config, one database, and one consistent experience for your staff team.
Beyond the core moderation toolkit, StaffModeration ships with a deeply integrated Discord bot that includes a built-in AI chat assistant (OpenRouter-powered), AI image generation, text-to-speech in voice channels, full slash command support, Discord-to-Minecraft rank sync, a daily rewards system, pre-registration and launch-day tools, and a full license key system for resellers or multi-server networks. Every part of the plugin — punishments, staff tools, Discord behavior, embeds, and AI settings — is fully configurable.
Whether you're running a small SMP or a large multi-staff network, StaffModeration is designed to give your staff team everything they need to moderate effectively without leaving Minecraft, while keeping your community informed and engaged through Discord.
Requires: KervsCore
Soft-depends on: LuckPerms, PlaceholderAPI
────────────────────────────────────────
PUNISHMENT SYSTEMFull ban, tempban, IP ban, mute, tempmute, and kick system with a shared, unified punishment history per player.
/ban <player> [reason]Permanently ban a player.
/tempban <player> <duration> [reason]Ban for a set duration (7d, 12h, 30m), automatically lifted on expiry.
/banip <player> [reason]Ban a player's IP to prevent alt-account ban evasion.
/unban <player> | /unbanip <ip> | /unbanid <id>Multiple ways to reverse a ban, including by unique Ban ID when a player's name can't be resolved.
/banlistBrowse the full ban history with reasons, dates, durations, and issuing staff member.
/mute <player> [reason] | /tempmute <player> <duration> [reason] | /unmute <player> | /mutelistSame depth of control for chat mutes.
/kick <player>Immediate removal from the server.
Punishment Presets: Server owners can pre-define standardized punishments directly in the config (e.g. Cheating = 7-day Tempban, Duping = 14-day Tempban, Harassment = 7-day Tempmute, Spamming = 1-day Tempmute). Staff apply these with one click from the GUI instead of manually typing durations and reasons — keeping punishment severity consistent across your entire staff team, no matter who's online.────────────────────────────────────────
🕵️ STAFF TOOLS
Everything your staff team needs to investigate and handle suspicious players, built directly into the plugin.
/freeze <player>Locks a player in place with a full-screen title warning, and alerts staff if the frozen player tries to disconnect. Ideal for holding a suspect before a screenshare.
/freezechatFreezes global chat server-wide during raids, drama, or spam incidents.
/vanish (alias /v)Go invisible to regular players while on duty, with fake join/quit messages so vanish is undetectable.
/invsee <player>Live, syncing view of a player's inventory. Staff can optionally interact with it directly, and the plugin automatically flags/alerts if a banned or illegal item is detected.
/godmode [player] [on|off] | /fly [player] [on|off] | /flyspeed <1-10> [player] | /gamemode <mode> [player]Quality-of-life staff utility commands, plus shortcuts /gmc, /gms, /gma, /gmsp — no need for separate utility plugins.
/staffmod (aliases /sm, /staffmode)Central command that opens the StaffMod GUI and houses every subcommand: gui, toggle, tier, ss, chat, redstone, optimizer, maintenance, update.
Staff Mode (via /sm toggle) puts a staff member "on duty": auto-vanish, auto-fly, and a preset moderation kit are applied instantly, then cleared again the moment staff mode is turned off — keeping staff inventories clean between sessions. Screenshare (SS) locks a suspected player into a screenshare state with on-screen warnings. If the player disconnects mid-screenshare ("SS dodging"), they're automatically flagged for evasion./spawnstash <set|place|here|list|remove> (alias /sstash)Deploys a convincing fake cheater stash — spawner, double chest, shulker box, and ender chest — used to catch x-ray or cheat-using players exploring your world. Staff can save stash templates, deploy at saved or current locations, list every active stash, and remove them on command.
────────────────────────────────────────
PLAYER REPORTS/report <player> <reason>Any player can report a rule-breaker, with a configurable cooldown to prevent spam. Staff are notified instantly.
/reportsIn-game menu for staff to review, resolve, or place reports under observation.
Reports can also be fully managed from Discord via the /report resolved and /report observed slash commands — no need to be logged into the game to triage reports.
────────────────────────────────────────
TIER TESTING SYSTEMA complete PvP skill-ranking system built in.
/tiertest queue | /tiertest startPlayers queue up for a live tier test.
/tier queue | /tier set | /tier stop | /tier setlocationStaff-side control over the testing arena and results.
Live Discord embed shows the current tier queue in real time, and results/queue activity broadcast automatically to a dedicated channel — configurable directly from Discord with /tier queue-config.
────────────────────────────────────────
DISCORD ACCOUNT LINKING & RANK SYNC/linkGenerates a code in-game; finish linking in Discord with /link code:<code>.
/unlink [player]Players can unlink themselves; staff can unlink anyone.
/syncrank [player|all] (alias /sr)Force-syncs in-game rank (via LuckPerms) to a linked Discord role AND nickname. Sync one player or every linked player at once, in-game or with the /syncrank and /syncrankplayer Discord slash commands.
Link Rewards: Automatically run configurable console commands the first time a player links their account (e.g. granting crate keys), fully editable in config.────────────────────────────────────────
FULL DISCORD BOT INTEGRATIONStaffModeration doesn't just send webhooks — it runs a complete, slash-command-driven Discord bot:
AI Assistant
- Built-in AI chat assistant (OpenRouter-backed) that answers player and community questions directly in Discord, scoped to your server's own information.
- Remembers conversation context per channel/user and can store lightweight memory notes about returning users.
- Recognizes the configured plugin owner for elevated AI interactions.
- Optional AI image generation for community engagement.
- Optional text-to-speech: the bot can join a Discord voice channel and read messages aloud (Google Cloud TTS).
/aicredits— Check remaining AI API quota straight from Discord.
Moderation & Server Management, Right From Discord
/announce— Broadcast a styled announcement in-game and to Discord simultaneously./maintenance|/maintenancestop— Start/stop maintenance mode from Discord with reason, ETA, and priority — automatically kicks/blocks non-bypassed players in-game and posts a live status embed./dm|/dmall— Message a single member or every member of your Discord server directly from a slash command./message— Post an anonymous message into any channel through the bot.- Server status & !ip embeds show your server's live status with online staff automatically highlighted.
Community & Growth Tools
/pre-register|/pre-register-link— Let your community pre-register interest before your server even launches./release— Notify every pre-registered user by DM the moment your server goes live./dailyrewards— Players claim a configurable daily in-game reward straight from Discord, tied to their linked account, with cooldown protection.
Reseller / Network Tools
-
/staffmod-licenses | /license-generate | /license-revoke — Full license key system (HMAC-SHA256 signed) for anyone distributing StaffModeration across multiple servers or clients.Fully Configurable
- Bot token, webhook URLs, channel routing (tier tests, screenshare alerts, chat codes, announcements, pre-registration, link logs), embed colors, AI settings, and automod — everything lives in discord.yml, no code editing required.
- Two-way live chat relay between Minecraft and Discord.
────────────────────────────────────────
SERVER & ACCOUNT MANAGEMENT/staffmodreload (alias /smreload)Reload every config file with a clean, timed summary of what reloaded successfully — no restart required.
/maintenance <reason> <estimatedTime> <priority> | /maintenancestopPut the server into maintenance mode with a live Discord announcement, and close it out the same way.
/announce <message>Broadcast in-game and to Discord in one command.
/chatcode forceeventManually trigger an interactive, Discord-driven "Chat Code" community event.
/staffhelp [link|bot-setup]In-game reference for using the plugin, linking accounts, and setting up the Discord bot from scratch.
────────────────────────────────────────
PERFORMANCE & OPTIMIZATION TOOLS/sm redstone and /sm optimizer — Built-in redstone lag and general server optimization commands, rate-limited to prevent abuse, with a bypass permission for trusted staff.────────────────────────────────────────
PERMISSIONSAll permissions default to OP only unless noted otherwise.
staffmod.admin — Full admin access to everything.staffmod.ban / .tempban / .banip / .unban / .unbanip — Ban management.staffmod.mute / .tempmute / .unmute — Mute management.staffmod.kick / .freeze / .freezechat / .vanish / .invsee / .ss — Staff tools.staffmod.godmode / .godmode.others — Invulnerability (self / others).staffmod.fly / .fly.others / .flyspeed / .flyspeed.others — Flight controls.staffmod.gamemode / .gamemode.others — Gamemode controls.staffmod.chat — Staff chat access.staffmod.bypass — Bypass freeze/mute restrictions.staffmod.freezechat.bypass — Talk while chat is frozen.staffmod.use — Access the StaffMod GUI.staffmod.report (default: true) — Allows any player to submit reports.staffmod.reports.view — View/manage submitted reports.staffmod.tier — Full access to tier testing commands and GUI.staffmod.link / .unlink (default: true) — Discord account linking.staffmod.unlink.others / .syncrank / .syncrank.others / .syncrank.all — Discord rank sync scopes.staffmod.spawnstash — Place fake cheater stash structures.staffmod.maintenance / .maintenance.bypass — Start/stop maintenance, bypass maintenance kick.staffmod.announce / .chatcode — Broadcast announcements and force chat code events.staffmod.optimizer / .optimizer.bypass — Optimizer access and rate-limit bypass.staffmod.reload — Reload plugin configuration.staffmod.staff — Marks a player as "online staff" for Discord embed display.(Full permission list included in the plugin's plugin.yml and in-game /staffhelp menu.)
────────────────────────────────────────
REQUIREMENTS- Paper/Spigot 1.21+
- KervsCore (required dependency)
- LuckPerms (optional — enables Discord rank sync)
- PlaceholderAPI (optional — enables %staffmod_tier% and other placeholders)
- A Discord bot token (optional — required only for Discord integration features)
────────────────────────────────────────
WHY STAFFMODERATION?One plugin replaces a punishment plugin, a staff-tools plugin, a report system, an anti-cheat trap, a tier-testing plugin, and a full-featured Discord bot with AI chat, TTS, and image generation — all sharing one config, one database, and one consistent staff experience. Built for active SMP communities and staff teams that need professional-grade moderation without juggling ten separate plugi
ns.
────────────────────────────────────────
SUPPORTQuestions, bug reports, or feature requests — reach out via the resource's Discord/support link or open a ticket. Update logs and changelogs are posted with every release.
