Tired of script kiddies crashing your server? 😤 Worried about new exploits dropping every day? 😰
Look no further! Matcha AntiCrash is the most lightweight, robust, and aggressively optimized protection layer designed strictly for modern and legacy Minecraft servers! 🚀 Let your players enjoy a buttery-smooth experience while we silently annihilate malicious packets in the background. 🥷✨
Unlike heavy, bloated anti-cheats that falsely kick your players, Matcha operates entirely at the protocol layer (via packetevents). 🛡️
We intercept, parse, and filter the raw network stream before it even tickles the main server thread! ⚡ This means ZERO lag, ZERO TPS drops, and MAXIMUM security. 🧠🔥
- 🌊 Ruthless Flood Control: Annihilates high-speed animation, movement, window clicks, block placement, and chat floods. Don't let them overflow your server! 🛑
- 📦 Strict Netty & Protocol Validation: Iron-clad enforcement over channel payload sizes, raw byte limits, and valid compound lengths strictly mapped to every Minecraft version. 📏
- 🎒 Impenetrable Inventory & Item Security: Blocks malicious oversized books 📖, illegal maximum NBT parsing depths 🤯, overpowered enchantments ✨, and bad translation strings!
- 🎨 Creative Exploit Prevention: Hardened, deep packet checks meticulously designed to patch devastating vulnerabilities inside creative mode inventory handling. 🔨
- 🌍 World Interaction Firewalls: Limits interact frequencies and filters out illegal cursor data and sign content. If it shouldn't be clicked that fast, it won't be. ⏱️
- 🗺️ Out-Of-Bounds Position Checks: Teleport hacks crashing the map? Not anymore! Detects and drops position packets containing coordinate data outside of the playable world bounds instantly! ⛔
- 💬 Chat & Tab Filter: Restricts potentially dangerous plugin commands (e.g.,
//calc,/pex) and illegal tab-completion strings. Keep your exploits out of my chat! 🗣️🚫 - 🚨 Next-Gen Alert System: Admins receive gorgeous, interactive chat alerts! Hover for deep analytics, violation counts, real-time ping data, and pinpoint check information! 📊✨
Stay in absolute control with dead-simple commands and granular permissions! 👑
| Command | Aliases | Description | Permission |
|---|---|---|---|
🛠️ /matcha-anticrash |
/mac, /manticrash |
Access the main administrative command for Matcha. | matcha.admin |
| Permission | Default | Description |
|---|---|---|
matcha.admin 👑 |
OP | Grants god-tier access to Matcha AntiCrash commands. |
matcha.alerts 🔔 |
OP | Receive the in-game click/hover interactive violation alerts. |
matcha.bypass 👻 |
False | Base permission to bypass all core Matcha AntiCrash checks. |
matcha.bypass.* 🌟 |
False | Absolute wildcard permission to bypass everything. |
matcha.bypass.<check>🎯 |
False | Bypass a specific check (e.g., matcha.bypass.flooda). |
💡 Pro Tip: Bypass permissions can be customized for each specific check right in the
config.ymlunderchecks.<CheckName>.bypass-permission!
We believe you should have the final say. Matcha generates a beautifully organized config.yml on the first launch. You can freely tweak:
- 🥊 Punishments: Decide your kick thresholds (
settings.kick-threshold), paint your own custom kick messages, and choose whether a check shouldcancel-packet, strictlylog, or aggressivelykickthe attacker. 🥾 - 📢 Alert System: Keep your chat clean! Limit alert spam via
max-alerts-before-suppressand enforce analert-cooldown. Toggle console logging as needed. 🖥️ - ⏱️ Strict Throttling: Configure ultra-precise rate limits and maximum packet sizes tailored perfectly to your specific Minecraft version's needs.
- 📜 Blacklists: Add illegal commands, dangerous tab-completion strings, or forbidden NBT data into powerful custom filter lists.
Ready to bulletproof your server? Make sure you have the basics down:
- ☕ Java: Java 8 (if you are planning to use it on 1.7+) or higher (Java 17+ recommended for ultimate performance!)
- 🗄️ Server: Spigot, Paper, Purpur, or any valid fork API.
- 🎯 Versions: Rock solid from 1.8.x right up to 1.21.x+!
- 📦 Soft Depends:
ProtocolLib,ProtocolSupport,ViaVersion,ViaBackwards,ViaRewind,Geyser-Spigot
Are you a developer? Love seeing the magic happen? Build it yourself! Matcha uses Maven for flawless dependency management and compilation.
# 1️⃣ Clone the repository like a boss
git clone https://github.com/MatchaMinecraft/Matcha-AntiCrash
# 2️⃣ Dive into the directory
cd Matcha-AntiCrash
# 3️⃣ Build the ultimate shield
mvn clean packageBoom! 💥 Your compiled JAR file is waiting inside the target/ directory. Drop it into your server's plugins/ folder, reboot, and relax knowing your server is impenetrable! 🏰
- 🍵 Author: [notserpishere] — Engineering the future of Minecraft security.