StaffModeration

Premium All-in-One Moderation & Staff Management Suite

by KervsDev

For support/bug reports/suggestions join on this discord server

• Discord
• https://unitystudios.vercel.app/tickets

For License Request https://unitystudios.vercel.app/

StaffModeration is a complete moderation toolkit built for serious Minecraft servers. It combines punishments (ban/mute/kick/freeze/IP bans), staff tools (Screenshare, Staff Mode, InvSee, Vanish), a player report system, an anti-cheat "fake stash" trap, a Tier Testing system, Discord linking with rank sync, and a full Discord bot integration with AI chat assistant, webhooks, and announcements — all in one plugin.

Requires: KervsCore Soft-depends on: LuckPerms (for rank sync)

🔨 Punishment Commands

/ban <player> [reason] — Permanently bans a player. Supports punishment presets for one-click standardized bans.

/tempban <player> <duration> [reason] — Temporarily bans a player (e.g. 7d, 12h, 30m). Auto-unbans on expiry.

/banip <player> [reason] — Bans a player's IP, preventing alt-account evasion.

/unban <player> / /unbanip <ip> / /unbanid <id> — Lift bans by name, IP, or unique Ban ID.

/banlist — Full ban list with reasons, dates, and issuing staff.

/mute <player> [reason] / /tempmute <player> <duration> [reason] / /unmute <player> — Chat mute management.

/mutelist — Full mute list with reasons, dates, and expiry times.

/kick <player> — Immediate kick.

⭐ Punishment Presets: Pre-configure standardized punishments (e.g. Cheating = 7-day Tempban, Duping = 14-day Tempban, Harassment = 7-day Tempmute) in config.yml. Staff apply them instantly for consistent enforcement across the team.

🔌 Cores

• Anti-OP - Preventing your server from getting raided or getting op without any permission you can edit the whitelisted user on cores/anti-op.yml
• Anti-Alts - Detecting every players who has an alts on the server and sending a webhook on the discord, the webhook will send on the mod-logs-webhook showing players alts cores/anti-alts.yml
• Anti-VPN - Preventing a player to join on the server if thier country in on the whitelist cores/anti-vpn.yml
• Anti-Advertising - Preventing players to advertise other server you can edit the blacklisted words on cores/anti-advertising.yml

🕵️ Staff Tools

/freeze <player> — Locks a player in place, shows a warning title, and alerts staff if they try to log out.

/freezechat — Freezes global chat during raids, drama, or spam incidents.

/vanish (alias /v) — Toggle invisibility with optional fake join/quit messages.

/invsee <player> — Live syncing inventory view, with automatic illegal-item alerts.

/staffmod (aliases /sm, /staffmode) — Main command and GUI, with subcommands: gui, toggle, tier, ss, chat, redstone, optimizer, maintenance.

⚡ Staff Mode (via /sm toggle) — On-duty mode with auto-vanish, auto-fly, and a moderation kit. Inventory resets cleanly on toggle off.

🎥 Screenshare (SS) — Locks suspects in place with on-screen warnings; auto-flags/bans disconnects mid-SS ("SS dodging").

/spawnstash <set|place|here|list|remove> (alias /sstash) — Deploys a fake cheater stash (spawner + double chest + shulker + ender chest) to bait x-ray/cheat users. Save, place, list, or remove templates.

📋 Player Reports

/report <player> <reason> — Player-facing report command with configurable cooldown and instant staff notification.

/reports — Staff menu to review, action, and clear reports.

🏆 Tier Testing System

/tier <queue|set|stop|setlocation> — Staff-side tier test management.

/tiertest [queue|start|setlocation] — Player-facing PvP tier test queue. Results and queue activity can broadcast to Discord.

🛠️ Server & Account Management

/staffmodreload (alias /smreload) — Reload all configs without a restart.

/maintenance <reason> <estimatedTime> <priority> — Maintenance mode with Discord announcement.

/maintenancestop — Ends maintenance and notifies Discord.

/announce <message> — Styled in-game + Discord announcement.

/chatcode forceevent — Manually triggers a Discord-driven interactive chat event.

/staffhelp — In-game staff command reference.

🔗 Discord Account Linking

/link — Link Minecraft to Discord for rank sync and rewards.

/unlink [player] — Unlink your own or (with permission) another account.

/syncrank [player|all] (alias /sr) — Force-sync rank/nickname via LuckPerms, single player or all.

🎁 Link Rewards — Auto-run configurable console commands on first link (e.g. crate keys).

🤖 Discord Bot Integration

• AI Chat Assistant — OpenRouter-backed AI scoped to your server's topics
• AI Image Generation & TTS — Optional community engagement modules
• Webhooks — Real-time alerts for reports, moderation actions, tier test results
• Channel Routing — Separate channels for tier tests, screenshare, chat codes, announcements, pre-registration, link logs, and live chat relay
• Rank Roles & Daily Rewards — Auto role assignment tied to in-game rank
• Server Status & !ip Embeds — Live status embeds with online staff highlighted
• Protected/Owner IDs — Lock down critical bot commands

All Discord behavior is fully configurable through discord.yml.

⚙️ Performance & Optimization Tools

/sm optimizer and /sm redstone — Built-in lag/performance commands, rate-limited with a bypass permission for trusted staff.

🔐 Permissions

All permissions default to OP only unless noted otherwise.

📦 Requirements

• Paper/Spigot 1.21+
• KervsCore (required)
• LuckPerms (optional, enables Discord rank sync)
• A Discord bot token (for Discord integration features)

✨ Why StaffModeration?

One plugin replaces a punishment plugin, a staff-tools plugin, a report plugin, an anti-cheat trap system, a tier-testing plugin, and a Discord bot — all sharing one config, one database, and one consistent staff experience. Built for active SMP communities that need professional-grade moderation without juggling ten separate plugins.