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

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

---