GuardianShield vV5-5.1.2

GuardianShield​

Advanced AntiCheat System with 110+ cheat detections, live violation feed, web dashboard, evidence/replay system, webhook notifications, and adaptive TPS throttling — by kemgen01

Click to expand...

​

​

Feature Summary​

---

108 Detections — Categories​

Combat (20+)​

KillAura, Reach, MultiAura, Criticals, AutoClicker, TriggerBot, AutoProjectile, FastBow, NoSwing, Velocity, AntiKnockback, BoatFly/Elytra exploits, HitBox, FastBreak, NoHit, FastHeal...

Movement (25+)​

Speed, Fly, NoFall, Jesus (water walk), Spider (wall climb), Step, Phase, Glide, Jump, Scaffold, Timer, AirJump, BlinkTP, Strafe, Flight A/B/C, Elytra hacks...

Mining (15+)​

X-Ray (ore detection), Nuker, AutoMine, FastBreak, InstaBreak, IllegalBreak, FastDrop, LiquidBreak, TunnelMiner...

Player (20+)​

AutoTool, InventorySpoof, ChestStealer, SkinBlinker, NameTag, Derp, AutoArmor, AntiPotion, AntiFire, AntiDrown, InstantEat, FastEat, MorePackets, BadPackets, Sneak exploits...

World (15+)​

AutoFish, AutoFarm, Ghost block, Liquid exploits, Door glitch, Piston exploit, Redstone exploit, Chunk glitching...

Exploit (13+)​

CrashExploit, PacketExploit, IllegalItems, IllegalEnchant, OverstackedItems, InvalidStack, NameExploit, ChatExploit, CommandExploit, InvalidName, InvalidSkin, BooksExploit, EndPortal...

---

Continuous Recording — Nothing Else Has This​

GuardianShield's killer feature: every player is being recorded in the background, all the time. When someone cheats, the moment is already captured — up to 100 frames of pre-event footage. Multi-camera support lets you view the incident from every nearby player's perspective.

Why it matters:

• When a reviewer says "show me the cheating", you click and play it back
• Ban appeals? You have visual proof
• ProtocolLib-backed pure packet-level replay, frame-accurate

• Evidence Format (Cheats-Log)​

  Every violation spawns three files:
  
  plugins/GuardianShield/cheats-log/
  ├── EVD-1776192363-2-PLAYER.json ← Full incident struct
  ├── EVD-1776192363-2-PLAYER.sha256 ← Cryptographic signature
  └── EVD-1776192363-2-PLAYER.txt ← Human-readable summary
• 
  

• Staff Notifications — Instant Alerts​

  The moment a player exhibits suspicious behavior, every online staff member with guardianshield.notifygets:
  • A chat message: GS » Player failed KillAura [HIGH] [VL: 4]
  • A sound cue (VL 2+)
  • An action bar warning (VL 3+)
  • /gs toggle to opt out of their own notifications
  • /gs targets add <player> to focus only on specific players
  Built-in cooldown prevents notification spam from a single offender.

• Automatic Punishment Ladder​

  Violation Level drives automatic escalation:
  
  VL 1-2 → Warning (chat message)
  VL 3-5 → Kick
  VL 6-10 → Temp ban (1h)
  VL 11+ → Permanent ban
  
  
  Every threshold is configurable in config.yml. Don't like the defaults? Write your own.
  
  

  ---

  Ban Wave System​

  Instead of banning suspects immediately, queue theminto a Ban Wave. Run /gs banwave execute on the weekend / at a specific time and ban them all at once. Advantages:
  • Cheaters can't reverse-engineer your detection — they don't know which action triggered them
  • Shadow-ban style: cheater keeps playing, you keep recording, then everyone drops at once
  • Automatic mode: /gs banwave auto auto-queues anyone above a VL threshold

  ---

  Leaderboard + PlaceholderAPI​

  /gs leaderboard → browse your all-time top offenders in a GUI.
  PlaceholderAPI integration:
  • %guardianshield_top1_name%
  • %guardianshield_top1_violations%
  • %guardianshield_player_vl%
  ...and more. Plug them into scoreboards, tab lists, holograms — whatever you want.

With this GUI I added, you can now make all settings from here, which allows you to do it without having to deal with individual commands.

Installation​

1. Download the GuardianShield.jar file
2. Place in your server's plugins/ folder
3. Restart the server
4. Configure config.yml to your needs

Commands​

---

Permissions​

​

Configuration​

All settings can be configured in config.yml:

• Per-check thresholds and max violation levels
• Punishment escalation rules
• Notification channels (action bar, chat, title)
• Recording/replay parameters
• Discord webhook URL
• Ban wave configuration
• Leaderboard settings

Requirements​

• Spigot 1.20+ or Paper 1.20+
• Java 21
• (Optional) ProtocolLib — For advanced packet-level capture

Installation — 30 Seconds​

1. Drop GuardianShield-X.X.X.jar into your plugins/ folder
2. (Optional but recommended) Install ProtocolLib for full replay support
3. Restart the server
4. Run /gs to open the GUI — everything is managed from there

Requirements:

• Paper 1.21.x (NOT Spigot — uses Paper API)
• Java 21
• (Optional) ProtocolLib — for advanced replay
• (Optional) PlaceholderAPI — for leaderboard placeholders

---

Why GuardianShield Beats the Alternatives​

• Matrix / AAC / Vulcan: Expensive, painful to set up, config hell. GuardianShield → works out of the box.
• NoCheatPlus: Old, unmaintained, weak on 1.21. GuardianShield → native 1.21.4 support.
• Grim / Intave: Movement-only. GuardianShield → 6 categories, 108 checks, full evidence system.
• Free alternatives: No evidence system, no Discord, no replay, no SQLite. GuardianShield → everything included.

---

Bonus Features​

• bStats metrics — usage statistics
• Spark profiler compatible — performance analysis
• TPS-aware — checks downgrade under server lag
• Async processing — zero main thread load
• MySQL support coming in v3.3
• HTML admin panel — view violation history via web

---

FAQ​

Q: My cheater is lagging — false positives?
A: No. The plugin is ping-aware — thresholds automatically relax for high-ping players.

Q: I'm on 1.20.x, does it work?
A: Currently 1.21.x only. Backports available on request.

Q: Will it run on Spigot?
A: No. Uses Paper API. Paper/Purpur/Pufferfish only.

Q: Is the source code included?
A: No. Proprietary license, obfuscated JAR.

Q: Is the Discord webhook required?
A: No. Disable it in config, you'll still get in-game alerts.

Q: Does it work on offline/cracked servers?
A: Yes, offline-mode is fully supported.

---

Get It Now​

Version: 3.2.1 (latest)
Compatible: Paper 1.21.x
License: Per-server / Network
Author: kemgen01
Support: Discord + Ticket system

PROMOTIONAL WEBSITE:
https://guardianshields.kemgen01.workers.dev

Author​

kemgen01 — BuiltByBit

License​

This plugin is proprietary software by kemgen01. Redistribution is prohibited.View attachment 1288774