AdvancementGuard
A lightweight and highly configurable Paper plugin that prevents players from accessing restricted game progression by automatically detecting and punishing forbidden advancements.
Features
✔ Instant detection of forbidden advancements
✔ Automatic temporary bans
✔ Configurable ban duration
✔ Persistent ban storage
✔ Automatic unban after expiration
✔ Staff and console logging
✔ Configurable advancement blacklist
✔ Lightweight and optimized
✔ No database required
✔ Modern Paper support
Default Protected Advancements
AdvancementGuard comes configured to detect:
- Hidden in the Depths (
minecraft:nether/obtain_ancient_debris) - The End? (
minecraft:end/root)
When a player completes one of these advancements, the plugin instantly issues a temporary 30-day ban and prevents rejoining until the punishment expires.
Why Use AdvancementGuard?
Perfect for:
- Custom SMPs
- Hardcore Servers
- Challenge Servers
- Progression-Locked Worlds
- Lifesteal Networks
- Unique Server Concepts
If your server restricts Netherite, The End, or specific stages of progression, AdvancementGuard provides an automatic and reliable enforcement system.
Commands
Admin Commands
/ag reload
- Reloads plugin configuration and ban data.
Permissions
advancementguard.admin
- Access to administrative commands.
Configuration Example
ban-duration-days: 30
broadcast-enabled: true
broadcast-message: "&c%player% was banned for obtaining a forbidden advancement."
forbidden-advancements:
- minecraft:nether/obtain_ancient_debris
- minecraft:end/root
Automatic Ban System
When a forbidden advancement is detected:
- Advancement completion is logged.
- The player is instantly banned.
- The player is kicked from the server.
- Ban data is saved automatically.
- Expired bans are removed automatically.
Built For Performance
AdvancementGuard uses Paper's native advancement events and only performs checks when advancements are completed, resulting in virtually zero performance impact on your server.
Simple. Fast. Reliable.
Protect your server's progression with AdvancementGuard.
