AdvancedComsumables

<b>AdvancedConsumables</b> is a premium PvP plugin that introduces a <b>contract-based duel system</b> combined with a powerful set of <b>special consumable items</b>.
Challenge any player by striking them with an <b>Assassination Contract</b>, teleport both combatants to a custom arena, and let strategy decide the outcome.

⚔️ CORE FEATURES

Everything you need for a complete PvP experience — ready out of the box.
No dependencies required
<b>PlaceholderAPI support (optional)</b>
Fully configurable via <code>config.yml</code>, <code>consumables.yml</code>, <code>messages.yml</code>

⚔️ DUEL DETAILS

Duration: 120 seconds <b>(configurable)</b>
Contract cooldown: 300 seconds per player <b>(configurable)</b>
Commands are blocked during active duels
Arena boundaries are strictly enforced
Disconnect = <b>automatic loss</b>
Draw: both players lose inventory & return
Stats are saved automatically
World restrictions fully configurable

🧪 CONSUMABLE TYPES

🔴 EFFECT ELIXIRS — Temporary potion effects

Elixir of Strength — Strength I (10s)
Elixir of Shadows — Invisibility + Speed I (8s)
Elixir of Resistance — Resistance II (6s)

🔵 IMMUNITY ORBS — Block negative effects

Purification Orb — Blocks Poison, Wither & Weakness (10s)
Divine Shield — Blocks Slowness, Mining Fatigue & Blindness (15s)

🟠 UTILITY ITEMS — Change the fight dynamically

Swapper — Swap positions (30 blocks)
Shockwave — Push players (radius: 10)
Gravity Field — Pull zone (radius: 8)
Smoke Screen — Blindness + hidden nametags
Wind Feather — Dash forward (10 blocks)

Players can have a maximum of 2 active consumables.
All items are fully configurable.

📜 COMMANDS

/ac wand — Get the arena selection wand
/ac setarena — Save selected region as arena
/ac setspawn1 — Set spawn point 1
/ac setspawn2 — Set spawn point 2
/ac removearena — Remove arena
/ac reload — Reload configs
/ac givecontract — Get a contract
/ac giveconsumable <name> [amount] — Give item
/ac gui — Open GUI
/ac stats — View stats
/ac top — Leaderboard

<b>Permission:</b> <code>advancedconsumables.admin</code>
<b>Aliases:</b> <code>/advancedconsumables</code>, <code>/ac</code>

📊 PLACEHOLDERAPI

Optional integration for scoreboards & plugins:

<code>%advancedconsumables_wins%</code> — Total wins
<code>%advancedconsumables_losses%</code> — Total losses
<code>%advancedconsumables_total%</code> — Total duels
<code>%advancedconsumables_top_wins_name%</code> — Top player (wins)
<code>%advancedconsumables_top_wins_count%</code> — Highest wins
<code>%advancedconsumables_top_losses_name%</code> — Top player (losses)
<code>%advancedconsumables_top_losses_count%</code> — Highest losses

🔧 REQUIREMENTS & COMPATIBILITY

Paper / Spigot <b>1.21.4</b>
Java <b>21+</b>
PlaceholderAPI <i>(optional)</i>

⚠️ No dependencies required for core functionality

---

If you enjoy the plugin, please leave a review ⭐
Need help or found a bug? Join the Discord.
Made with ❤️ by <b>xArkzen</b>