ProtectYourEco – Official Plugin Documentation
ProtectYourEco is a Minecraft plugin designed to protect your server’s in-game economy by regulating rare item drops, disabling exploit-prone mechanics like raids, and adding a configurable anti-AFK system.

Configuration Guide (config.yml)
✅ General Prefix
prefix: "&8[&bProtect Your Eco&8] "

Used as the base for all plugin messages. Can be used with %prefix% placeholder.

⚙️ Drop Rate Controls
elytra-spawn-chance: 0.1 # Chance Elytras appear in End Ships (0.0–1.0)
shulker-shell-drop-chance: 0.02 # Chance Shulkers drop a shell
wither-skull-drop-chance: 0.01 # Chance Wither Skeletons drop a skull
totem-only-from-evoker: true # Only allow Totems from Evokers

Raid Prevention
disable-raids: true # Completely disables raids & Bad Omen effect

This disables the raid mechanic and removes Bad Omen upon dimension change.

Anti-AFK System
anti-afk:
enabled: true # Master toggle
countdown-seconds: 300 # Time (in seconds) of inactivity before considered AFK
command: "spawn" # Command executed AS PLAYER when AFK (no slash needed)

Custom Messages
message:
reload-success: "%prefix%&aConfig successfully reloaded."
raid-effect-blocked: "%prefix%&cRaid effects are disabled."
bad-omen-removed: "%prefix%&cBad Omen removed."
afk: "%prefix%&eYou are now AFK."

log:
elytra-removed: "[Protect Your Eco] Elytra removed."

Commands

Command Permission Description
/preco reload protecteco.admin Reloads configuration file
Tab-completion is supported for /preco.
AFK Behavior Explained

• Movement updates the AFK timer
  
  
• Once player is inactive for countdown-seconds, plugin sends message & executes command
  
  
• AFK state is stored → only triggers once until player moves again

Tested On

• Minecraft 1.20–1.21 (Paper)
  
  
• Java 17 & Java 21

‍ Developer
Coded by McGovernn
stadtsucht.net
Have feedback or ideas? Reach out on Spigot or Discord!

License
This plugin is free to use and modify with proper credit to the author. Commercial redistribution is not permitted.