🔥 MythicStaffs

ᴘʀᴇᴍɪᴜᴍ ᴍʏᴛʜɪᴄ sᴛᴀғғ ᴘʟᴜɢɪɴ ᴡɪᴛʜ ᴄᴏᴍʙᴏ sᴘᴇʟʟ ᴍᴇᴄʜᴀɴɪᴄs
A lightweight yet powerful Minecraft plugin that adds a Fire Staff with unique combo-based spell mechanics, particle effects, and a real-time ActionBar HUD.

✨ Features

📸 Preview

ᴅᴀsʜ  |  ʀɪɴɢ  |  ʙᴜʀsᴛ  |  ᴠᴏʀᴛᴇx

  ᴍʏᴛʜɪᴄ ᴡᴇᴀᴘᴏɴ

  ᴀʙɪʟɪᴛɪᴇs:
   ▪ Left Click    | ғɪʀᴇ ᴅᴀsʜ
   ▪ Snk + L-Click | ғɪʀᴇ ᴠᴏʀᴛᴇx
   ▪ Right Click   | ғʟᴀᴍᴇ ʙᴜʀsᴛ
   ▪ Snk + R-Click | ɪɴғᴇʀɴᴏ ʀɪɴɢ
   ▪ Passive       | ʟᴀᴠᴀ ᴡᴀʟᴋᴇʀ

🎮 Abilities & Controls

⚔️ Fire Dash — Left Click

Dash forward in a blaze of glory! Your character lunges in the direction you're facing, leaving a trail of fire particles behind. Enemies caught in your path feel the heat.

• Cooldown: 4 seconds
• Effect: Forward dash + fire trail

🌪️ Fire Vortex — Sneak + Left Click

Summon a devastating fire tornado at your target location! A spiraling column of flames rises from the ground, pulling in nearby enemies, dealing continuous damage, and launching them into the air.

• Cooldown: 10 seconds
• Range: 20 blocks
• Damage: 2 hearts per tick + fire damage
• Effect: Spiral fire particles + enemy knockup

💥 Flame Burst — Right Click

Unleash a barrage of fire projectiles! Works like a magical flamethrower, shooting rapid-fire flame particles that damage and ignite enemies on contact.

• Cooldown: 6 seconds
• Effect: Rapid fire projectiles

🔴 Inferno Ring — Sneak + Right Click → Left Click

A two-step ultimate ability! First, charge a spinning ring of fire in front of you. Then, release it with Left Click to send the ring flying as a devastating projectile that damages and ignites everything in its path.

• Cooldown: 8 seconds
• Charge Duration: 5 seconds max
• Effect: Spinning fire ring → projectile

🌋 Lava Walker — Passive

While holding the Fire Staff, you are completely immune to all fire and lava damage. Walk across lava oceans as obsidian forms beneath your feet, then reverts back after you pass.

• Effect: Fire immunity + Frost Walker-style lava walking

📥 Installation

1. Download the latest MythicStaffs.jar from Releases
2. Place it in your server's plugins/ folder
3. Restart (or reload) your server
4. Done! Use /staff give to get your Fire Staff

🎨 Custom Texture (Resource Pack)

You can add a custom 3D model for the Fire Staff! The staff uses CustomModelData: 1000 on a Stick item.

MyResourcePack/
├── pack.mcmeta
├── pack.png                     (optional, pack icon)
└── assets/
    └── minecraft/
        ├── models/
        │   └── item/
        │       ├── stick.json            ← Override file (REQUIRED)
        │       └── fire_staff.json       ← Your custom staff model
        └── textures/
            └── item/
                └── fire_staff.png        ← Your custom texture

{
  "pack": {
    "pack_format": 34,
    "description": "MythicStaffs Resource Pack"
  }
}

{
  "parent": "item/handheld",
  "textures": {
    "layer0": "item/stick"
  },
  "overrides": [
    { "predicate": { "custom_model_data": 1000 }, "model": "item/fire_staff" }
  ]
}

📋 Commands

Aliases: /ms for /mythicstaff

🔑 Permissions

⚙️ Requirements

• Server: Paper or Spigot 1.21.x
• Java: 21 or higher

🏗️ Building from Source

git clone https://github.com/WryriaDev/MythicStaffs.git
cd MythicStaffs
mvn clean package

The compiled .jar will be in the target/ folder.

📂 Project Structure

src/main/java/com/mythicstaff/
├── MythicStaffPlugin.java       # Main plugin class
├── StaffManager.java            # Staff item creation & detection
├── CooldownManager.java         # Ability cooldown system
├── LavaWalkerManager.java       # Passive lava walking mechanic
├── command/
│   ├── MythicStaffCommand.java  # /mythicstaff command handler
│   └── StaffGiveCommand.java    # /staff give command handler
├── listener/
│   └── StaffComboListener.java  # Ability triggers & ActionBar HUD
├── task/
│   ├── FireDashTask.java        # Fire Dash particle animation
│   ├── VortexTask.java          # Fire Vortex spiral animation
│   ├── FlameBurstTask.java      # Flame Burst projectile logic
│   └── FireProjectileTask.java  # Inferno Ring projectile logic
└── util/
    └── TextUtil.java            # Hex color & small caps utilities

📜 License

This project is licensed under the MIT License — feel free to use, modify, and distribute.

💖 Credits

• Developed with ❤️ by Wryria
• Built for Paper/Spigot 1.21.x

⭐ If you like this plugin, give it a star! ⭐