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:

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.