Staff+

!(https://cdn.modrinth.com/data/cached_images/32b79bdcbe3a506acc52309505cfc6ccde908849.png) # Staff+

Staff+ is an enterprise-grade, high-performance moderation and utility plugin built for modern Minecraft networks. It ships as two platform-specific JARs — one for Paper/Purpur/Folia backend servers and one for Velocity proxies — sharing a unified core engine for consistent punishment management across your entire network.

Paper Edition runs on Paper/Purpur/Folia 1. 20–1. 21+ servers with full Folia multi-threaded region safety, and includes advanced staff tools like vanish, inventory inspection, and spectator monitoring.

Velocity Edition runs on Velocity 3. 3. 0+ proxies and enforces bans, IP-bans, and mutes at the network gateway before players even reach a backend server.

Both editions share the same database, configs, and migration system — deploy one or both depending on your setup.

## Platform Comparison

| Feature | Paper (Paper/Purpur/Folia) | Velocity (Proxy) | | :--- | :---: | :---: | | Ban / TempBan / Unban | ✅ | ✅ | | IP-Ban / TempIP-Ban / UnIP-Ban | ✅ | ✅ | | Mute / TempMute / Unmute | ✅ | ✅ | | Warn / Warns / Clear | ✅ | ✅ | | History / StaffHistory | ✅ | ✅ | | Staff Rollback | ✅ | ✅ | | IP-Ban Exemption (`/staffallow`) | ✅ | ✅ | | Punishment Migration (`/staffimport`) | ✅ | ✅ | | Discord Webhook Logging | ✅ | ✅ | | Warning Escalation Ladder | ✅ | ✅ | | Hierarchy Protection | ✅ | ✅ | | Alt-Detection (IP Matching) | ✅ | ✅ | | SQLite / MySQL Storage | ✅ | ✅ | | Vanish System | ✅ | ❌ | | Spectator Monitor/Follow | ✅ | ❌ | | Inventory Inspector (`/invsee`) | ✅ | ❌ | | Gamemode Shortcuts | ✅ | ❌ | | Flight Toggle (`/fly`) | ✅ | ❌ | | bStats Metrics | ✅ | ✅ | | Folia Scheduler Safety | ✅ | N/A | | Proxy-Level Ban Enforcement | ❌ | ✅ |

## Features

### Cross-Platform Core Shared Database: Both Paper and Velocity editions read and write to the same punishment database (SQLite or MySQL), enabling seamless network-wide moderation. Shared Configs: `config.yml` and `messages.yml` use identical formats on both platforms via the Okaeri configuration framework. Unified Migration Engine: Import punishments from 7+ plugins on either platform.

### Folia Safety (Paper Edition) Asynchronous Lifecycles: All commands, database transactions, and packet actions run on Folia-compliant regional or asynchronous schedulers. Folia Teleportation Safety: Standard teleports are replaced with safe, non-blocking `teleportAsync` futures, completely preventing thread crashes. Isolated Packet Loops: Visually toggling features (like Vanish hide/show packets) are scheduled on each recipient's specific regional thread, guaranteeing thread-safety.

### Proxy Gateway Enforcement (Velocity Edition) Pre-Login Ban Check: Intercepts login attempts at the proxy level and rejects banned players before they reach any backend server. Network-Wide Mute Filter: Blocks chat messages from muted players across all connected servers. IP-Ban Gateway: Enforces IP bans at the proxy gateway, preventing banned IPs from connecting to any server in the network.

### Vanish (Paper Only) Total Invisibility: Completely removes the player from the online count, player ping lists, tab completions, and visible lists. Physical Interaction Bypass: Vanished staff bypass physical pressure plates and tripwire triggers entirely. Silent Containers: Allows opening chest, furnace, and barrel interfaces silently without triggering container animations or audio. Stealth Suppression: Prevents mob targeting, item pickups, and suppresses join/quit messages entirely while active. Visual Action Bar Indicator: Real-time HUD showing vanished status via safe asynchronous repeating tasks.

### Moderation (Both Platforms) Comprehensive Actions: Integrated `/ban`, `/tempban`, `/ip-ban`, `/tempip-ban`, `/mute`, `/tempmute`, and `/warn`. Warning Profiles: Track individual warning logs via `/warns `. Dynamic Time Parsing: Sophisticated time parser supporting complex units (e.g. `1d`, `12h`, `45m`) and infinite duration mappings (`perm`). Relational Storage: Backed by a high-performance database manager supporting both local SQLite databases and remote MySQL servers, managed via a shaded, thread-safe HikariCP connection pool. Linked Account Alt-Detection: On player login, automatically scans, logs, and broadcasts alternate accounts sharing the IP address, color-coding active (green) and banned (red) profiles. Dynamic Command & History Parity: Multi-threaded `/history `, `/staffhistory `, and `/staffrollback ` commands supported by dynamic database-backed name tab completions. Warning Escalation Ladder: Scale punishments dynamically (e.g. tempmutes scaling to permanent bans) based on active warning levels. Command dispatches execute safely on each platform's native scheduler. **No