AntiChunkBanGuard
- By
Its a plugin that dedects items that can ChunkBan players and automaticly delets them.
AntiChunkBanGuard
Inventory protection and offline recovery for Paper servers — designed to preserve legitimate items.
AntiChunkBanGuard detects item data that violates verified network limits on its supported server build. It helps prevent item-related inventory and login problems while avoiding blanket deletion rules for books or shulker boxes.
Features
-
Verified detection: Uses Minecraft’s actual packet codecs and registry context, rather than book counts, character counts, or saved item size alone.
-
Targeted removal: Backs up confirmed unsafe items to an external quarantine before removing the affected inventory entry.
-
Offline recovery: Inspect and repair saved player inventories without requiring the player to join.
-
Equipment coverage: Checks relevant armor, offhand items, ender chests, cursor items, and nested item components.
-
Packet protection: Checks relevant outgoing item packets before transmission.
-
Lossless inventory synchronization: Uses verified slot splitting when large inventories can be transmitted safely without removing items.
-
Dry-run support: Preview repairs before changing saved player data.
-
Safe restoration: Rechecks quarantined items and destination inventories, prevents occupied-slot overwrites, and blocks duplicate restoration.
-
Administrative tools: Includes progress reporting, cancellable offline scans, permissions, and diagnostic logging.
Legitimate items come first
Normal books, Unicode text, and ordinary shulker boxes are not removed merely because they contain substantial data.
Uncertain results and analysis errors do not authorize automatic removal. By default, unverifiable transmissions are held back while the original items remain intact.
The plugin does not automatically ban or punish item owners.
Compatibility
Supported and tested:
-
Paper 1.21.8, build 60
-
Java 21
Other Paper builds, Minecraft versions, Purpur, Spigot, Folia, proxies, protocol translators, and external inventory-management plugins are not approved as tested combinations.
Getting started
-
Stop your server and back up its data.
-
Place the plugin JAR in your
pluginsfolder. -
Start the supported Paper build and run
/cbg status.
Offline repairs and restorations require maintenance mode enabled before a full server restart. Maintenance mode temporarily rejects all player logins to prevent conflicting access to saved inventories.
Main commands
-
/cbg status -
/cbg inspect <player or UUID> -
/cbg scan online -
/cbg scan offline <UUID or all> -
/cbg repair <player or UUID> --dry-run -
/cbg repair <player or UUID> -
/cbg quarantine list -
/cbg restore <ID> --dry-run -
/cbg restore <ID> -
/cbg reload
Administrative permissions default to operators. The included README documents permissions, configuration, aggregate repair options, and recovery procedures.
Scope
AntiChunkBanGuard focuses on item-related inventory and login problems. It does not repair arbitrary chunks, block entities, world containers, or corrupted world files.
The download includes a German configuration and README, full source code, reproducible build files, and a test report documenting verified behavior and remaining limitations.
AntiChunkBanGuard Team
