AtomGuard

# Announcament!: **Project Will Not Get Any Updates** <div align="center"> <img src="https://r.resimlink.com/pTtW512LDN9.png" alt="AtomGuard" width="180"> # AtomGuard ### Keep your Minecraft server safe from hackers, bots, and crashes. **Works with Paper 1.21.4 and Velocity 3.x** <br> (https://img.shields.io/github/actions/workflow/status/ATOMGAMERAGA/AtomGuard/build.yml?branch=main&style=for-the-badge&logo=github&logoColor=white&label=Build&color=22c55e)](https://github.com/ATOMGAMERAGA/AtomGuard/actions) (https://img.shields.io/github/v/release/ATOMGAMERAGA/AtomGuard?style=for-the-badge&color=00C7B7&label=Release)](https://github.com/ATOMGAMERAGA/AtomGuard/releases) (https://img.shields.io/badge/Java-21-ED8B00?style=for-the-badge&logo=openjdk&logoColor=white)](https://adoptium.net) (https://img.shields.io/badge/License-BSD--3-4A90D9?style=for-the-badge)](https://github.com/ATOMGAMERAGA/AtomGuard/blob/main/LICENSE) <br> > **AtomGuard is a free, open-source security plugin that protects your Minecraft server from attacks, exploits, and cheaters — so you can focus on building your community.** <br> (https://github.com/ATOMGAMERAGA/AtomGuard/releases) · (#-getting-started) · (#-faq) · (https://github.com/ATOMGAMERAGA/AtomGuard/blob/main/CONTRIBUTING.md) </div> <br> --- ## 💡 Why AtomGuard? Running a Minecraft server is fun — until someone tries to ruin it. Bot attacks that flood your server with fake players, exploits that crash everyone out, duplication glitches that destroy your economy… the list goes on. AtomGuard handles all of that for you. Just drop it in your plugins folder and your server is protected. No complicated setup, no networking degree required. ### Here's what it protects you from: 🛡️ **Bot & DDoS Attacks** — Automatically detects and blocks waves of fake players and connection floods before they slow your server down. 🚫 **VPN & Proxy Abuse** — Stops banned players from rejoining on a VPN. Uses 7 different detection methods for accuracy, and won't accidentally block your real players. 🔧 **Crash Exploits** — Fixes 44+ known Minecraft exploits that hackers use to crash servers, including book crashes, NBT attacks, and packet exploits. ♊ **Duplication Glitches** — Prevents item duplication bugs that can wreck your server's economy. ⚡ **Lag Machines** — Limits redstone, explosions, pistons, and entities so players can't build devices that lag your server. 🌍 **Country Filtering** — Allow or block players from specific countries if you want a region-locked community. 🔐 **Login Protection** — Blocks brute-force password attacks and prevents the use of common passwords (works with AuthMe). --- ## ✨ Feature Highlights ### 🤖 Smart Bot Detection AtomGuard doesn't just look at one thing — it scores each connecting player across **8 different signals** like connection speed, client type, join pattern, and username. Players that score low enough get through instantly. Suspicious ones get a quick math challenge. Obvious bots get blocked. Your regular players won't even notice it's running. ### ⚔️ Adaptive DDoS Protection The **SmartThrottle Engine** automatically adjusts its defenses based on how bad an attack is: <div align="center"> `🟢 Normal` → `🟡 Elevated` → `🟠 High` → `🔴 Critical` → `⛔ Lockdown` </div> During a serious attack, it locks down new connections while making sure your verified players can still get in. Once the attack stops, everything goes back to normal automatically. ### 🧠 Threat Intelligence AtomGuard learns your server's normal traffic patterns over 7 days. When something unusual happens — like a sudden spike in connections at 3 AM — it automatically ramps up protection. This means fewer false alarms and faster response to real threats. ### 🏅 Player Trust Score The more a player plays on your server without causing trouble, the more AtomGuard trusts them. Veteran players skip most checks entirely, which means faster logins for your loyal community and stricter checks for newcomers. | Tier | Who | What Happens | |:---|:---|:---| | 🆕 **New** | Just joined | Full security checks | | 📅 **Regular** | Been around a while | Standard checks | | ✅ **Trusted** | Clean track record | Skips attack-mode checks | | ⭐ **Veteran** | Long-time player | Skips bot & VPN checks too | ### 🍯 Honeypot AtomGuard can run a fake Minecraft server on a different port. When bot scanners find it and try to connect, their IP gets instantly banned from your real server. It's like a trap for attackers. ### 🔬 Attack Reports After every attack, AtomGuard saves a detailed report — what happened, when, how many IPs were blocked, and which defenses did the work. You can review these anytime to understand what your server faced. --- ## 📦 What You'll Need | What | Version | Required? | |:---|:---:|:---| | ☕ Java | 21 or newer | ✅ Yes | | 📄 Paper server (o