PaintEffect

# PaintEffect (BoyaEfekt) 🎨⚔️ **PaintEffect** is a dynamic, high-stakes Minecraft minigame/mechanic plugin designed for SMP and PvP servers. It divides your player base into two distinct, competitive roles: **Runners** and **Hunters**. By utilizing different colored dyes in their hands, players unlock unique potion effects, special cooldown-based abilities, and custom crafting recipes. Balance is at the core of PaintEffect, making it perfect for competitive survival challenges! --- ## 👥 Choose Your Role Players can select their paths using simple in-game commands. Each role receives a specialized starting bundle (kese) and a guide book. ### 🏃‍♂️ The Runner (`/runner`) Your goal is to survive, outmaneuver the Hunters, and gather resources to craft the ultimate defense. * **Exclusive Dyes:** Red, Blue, Lime, and Pink. * **Starter Kit:** A Runner Bundle containing baseline survival dyes and the Runner Crafting Guide. ### 🏹 The Hunter (`/hunter`) Your goal is to track down the Runners using raw power, utility, and relentless pressure. * **Exclusive Dyes:** Green, Magenta, and Yellow. * **Starter Kit:** A Hunter Bundle containing combat/utility dyes and the Hunter Guide Book. --- ## 🎨 Dye Mechanics & Potion Effects Holding specific dyes in either your **Main Hand** or **Off-Hand** grants passive potion effects every second. However, using a dye restricted to the opposite role will cancel the effect! | Dye Color | Allowed Role | Potion Effects Granted | | :--- | :--- | :--- | | **🔴 Red Dye** | Runner | Strength II + Resistance I | | **🔵 Blue Dye** | Runner | Speed II | | **🟢 Lime Dye** | Runner | Jump Boost IV | | **🌸 Pink Dye** | Runner | Regeneration III + Saturation I | | **🌲 Green Dye** | Hunter | Haste III | | **🔮 Magenta Dye**| Hunter | Regeneration I *(Balanced for fair PvP)* | --- ## ⚡ Active Abilities & Cooldowns (Universal) Some dyes can be **Right-Clicked** or used during combat to trigger powerful tactical abilities. These can be used by both roles for ultimate utility: * **🟡 Yellow Dye (Absorption):** Right-click to gain **+5 Absorption Hearts**. *(60-second cooldown)*. * **🩵 Light Blue Dye (Teleportation):** Right-click to teleport up to **40 blocks** away in the direction you are looking. Grants **3 seconds of Fall Damage Immunity** right after teleporting. *(5-second cooldown)*. * **⚫ Black Dye (Wind Burst & Knockback):** * **Right-Click:** Launch a targeted enemy 20 blocks away backward with massive velocity. *(15-second cooldown)*. * **Left-Click (On Hit):** Triggers a *Wind Burst* effect, launching yourself high into the air. Grants **3 seconds of Fall Damage Immunity** so you can escape or drop down on enemies safely! --- ## 🛠️ Custom Crafting Recipes PaintEffect introduces specialized high-tier recipes to swing the tide of battle: 1. **⭐ Magical Yellow Dye:** Surrounded by 8 Yellow Dyes with a Golden Apple in the center. Right-click to consume for **+10 Absorption Hearts** *(60s cooldown)*. 2. **🔥 Magical Orange Dye:** Surrounded by 8 Gold Blocks with a *Magical Yellow Dye* in the center. Right-click to consume for a massive **+15 Absorption Hearts** *(No cooldown)*. 3. **🛡️ Runner's Special Totem:** Crafted using an Emerald/Diamond Block, a Gold Block, and a Stick vertically. Gives Runners a crucial second chance at life. --- ## ☠️ Hunter's Pity System: The Lucky Book To ensure the game stays competitive, if a Hunter struggles and **dies 15 times**, they are automatically rewarded with the **Hunter's Custom Enchanted Book**. * **Anvil-Free Enchanting:** Simply drag and drop the book onto any Armor, Sword, or Bow inside your inventory! * **Random Tiers:** It will instantly apply either **Protection IV**, **Sharpness II**, or **Power II** to the item, ignoring vanilla limits and bypassing the need for experience levels or anvils. --- ## 💻 Commands & Installation 1. Drop the `BoyaEfekt.jar` into your server's `plugins` folder. 2. Ensure you register `/runner` and `/hunter` in your `plugin.yml` if necessary. 3. Restart your server and enjoy the chaos! *Developed with ❤️ for competitive Minecraft communities.*