# 🧪 MythicPotions — Advanced Custom Potions for Paper & Purpur (1.21+)
**MythicPotions** is a lightweight, modern, and highly configurable Minecraft plugin that adds **22 unique custom potions** with dynamic particle mechanics, combat abilities, and customizable cooldowns.
Designed specifically for server networks and survival/RPG/PvP servers, it seamlessly integrates with your existing server economy and **third-party shop plugins** (ShopGUI+, EconomyShopGUI, DeluxeMenus, ChestCommands, etc.).
---
## ✨ Features
- **22 Unique Potions**: Combat, defensive, and utility potions with custom mechanics:
- ⚡ **Zeus's Wrath** — Chain lightning strike on hit, shocking and slowing nearby enemies.
- 🛡️ **Iron Titan** — Resistance III, Absorption V, and 100% knockback resistance.
- 🗡️ **Shadow Assassin** — Speed III, Invisibility, and +60% critical backstab damage.
- 🩸 **Vampire's Blood** — 35% lifesteal on melee attacks with bonus night damage.
- ❄️ **Frost Nova** — Freezes ground, applies Slowness IV, and causes deep freeze ticks.
- 🔥 **Molten Core** — Lava/fire immunity, sets attackers on fire, and leaves flame trails.
- 🪶 **Icarus Flight** — Double-jump dash thrust with smooth slow falling.
- ⏱️ **Chronos Warp** — Slows down all nearby enemies by 60% while speeding you up.
- ☣️ **Plaguebringer** — Contagious Poison II, Wither II, and Nausea spread.
- 🌟 **Golden Phoenix** — Auto-revival on lethal damage with full heal and fiery burst.
- ⛏️ **Miner's Dream** — Haste III, Night Vision, and auto-smelts mined ores into ingots.
- 🌀 **Gravity Well** — Pulls all nearby enemies into a singularity and stuns them.
- 🌊 **Ocean Sovereign** — Dolphin's Grace, Conduit Power, and increased water damage.
- 🧲 **Magnetic Pulse** — Attracts all dropped items and XP within 25 blocks to you.
- 🏹 **Sniper's Focus** — +50% arrow speed, +40% arrow damage, and 10s glowing outline.
- 🧪 **Alchemical Overcharge** — Amplifies all active positive potion effects by +1 tier.
- 💥 **Kamikaze Blast** — Massive shockwave explosion damaging and flinging enemies without block damage.
- 🍀 **Fortune's Favor** — Luck V, double mob drops, and rare gems from mining.
- 👻 **Ghost Step** — Phase through mobs, silent footsteps, and no fall damage.
- 🌸 **Lifebloom** — Emits healing waves every 2 seconds to you and nearby allies.
- 🪓 **Berserker Rage** — The lower your health, the higher your attack damage (up to +150%).
- 👁️ **Medusa's Gaze** — Petrifies enemies looking directly at you in combat.
---
## 🛒 Third-Party Shop Integration
MythicPotions is built to work with your favorite server shop plugins! On server startup, it automatically generates ready-to-copy shop configurations in `plugins/CustomPotions/shop_integrations/`:
- **ShopGUIPlus** (`ShopGUIPlus_example.yml`)
- **EconomyShopGUI** (`EconomyShopGUI_example.yml`)
- **DeluxeMenus** (`DeluxeMenus_example.yml`)
- **JSON Data** (`external_shops.json`) for web stores (Tebex, CraftingStore) and custom GUIs.
---
## 💰 Universal Economy Support
- **Vault**: Automatic integration with any Vault economy provider.
- **Custom Plugin**: Universal reflection bridge to connect with any server-specific currency class without touching Java code.
- **Command Economy**: Charges or deposits money via server console commands.
- **Physical Items**: Uses emeralds, diamonds, or custom items with custom model data.
- **Scoreboard**: Charges points from any scoreboard objective.
- **Internal Database**: Autonomous JSON balance storage (`balances.json`).
---
## 🛠️ Administrator Commands & Permissions
All commands are restricted to server administrators (`custompotions.admin` or OP):
| Command | Description |
|---|---|
| `/cp give <player> <potion_id> [type] [amount]` | Give custom potions (drink, splash, lingering) |
| `/cp reload` | Reload configuration, language files, and economy hooks |
| `/cp export` | Re-generate third-party shop integration templates |
| `/cp help` | View administrator command list |
---
## 🌐 Supported Languages
- English (`en.json` — default)
- Russian (`ru.json`)
- German (`de.json`)
- Ukrainian (`uk.json`)
