ModsJava
HellGuard AntiCheat / Free, easy to use anti cheat! 1.21.x - 26.2
A lightweight, configurable and multilingual anti-cheat solution for modern Minecraft servers.
⬇ Download on SpigotAbout Plugin;
A lightweight, configurable and multilingual anti-cheat solution for modern Minecraft servers.
HellGuard AntiCheat is designed to detect, block and report common unfair client modifications without forcing server owners to manage an unnecessarily complicated configuration.
It includes movement, combat, mining, placement, inventory, fishing, XRay and container-ESP protection systems. Every check can be configured individually, including alerts, action cancellation, setbacks, player warnings and automatic kicks.
Main Features
- Lightweight event-based architecture
- No mandatory ProtocolLib or PacketEvents dependency
- Turkish and English language support
- In-game administration GUI
- Individual check toggles
- Per-check cancellation and kick settings
- Configurable player warnings
- Recent critical violation history
- Optimized rotating log system
- Paper/Purpur native Anti-Xray integration
- Portable Anti-Xray fallback for other platforms
- Chest ESP container masking
- Balanced and Strict presets
- TPS, ping and legitimate movement compensation
- Java 21 compatible plugin build
- No NMS or CraftBukkit version-specific code
Available Checks
HellGuard currently includes the following detection modules:
Movement
- Fly
- Speed
- Timer
- BoatFly
- Jesus
- Phase
- NoFall
- Optional AntiKnockback
- KillAura
- MultiAura
- Reach
- Aimbot
- TriggerBot
- AutoClicker
- AutoMine
- FastBreak
- Nuker
- FastPlace
- Scaffold
- AutoArmor
- InventoryMove
- AutoFish
- XRay behavior analysis
- Portable ore masking
- Native Paper Anti-Xray configuration
- Chest ESP and container masking
HellGuard does not wait for a second Fly attempt before applying a setback.
Confirmed hovering, sustained illegal upward movement and strong vertical physics violations can immediately return the player to their last safe position.
Legitimate situations such as Creative mode, Spectator mode, allowed flight, Elytra, Levitation, Slow Falling, vehicles, water and recent velocity are compensated.
Balanced Speed Detection
The Speed check considers more than a single movement distance.
It compensates for:
- Sprinting
- Sprint jumping
- Speed potion effects
- Ice and slippery blocks
- Slime blocks
- Knockback and velocity
- Ping
- Server TPS
- Stairs, slabs and other movement surfaces
Automatic Speed kicks are disabled by default and can be enabled by the server administrator.
Combat Analysis
HellGuard uses multiple evidence sources before confirming KillAura or Aimbot behavior.
Possible evidence includes:
- Attacking outside the expected view angle
- Repeated attacks through solid blocks
- Extremely fast target switching
- Attacking multiple entities within an unrealistic interval
- No meaningful rotation between different targets
- Repeated perfect target alignment
- Suspicious swing and attack relationships
- Excessive reach
- Humanly unlikely reaction times
The checks work against both players and mobs.
TriggerBot Detection
The TriggerBot module analyses:
- Reaction time after a target enters the crosshair
- Swing-to-hit ratio
- Miss ratio
- Repeated extremely fast reaction samples
- Attack interval consistency
Scaffold Protection
The Scaffold check analyses:
- Blocks placed directly below the player
- Player movement
- Sneaking state
- View direction
- Placement intervals
- Consecutive bridge placement patterns
FastBreak, AutoMine and Nuker
FastBreak evaluates the expected block-breaking duration using:
- Block type
- Held tool
- Tool properties
- Haste and Mining Fatigue
- Player environment
- Player-specific break speed when supported
Nuker checks the number of unique blocks, affected area, visibility and target switching speed. Normal straight tunnel mining is not considered sufficient evidence by itself.
AutoArmor
AutoArmor detection looks for:
- Multiple armor operations within the same tick
- Extremely short inventory interaction intervals
- Repeated automatic armor replacement
- Suspicious armor switching during combat
AutoFish
The AutoFish module measures:
- Time between the fishing bite and reel-in
- Repeated inhumanly fast reactions
- Extremely fast recasting
- Consistent automated fishing patterns
Anti-Xray Modes
HellGuard is not limited to a single Paper-only Anti-Xray method.
anti-xray:
mode: auto
Available modes:
- auto — Uses native protection when available, otherwise portable masking
- native — Uses the Paper-family Anti-Xray engine only
- portable — Uses HellGuard client-side ore masking
- hybrid — Runs native and portable protection together
- behavior-only — Uses mining behavior analysis without masking
On Paper-based servers, HellGuard can configure the native Anti-Xray system:
/hellguard antixray install balanced
/hellguard antixray install strict
Existing files are backed up before changes are applied.
A full server restart is required after native Anti-Xray configuration changes.
Portable Anti-Xray
On servers without a native Anti-Xray engine, HellGuard can use its portable masking system.
The portable engine:
- Processes already loaded chunks only
- Does not force-load new chunks
- Uses a bounded scan queue
- Masks hidden ores per player
- Restores real blocks when the player approaches
- Does not modify actual world blocks
- Limits block changes per update
- Displays queue and index information in the management GUI
Chest ESP Protection
Minecraft servers cannot reliably read whether a client has enabled Chest ESP. HellGuard addresses this by masking supported containers for individual players.
Supported blocks include:
- Chests
- Trapped chests
- Ender chests
- Barrels
- Shulker boxes
- Spawners
- Trial spawners
- Vaults
Administration GUI
Open the management interface with:
/hellguard gui
The GUI allows administrators to:
- Enable or disable checks
- Toggle action cancellation
- Toggle player warnings
- Toggle automatic kicks
- View recent critical violations
- Inspect online player violation levels
- Clear violation history
- Switch between Balanced and Strict profiles
- View and manage logs
- View the active Anti-Xray provider
- Check scan queue and indexed block statistics
- Install Anti-Xray profiles
hellguard.gui
Per-Check Kick Settings
Each check has its own automatic kick configuration:
checks:
fly:
enabled: true
cancel: true
warn-player: true
kick-enabled: true
kick-vl: 14.0
Commands:
/hellguard kick fly on
/hellguard kick speed off
/hellguard kick killaura on
/hellguard kick scaffold on
Global automatic kicks can be disabled while keeping detection, cancellation, setbacks, alerts and logs active.
actions:
kick-enabled: false
Player Warning System
HellGuard can notify players when suspicious behavior is detected.
/hellguard playerwarnings on
/hellguard playerwarnings off
Player warnings can also be enabled or disabled for individual checks.
checks:
triggerbot:
warn-player: false
Optimized Logging
HellGuard uses a bounded asynchronous logging system instead of creating unlimited log files.
Features include:
- Buffered background writing
- Configurable queue capacity
- Batch processing
- File size and daily rotation
- Optional GZIP compression
- Automatic retention cleanup
- Maximum archive count
- Cleanup on server startup
- Recent violations stored in memory for the GUI
logging:
enabled: true
queue-capacity: 4096
batch-size: 64
flush-interval-seconds: 2
max-file-size-mb: 8
retention-days: 14
max-archives: 30
compress-rotated: true
cleanup-on-start: true
Log commands:
/hellguard logs status
/hellguard logs clean expired
/hellguard logs clean all
Commands
/hellguard help
/hellguard gui
/hellguard alerts
/hellguard status [player]
/hellguard reset <player>
/hellguard exempt <player> <seconds>
/hellguard checks
/hellguard profile balanced
/hellguard profile strict
/hellguard playerwarnings on
/hellguard playerwarnings off
/hellguard kick <check> <on|off>
/hellguard logs status
/hellguard logs clean expired
/hellguard logs clean all
/hellguard antixray status
/hellguard antixray install balanced
/hellguard antixray install strict
/hellguard config regenerate
/hellguard reload
Permissions
hellguard.admin
hellguard.alerts
hellguard.gui
hellguard.bypass
hellguard.containeresp.bypass
Be careful when assigning hellguard.bypass, because it exempts the player from anti-cheat checks.
Installation
- Stop the server completely.
- Place HellGuard-AntiCheat-1.4.0.jar inside the plugins directory.
- Start the server.
- Wait for the configuration and language files to be generated.
- Apply the recommended profile:
- Optionally enable player warnings:
- Paper and Purpur users can install the recommended Anti-Xray profile:
- Restart the server after native Anti-Xray changes.
Compatibility
- Minecraft 1.21.x
- Minecraft 26.2
- Paper
- Purpur
- Spigot
- Compatible modern server forks
- Java 21 plugin bytecode
- No NMS dependency
- No mandatory external plugin dependency
Language Support
Available languages:
- Turkish
- English
language: en
Language files:
plugins/HellGuard/lang/tr.yml
plugins/HellGuard/lang/en.yml
Important Notice
No anti-cheat can honestly guarantee perfect detection against every private client, future bypass or custom server configuration.
HellGuard uses buffers, multiple evidence sources, TPS and ping compensation to reduce false positives. However, server owners should test the plugin with their own PvP, movement, inventory, vehicle and custom gameplay plugins before enabling strict automatic punishments.
Balanced mode is recommended for the initial installation.
IF YOU NEED ANY SUPPORT Click Me.
HellGuard AntiCheat / Free, easy to use anti cheat! 1.21.x - 26.2 is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 56 times (via Spigot). Download it and open it directly in the game.