PotionLimiter

** 🧪 PotionLimiter - Complete Plugin Documentation 📖 Description **PotionLimiter** is a powerful and lightweight Minecraft plugin for Paper 1.21.1+ that gives server administrators complete control over the brewing system. Whether you want to balance PvP, create custom game modes, or restrict certain potion types for gameplay reasons, PotionLimiter provides an intuitive and flexible solution. The plugin allows you to: - **Blacklist specific potion types** from being brewed (including variants like LONG, STRONG) - **Control brewing by world** - enable or disable the plugin in specific worlds - **Notify players** when blocked potions are attempted - **Preserve ingredients** when brewing is blocked - **Easy configuration** with copy-paste reference examples Built with modern Java 21, Paper API, and Kyori Adventure (MiniMessage), PotionLimiter offers clean code, performance optimization, and beautiful chat formatting. --- ✨ Key Features 🎯 **Granular Potion Control** - Block specific PotionTypes (e.g., `STRENGTH`, `LONG_STRENGTH`, `STRONG_STRENGTH`) - Support for all Minecraft 1.21 potions including new additions: - Wind Charged - Weaving - Oozing - Infested - Easy-to-use configuration with built-in reference list 🌍 **World-Based Management** - **Blacklist Mode**: Disable plugin in specific worlds (creative, lobby, etc.) - **Whitelist Mode**: Only enable plugin in specific worlds (survival only) - Per-world control for maximum flexibility 💬 **Player Notifications** - Configurable radius-based notifications - Beautiful MiniMessage formatting with gradients and colors - Toggle notifications on/off - Custom blocked messages per potion type 🔄 **Ingredient Preservation** - Brewing events are cancelled before ingredients are consumed - Items remain in brewing stand when blocked - Prevents resource waste ⚙️ **Admin-Friendly** - Simple `/plimit reload` command - no server restart needed - `/plimit list` shows all blocked potions and world restrictions - Tab completion for all commands - Clear console logging 🚀 **Performance & Modern Code** - Java 21 with modern syntax (switch expressions, pattern matching) - No NMS (Native Minecraft Server code) - fully compatible with Paper updates - Dependency injection for clean architecture - Lightweight - minimal server impact --- 📦 Installation 1. **Requirements:** - Minecraft Server 1.21.1 - 1.21.11 - Paper (or Paper-based servers like Purpur, Pufferfish) - Java 21+ 2. **Steps:** ```bash Download PotionLimiter-1.0.0.jar Place in your server's plugins/ folder Start/restart your server Edit plugins/PotionLimiter/config.yml Run /plimit reload in-game ``` --- 🎮 Usage Examples **Example 1: Block Strength Potions in All Worlds** Perfect for balanced PvP servers where strength potions are too overpowered. ```yaml blacklisted-potions: - STRENGTH - LONG_STRENGTH - STRONG_STRENGTH ``` **Result:** Players cannot brew any strength potions. The brewing stand will not complete the process. --- **Example 2: Disable Plugin in Creative World** Allow unrestricted brewing in creative/building worlds while maintaining restrictions in survival. ```yaml world-settings: blacklist-mode: true Blacklist mode blacklisted-worlds: - world_creative - lobby - skyblock_spawn ``` **Result:** Plugin is **disabled** in `world_creative`, `lobby`, and `skyblock_spawn`. Players can brew anything there. In all other worlds, restrictions apply. --- **Example 3: Only Work in Survival World (Whitelist Mode)** Enable the plugin ONLY in your main survival world, ignoring all other worlds. ```yaml world-settings: blacklist-mode: false Whitelist mode blacklisted-worlds: - world Only active here ``` **Result:** Plugin is **only active** in the world named `world`. All other worlds have unrestricted brewing. --- **Example 4: Block All Harmful Potions** Great for peaceful/roleplay servers. ```yaml blacklisted-potions: - HARMING - STRONG_HARMING - POISON - LONG_POISON - STRONG_POISON - WEAKNESS - LONG_WEAKNESS ``` --- **Example 5: Block Invisibility for Fair PvP** Prevent invisibility potions in PvP arenas. ```yaml blacklisted-potions: - INVISIBILITY - LONG_INVISIBILITY ``` --- **Example 6: Block 1.21 New Potions** Disable the new experimental potions added in 1.21. ```yaml blacklisted-potions: - WIND_CHARGED - WEAVING - OOZING - INFESTED ``` --- **Example 7: Custom Notification Settings** Configure how players are notified when brewing is blocked. ```yaml brewing-settings: notify-players: true notify-radius: 10 10 blocks blocked-message: "<gradient:ff0000:ff6666>⚠ You cannot brew <potion> on this server!</gradient>" ``` **Result:** Players within 10 blocks of the brewing stand receive a gradient red message. --- **Example 8: Disable Notifications (Silent Mode)** Block potions without notifying players. ```yaml brewing-settin