StaffCL 🛡️

StaffCL is the ultimate, all-in-one server moderation suite for Minecraft. Inspired by advanced moderation tools like Staff++, ChatManager, and AdvancedBan, StaffCL combines seamless staff utilities, real-time tracking, comprehensive player inspection, punishments, history management, and advanced chat control into a single, highly optimized plugin.

Designed with performance in mind, all heavy database operations and external API requests run asynchronously to guarantee zero TPS impact and protect your server's performance.

✨ Features

• Advanced Staff Mode (/staff): Toggle staff mode instantly. Safely backs up your personal inventory, turns you invisible to regular players (other staff can still see you), equips core moderation tools, and restores your inventory upon exit.
• Interactive Freeze System: Freeze suspicious players using the "Freeze" ice block (supports left/right click). Frozen players are restricted from movement, blocked from global chat, and automatically banned if they disconnect to evade screen share (SS). Includes configurable admin bypass permissions.
• Staff Interaction Mode: A toggleable item allowing staff to interact with the world (break/place blocks, hit entities, and pick up dropped items) while maintaining vanish. Disabling it cleanly resets the staff tool inventory without touching personal gear.
• Player Following & Transport: Easily follow players (riding on top until you sneak) or teleport to random players in need of review.
• Comprehensive Player Reports & Inspection (/reports): Players can report others with a 1-minute cooldown per report. Staff can access an intuitive GUI listing all reports, complete with deep player data: Geo-location (IP), first join date, total playtime, detected client type (Lunar Client, Badlion, TLauncher, etc.), alts, and full history of past punishments.
• Detailed Punishment History & Management: Click any punishment counter in the player info menu to review a complete summary (Reason, Duration, Date, Staff member, Status). Includes administrative commands to clear specific punishments or entire player histories (/staffcl clear history).
• Menu-Driven Punishments & Layouts: Streamlined workflow from reports to punishments (Tempban, Ban, IP-Ban, Mute, Warn, Kick) with pre-set durations. Generates unique 8-character ban IDs with professional, customizable full-screen display layouts via layouts.yml.
• Smart Reporting Actions: Claiming a report notifies the reporting player instantly. Staff can also use quick-action messaging tools (/msg) to communicate directly with reporting players.
• Chat Management & Integration: Built-in chat control commands including /clearchat, /mutechat, /slowmode, and anti-spam filters. Seamlessly integrated with ClanCL so clan chat channels remain active during global mutes.
• Fault-Tolerant & Modular: Built-in support for SQLite/MySQL, multi-language localization (lan/en.yml and lan/es.yml), and fine-grained feature toggles in config.yml.

💻 Commands & Permissions

Staff & Admin Commands (/staff / /admin)

• /staff — Toggle staff mode (inventory backup/restore). Perm: staffcl.admin.staff
• /clearchat — Clear the global chat feed. Perm: staffcl.admin.clearchat
• /mutechat — Toggle global chat lock (exempts ClanCL). Perm: staffcl.admin.mutechat
• /reports — Open the active player reports GUI. Perm: staffcl.admin.reports
• /reports clear [player] — Clear all reports or reports for a specific player. Perm: staffcl.admin.clear
• /ban <player> <reason> — Permanently ban a player. Perm: staffcl.admin.ban
• /ipban <player|ip> <reason> — Permanently ban a player by IP. Perm: staffcl.admin.ipban
• /tempban <player> <time> <reason> — Temporarily ban a player (e.g., 30m, 1d, 1w). Perm: staffcl.admin.tempban
• /mute <player> <time> — Temporarily mute a player. Perm: staffcl.admin.mute
• /warn <player> <reason> — Issue a warning to a player. Perm: staffcl.admin.warn
• /kick <player> <reason> — Kick a player from the server. Perm: staffcl.admin.kick
• /freeze <player> — Freeze or unfreeze a player. Perm: staffcl.admin.freeze
• /vanish — Toggle staff invisibility. Perm: staffcl.admin.vanish
• /history <player> — View a player's complete punishment history. Perm: staffcl.admin.history
• /staffcl clear history <player> [type] [num] — Clear a player's full history or a specific punishment entry. Perm: staffcl.admin.clear
• /alts <player> — Find accounts sharing the same IP address. Perm: staffcl.admin.alts
• /staffcl reload — Reload configuration and language files. Perm: staffcl.admin.reload

Player Commands

• /report <player> — Open the report menu to report a player for hacks, toxic behavior, spam, etc.

Admin Permissions

• staffcl.admin.* — Grants full administrative access to all staff and moderation commands.
• staffcl.staff — Base staff permission required to execute staff commands.

📥 Installation

1. Download StaffCL.jar and place it in your server's plugins/ directory.
2. Start your server to generate the default configuration (config.yml), layouts (layouts.yml), and language files (lan/en.yml, lan/es.yml).
3. Configure your database settings, warning actions, feature toggles, and permissions, then reload or restart your server!