🔮 Item Rituals

Tired of players instantly crafting game-breaking endgame gear with a single click? Want to add an immersive, high-stakes progression system to your survival or RPG server?

Item Rituals completely overhauls the crafting process for specific items of your choosing. Instead of instantly receiving an item from the crafting table, completing the recipe triggers an epic, immersive, server-wide world event. The ingredients are consumed, the ritual site is activated, and players must protect or witness the item materializing over time!

---

✨ Key Features

• 🔒 Crafting Interception: Seamlessly stops items from being instantly crafted. It consumes the grid ingredients and initiates a physical ritual instead.
• 🌀 Sleek Magical Visuals: Generates a massive, perfectly spaced 10x10 spinning ring of floating enchantment table glyph runes around the ritual site, complete with an expanding startup shockwave.
• 🔊 Immersive Audio: Triggers the terrifying, spine-chilling Warden Emergence roar mixed with a physical Beacon activation blast on startup, followed by continuous ambient humming.
• 🧭 Dynamic BossBar HUD: Every player in the world sees a countdown bar tracking the ritual. It includes a smart directional arrow (⬆, ↗, ➡, etc.) that updates in real-time to guide players directly to the ritual coordinates!
• 📦 In-Game GUI Manager: No messy file editing required to add items. Manage your entire ritual registry via an interactive chest menu.
• 🛡️ Crash & Restart Proof: Never worry about losing valuable items. If your server crashes, restarts, or reloads mid-ritual, the plugin instantly cancels the timer and safely drops the raw item onto the ground.
• ⚡ Smart NBT Tag Matching: Features an advanced "loose-matching" engine. It cleanly bypasses invisible client-side tags (like creative mode trackers or repair costs) so survival-crafted items trigger perfectly every time.

---

🎮 How It Works (For Players)

1. The Sacrifice: A player places the ingredients for a registered item into a crafting table and clicks the output slot.
2. The Awakening: The crafting window closes. A loud Warden roar echoes through the area, a shockwave sweeps the floor, and a beautiful ring of spinning magical runes appears.
3. The Manifestation: The item floats dynamically in the center of the ring, glowing brightly and completely immune to fire, explosions, lava, or quick-fingered item thieves.
4. The Reward: Once the BossBar timer hits zero, a completion chime plays, and the fully materialized item drops safely onto the ground for the crafter to pick up!

---

🛠️ Admin Commands & Permissions

🔑 Note: All administrative commands require Operator (OP) status to execute.

/ir help

Displays a clean, jargon-free guide explaining how to use the plugin. Perfect for quick day-to-day staff references.

/ir craft

Registers the exact item you are currently holding in your main hand. From that moment forward, crafting that specific item type (matching its custom name/lore) will require a full ritual.

/ir remove

Unregisters the item you are currently holding in your hand, restoring it back to a normal, instant craft.

/ir gui

Opens a beautiful 54-slot visual inventory menu showing every item currently registered on your server.

• If no items are registered, a helpful barrier block prompt guides you on what to do.
• To delete an item from the ritual registry entirely, simply click on it inside the menu!

/ir reload

Instantly reloads the internal database and config.yml setup from your disk. Tweak your settings on the fly without ever restarting or reloading the entire server!

---

⚙️ Configuration (config.yml)

The plugin automatically generates a clean config file where you can customize global parameters:

# The length of time (in seconds) a ritual takes to materialize an item
ritual-duration: 30

# Internal storage handling registered items (Do not edit this section manually!)
ritual-items: []

---

💾 Installation Guide

1. Download the latest .jar file from the Versions tab.
2. Drop the file directly into your server's plugins/ directory.
3. Restart your server to let the default configuration generate.
4. Log in, hold an item, type /ir craft, and watch the magic happen!