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:

# 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

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

---