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?

- 🎨 Flexible Settings — name, color, type, effects - 🖱️ Flexible Settings — no commands, just mouse clicks - 💾 Flexible Settings — create a library of your potions - 🌍 Flexible Settings — interface available in multiple languages - ⚡ Flexible Settings — 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:

- ✏️ Preview — set any name for the potion - 🎭 Preview: - 🍶 Normal (drinkable) - 💥 Splash - 🌫️ Lingering - 🎨 Preview — palette with hundreds of shades - ⚗️ Preview — add up to 10 effects to one potion - ⏱️ Preview — from 1 second to 1 hour - 📊 Preview — 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: - 📚 Removal — all vanilla Minecraft effects - ⏰ Removal — precise settings in seconds - 📈 Removal — 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:

- 📋 Paginated Navigation — with full information - 👆 Paginated Navigation — get potion in inventory - ✏️ Paginated Navigation — edit potion - 📑 Paginated Navigation — duplicate potion - ❌ Paginated Navigation — 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[&dCustomPots&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

- ☕ Optional: 17+ - 🎮 Optional: 1.21.x - 🔌 Optional: 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 ```

---