✦ Overview

StaffUltimate is a self-contained staff management suite built for servers that have outgrown a pile of separate small plugins. Every sanction, every investigation tool, and every staff convenience lives behind one GUI-driven "Staff Mode" and a clean command set — with full server-side history so nothing your team does ever gets l ost.

✦ Moderation

• Ban / Tempban / Unban — with required reasons, stacked-duration protection (can't double-ban the same player), and unban now also asks for a reason so the history stays complete.
• Mute / Tempmute / Unmute — same reason + history tracking as bans.
• Kick and Warn (with configurable auto-ban / auto-mute on warn limit).
• Confirmation panel before permanent bans — no more "oops, permabanned by misclick." Lets staff pick account-only or account + IP in one screen.
• Sanction cooldown — blocks a staff member from re-banning/re-muting the same player within a few seconds (kills accidental double-clicks).
• Automatic expiry warnings — staff get pinged in chat when a temp ban/mute is about to run out.

✦ Investigation & anti-evasion

• Alt-account detection by shared IP, with live geolocation (city/country) next to every linked account — tells real alts apart from "two people on the same office wifi."
• IP Ban — dedicated command and an option directly inside the sanction builder, with full IP-ban list management.
• Inventory inspection and death history with one-click inventory restore.
• Universal message spy — detects private messages sent through vanilla /msg, /tell, /w, or any other plugin's PM system (EssentialsX, CMI, etc.) without needing its own /msg command.
• Player notes — private staff-only notes per player.
• Full sanction history per player, paginated and searchable from the profile panel.

✦ Staff Mode toolkit

• Freeze with anti-relog/anti-evasion detection and auto-ban on repeated evasion.
• Vanish, Staffchat, ClearChat.
• Spectate mode — completely invisible, removed from the tab list and from everyone's view (not a half-measure spectator gamemode swap).
• Random TP between online players, direct teleport to a target from their profile.
• GUI hotbar in Staff Mode: Players list, Freeze, Sanctions, full Player Panel, Random TP, Vanish, Staffchat, Staff Log.

✦ Reports & Appeals

• /report — players report each other, staff review in a GUI queue.
• /appeal — players appeal their current sanction (auto-detects active mute or last sanction), staff approve/deny from a GUI with one click (approving auto-lifts the sanction).
• Both fully persisted to disk — nothing is lost on restart.
• Anti-flood protection on appeals (length cap + cooldown between submissions).

✦ GUI panel system

• Every action is reachable from both commands and a fully clickable GUI — no memorizing syntax required.
• Player profile panel: health/ping/world/warns at a glance, plus one click to every tool (freeze, spectate, inspect, deaths, alts, messages, sanctions, history, notes).
• Step-by-step sanction builder: pick type → duration → reason, with a live preview before executing.
• Fully reconfigurable via panels.yml — change names, materials, lore, slots, even add your own custom reasons.

✦ Staff accountability

• Staff log — a live feed of every action any staff member takes.
• /staffstats — per-staff counters (bans, mutes, kicks, warns…) to track team activity.

✦ Permissions & roles
Three ready-to-use permission groups, just attach them in LuckPerms / PermissionsEx:

• staffcontrol.role.helper — kick, warn, freeze, inspect, vanish, staffchat, spectate, clearchat, alts, msgspy, reports, appeals review.
• staffcontrol.role.mod — Helper + temp mute/ban, unban/unmute, clear warnings.
• staffcontrol.role.admin — Mod + permanent ban/mute, IP ban, full bypass permissions.
• staffcontrol.* — everything (OP by default).

Every individual action also has its own permission node if you want a fully custom hierarchy. Full list in plugin.yml.

✦ Commands

✦ Why StaffUltimate?

• Replaces 5-6 separate moderation/utility plugins with one cohesive, GUI-first tool.
• Built around preventing mistakes — confirmation screens, cooldowns and reason requirements aren't an afterthought, they're the default.
• Everything persists to disk: bans, mutes, history, notes, reports, appeals, IP bans. Survives restarts.
• Zero external dependencies — drop the jar in and go.
• Actively maintained.