Sheriff Tools

🤠 Sheriff — Modern Moderation Tools

Last version is v0.9.1, not all functions ready. Release coming soon!

Platform: Paper / Purpur 1.21.1+ (Java 21)

Dependencies: None (optional: LuckPerms for permissions)_

📖 About

Sheriff is a lightweight, all-in-one moderation plugin for Paper servers. It replaces the messy stack of 3–5 outdated plugins with a single, modern tool — clean GUI, smart freeze system, and a built-in report manager.

No bloat. No lag. Just the tools your staff actually needs.

⚠️ Beta Notice

This is the first public build. The core moderation features are stable and ready to use, but some advanced features are still in development:
Reports are stored in memory only — wiped on server restart.

No full GUI for managing reports yet (only a counter).

No inventory history / rollback.

No cross-server sync (Redis / MySQL).

If you need a production-ready solution with persistent reports right now, this version is not for you — wait for v1.0.0.

✨ Features

🕵️ Staff Mode

One-command toggle (/staffmode) for invisible observation.

Staff automatically return to normal mode on logout — no stuck states.

Clean integration with the Sheriff Menu.

❄️ Freeze System

Freeze any player with /freeze or via the GUI.

Frozen players cannot move, chat, or use most commands.

Private messages (/msg, /r) remain allowed by default — configurable.

Perfect for catching cheaters or calming down rule-breakers.

🚨 Report Manager

Players submit reports with /report .

Configurable minimum reason length and per-player cooldown (anti-spam).

Reports are visible to staff through the Sheriff Menu.

(Full GUI for managing reports coming in the next update.)

🖥️ Sheriff Menu (/sheriff)

Central hub for all moderation tools.

Staff Mode button — toggle invisibility.

Freeze Player button — opens a player picker with real player heads.

Reports button — shows current report count.

Built on InventoryHolder for reliable, lag-free click handling.

⚙️ Configurable

Everything lives in a clean, commented config.yml.

Control freeze behavior, report cooldowns, and Staff Mode settings.

🔐 Permissions

sheriff.staff — Access to /sheriff menu
sheriff.staffmode — Toggle Staff Mode
sheriff.freeze — Freeze and unfreeze players
sheriff.report — Submit reports (default: true for all)