advancement gaurd

# 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 ```yaml 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: 1. Advancement completion is logged. 2. The player is instantly banned. 3. The player is kicked from the server. 4. Ban data is saved automatically. 5. 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.