CustomPots!

**CustomPots** is a powerful plugin for Minecraft 1.21.x that allows administrators to create fully customized potions through a convenient GUI menu. No complex commands or configuration files - all management is done through a visual interface! ### ✨ Why CustomPots? - 🎨 **Full Customization** — name, color, type, effects - 🖱️ **All Through GUI** — no commands, just mouse clicks - 💾 **Save Potions** — create a library of your potions - 🌍 **Full Localization** — interface available in multiple languages - ⚡ **Optimized** — lightweight and fast code - 🔧 **Flexible Settings** — all limits and texts are configurable --- ## 🎯 Main Features ### 🧪 Creating Custom Potions Use the `/custompotions create` command to open the creation menu: - ✏️ **Unique Name** — set any name for the potion - 🎭 **Potion Type**: - 🍶 Normal (drinkable) - 💥 Splash - 🌫️ Lingering - 🎨 **Color Selection** — palette with hundreds of shades - ⚗️ **Multiple Effects** — add up to 10 effects to one potion - ⏱️ **Duration Settings** — from 1 second to 1 hour - 📊 **Effect Levels** — from level 1 to 255 - 👁️ **Preview** — see the final potion in real-time ### 🎨 Color Palette Separate color selection menu with: - 📄 Paginated navigation - 🌈 Hundreds of ready-made colors - 👀 Visual display of each shade - ✅ Instant application to potion ### ⚗️ Effect Editor For each effect, you can configure: - 📚 **Effect Type** — all vanilla Minecraft effects - ⏰ **Duration** — precise settings in seconds - 📈 **Level** — from weak to powerful effect - 🗑️ **Removal** — easily remove unwanted effects **All effect names in your language:** - Speed, Slowness, Haste, Mining Fatigue - Strength, Instant Health, Instant Damage - Jump Boost, Nausea, Regeneration - Resistance, Fire Resistance, Water Breathing - Invisibility, Blindness, Night Vision - Hunger, Weakness, Poison, Wither - And many more! ### 💾 Potion Management The `/custompotions manage` command opens the library: - 📋 **View All Potions** — with full information - 👆 **Left Click** — get potion in inventory - ✏️ **Right Click** — edit potion - 📑 **Shift + Left Click** — duplicate potion - ❌ **Shift + Right Click** — delete potion - 📄 **Paginated Navigation** — for large collections ### 🎮 Commands | Command | Description | Permission | |---------|-------------|------------| | `/custompotions create` | Open creation menu | `custompotions.create` | | `/custompotions manage` | Manage potions | `custompotions.manage` | | `/custompotions give <player> <name>` | Give potion to player | `custompotions.give` | | `/custompotions list` | List all potions | `custompotions.admin` | | `/custompotions reload` | Reload configuration | `custompotions.admin` | **Aliases:** `/cpotions`, `/cp` --- ## ⚙️ Configuration ### 📝 config.yml All aspects of the plugin are configured through the config: ```yaml # GUI menu titles gui: creation-menu: title: "&6&lPotion Creation" management-menu: title: "&6&lPotion Management" color-picker: title: "&6&lColor Selection" # Limits potions: max-effects: 10 # Maximum effects max-duration: 3600 # Maximum duration (seconds) max-amplifier: 255 # Maximum effect level # Messages (all customizable) messages: prefix: "&8" potion-created: "&aPotion successfully created!" potion-saved: "&aPotion saved!" # ... and much more ``` ### 🔐 Permissions ```yaml custompotions.* # All permissions custompotions.create # Create potions custompotions.manage # Manage potions custompotions.give # Give potions custompotions.admin # Administrative commands ``` --- ## 📦 Installation 1. Download the plugin `.jar` file 2. Place it in your server's `plugins/` folder 3. Restart the server 4. Done! Use `/custompotions create` ### Requirements - ☕ **Java**: 17+ - 🎮 **Minecraft**: 1.21.x - 🔌 **Platform**: Spigot / Paper - 📦 **Optional**: PlaceholderAPI (for placeholders) --- ## 🔌 PlaceholderAPI Integration If you have PlaceholderAPI installed, placeholders are available: - `%custompotions_last_name%` — name of the last used potion - `%custompotions_cooldown%` — cooldown for usage (in development) --- ## 📸 Screenshots > *Add screenshots to Modrinth gallery* 1. Potion creation menu 2. Color selection palette 3. Effect editor 4. Potion management menu 5. Example of custom potion in-game --- ## 🎥 Usage Examples ### Creating a "Divine Power" Potion 1. `/custompotions create` 2. Enter name: "Divine Power" 3. Select type: Normal 4. Select color: Golden 5. Add effects: - Strength V (5 minutes) - Regeneration III (3 minutes) - Resistance II (5 minutes) - Speed II (5 minutes) 6. Click "Save" ### Giving Potion to Player ``` /custompotions give Player123 Divine Power ``` ---