Aegis AntiXray
Packet-level anti-xray, anti-freecam and anti-ESP
1.16 → 1.21.x • Spigot & Paper • Java 8+ • No dependencies • Free
A client cannot exploit information it was never sent.
Aegis doesn't detect cheat clients, doesn't need a client mod and doesn't need a resource pack. It
rewrites what leaves the server, so the exploit has nothing to read.
Four modules, each switched on independently:
- ⛏ Chunk obfuscation — ores, spawners and vaults are replaced before the packet is encoded. Fake ore is deterministic (a re-sent chunk is byte-identical, so it can't be diffed) and only placed where nobody can look.
- Proximity hider — a block is only sent when it's close, exposed, and actually in the player's line of sight. Cave-wall ores stop being free loot.
- Anti-freecam — caves are filled with rock before the chunk is sent and revealed as you walk into them. Freecam never moves the player, so the server is never asked to reveal anything: the camera just flies through solid rock.
- Anti-ESP — entities and containers you can't see aren't sent to you. Kills tracers, nametag ESP and chest ESP, using Bukkit's per-plugin hide/show so it never fights your vanish plugin.
Plus behavioural detection (ore ratio, sealed hits, aimed tunnels → 0–100 score, alerts,
console actions, optional Discord webhook) for the side channels no packet filter can reach.
⚙ At a glance
- Versions: 1.16 → 1.21.x, Spigot and Paper, Java 8+
- Dependencies: none — PacketEvents is shaded and relocated inside the jar
- Performance: chunk rewriting runs on the Netty thread, off the main thread. Every reveal pass is budgeted. /aegis stats gives live per-chunk timings on your own hardware
- Config: one file for a whole network — blocks that don't exist on the running version are skipped, not errors
- Messages: everything in messages.yml, hex colour support, nothing hardcoded
Commands
/aegis reload reload config.yml and messages.yml
/aegis stats module state, counters and per-chunk cost
/aegis world [name] effective settings for a world
/aegis check <player> mining profile and suspicion score
/aegis alerts toggle x-ray alerts for yourself
/aegis reset [player] clear profiles and counters[/CODE]
Aliases [ICODE]/antixray, /agx. Permissions: aegis.admin,
aegis.check, aegis.alerts, aegis.bypass,
aegis.bypass.detection.
aegis.bypass does not default to op — an operator who also plays would
otherwise have permanent x-ray. Grant it explicitly.
⚠ Known limits — read before enabling everything
I'd rather you know these up front than find them on a live server.
- Anti-freecam is visible at distance — cave mouths read as solid ground until you approach. That artifact is inherent to hiding caves, which is why the module is opt-in.
- Anti-ESP affects gameplay — off by default. Test PvP before tightening radii, and note that on 1.16/1.17 only players can be hidden (hideEntity arrived in 1.18).
- Detection is a score, not proof — calibrate it against your world gen before wiring automatic punishment.
- Light data is not obfuscated, and Folia is not supported in this release.
- Drop the jar into plugins/ and start the server.
- Grant aegis.bypass to builders and staff.
- Enable the extra modules under modules: when you're ready — obfuscation and detection are on out of the box, anti-freecam and anti-ESP are opt-in.
Free, and staying free.
Found a bug or a false positive? Post it with your server version and the relevant config section —
that gets fixed far faster than a one-star review. 1.8 support is planned.
Aegis AntiXray is a free Minecraft Java mod. Compatible with Minecraft 1.16, 1.17, 1.18, 1.19 and newer. Downloaded 4 times (via Spigot). Download it and open it directly in the game.