XiaoklunarGhastSpeed

What this plugin is

A craft-only Paper plugin that lets players craft speed harnesses for Happy Ghasts, then apply a configured speed boost by equipping the harness on the ghast.

---

Features

✅ Craftable Speed Harness Tiers

Adds 5 tier recipes that extend the vanilla Harness recipe by filling the bottom row with one material:

• Gold Ingots → Speed I
• Iron Ingots → Speed II
• Emeralds → Speed III
• Diamonds → Speed IV
• Netherite Ingots → Speed V

Harness color is determined by the wool color used in the middle of the recipe.

---

✅ Ultimate Speed Harness (Special Craft)

Adds a shapeless “ultimate” craft:

Requires:

• 1× Speed I harness
• 1× Speed II harness
• 1× Speed III harness
• 1× Speed IV harness
• 1× Speed V harness
• 4× Phantom Membrane

Output:

• Harness with lore: ᴜʟᴛɪᴍᴀᴛᴇ ꜱᴘᴇᴇᴅ
• Internally treated as tier 7

---

✅ Applies Speed to Happy Ghasts

• Right-click a Happy Ghast while holding a speed harness to apply the tier speed.
• If the harness has no tier, the plugin removes any previously applied boost and restores base speed.

---

✅ Restores Speed When Harness Is Removed

• If the harness is sheared off the Happy Ghast, the plugin restores the ghast’s original speed values.

---

✅ Configurable Speed Values

You can adjust the actual speed values per tier in:

plugins/XiaoklunarGhastSpeed/config.yml

Example defaults:

speeds:
  1: 0.10
  2: 0.15
  3: 0.20
  4: 0.25
  5: 0.30
  7: 0.475

---

✅ Visual styling

• Harnesses have a glint (hidden enchant) and show lore in small caps.
• Tier harness lore shows Roman numerals like vanilla enchants (Speed I–V).
• Ultimate shows ᴜʟᴛɪᴍᴀᴛᴇ ꜱᴘᴇᴇᴅ.