🛡️ Global Blacklist
A high-performance, ultra-secure cross-server blacklist solution engineered specifically for modern Minecraft networks (1.21.1+). Unlike traditional banning tools that rely on locally stored configuration files or slow flat-file architectures, Global Blacklist bridges your entire network of proxies and backend game servers directly to a centralized MariaDB/MySQL database hosted on cloud infrastructure (like Oracle Cloud Infrastructure). When a bad actor is blacklisted on one server, the restriction instantly propagates across your entire network, keeping your community safe with zero performance impact.
✨ Core Features
- ⚡ Zero Main-Thread Performance Impact: Engineered entirely from the ground up with asynchronous processing. All external database operations and Mojang API connections run off the main game thread, keeping your server's TPS rock-solid.
- 💾 Enterprise-Grade Data Pooling: Powered by an integrated, shaded HikariCP connection manager and a native MariaDB driver. It resolves common utf8mb4 character encoding errors out of the box and features lightning-fast database transaction cycles.
- 🚀 Instant Memory Cache: Keeps active blacklist profiles cached internally within a concurrent thread-safe system map. Player verification queries are executed instantly upon login without hitting the database disk.
- 🛡️ Low-Level Connection Interception: Catches and drops blacklisted players during the AsyncPlayerPreLoginEvent phase before they even join the game, allocate entity memory space, or generate chunk load packets.
- 🆔 Dual-Layer Identity Validation: Matches connections against both unique Mojang account UUIDs and case-insensitive lowercased usernames to catch offline-mode or legacy synchronization anomalies.
⌨️ Commands & Permissions
- /blacklist add [reason]
- Description: Asynchronously queries Mojang's API to fetch the target profile identity, registers the entry to your cloud engine, and forces an immediate server kick.
- Permission Required: blacklist.add
📋 Installation
Drop the compiled BlacklistSpigot-1.0.0.jar into your server's plugins/ directory and restart the server.
