Global Blacklist

🛡️ 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.