StaffModeration v1.6.0

Premium All-in-One Moderation & Staff Management Suite

by KervsDev

---

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.

---

🕵️ 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.

Permission	Description
staffmod.admin	Full admin access
staffmod.ban / .tempban / .banip / .unban / .unbanip	Ban management
staffmod.mute / .tempmute / .unmute	Mute management
staffmod.kick / .freeze / .freezechat / .vanish / .invsee / .ss	Staff tools
staffmod.chat	Staff chat access
staffmod.bypass	Bypass freeze/mute restrictions
staffmod.freezechat.bypass	Talk during frozen chat
staffmod.use	Access StaffMod GUI
staffmod.report (default: true)	Submit reports
staffmod.reports.view	View/manage reports
staffmod.tier	Tier testing access
staffmod.link (default: true)	Link Discord
staffmod.unlink (default: true)	Unlink own account
staffmod.unlink.others	Unlink other players
staffmod.syncrank / .syncrank.others / .syncrank.all	Rank sync scopes
staffmod.spawnstash	Place fake stash structures
staffmod.maintenance / .maintenance.bypass	Maintenance control
staffmod.announce / .chatcode	Announcements & chat code events
staffmod.optimizer / .optimizer.bypass	Optimizer access
staffmod.reload	Reload configuration
staffmod.staff	Mark as online staff for Discord

---

📦 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.