soulsave

🎵 CustomDiscPlugin

A lightweight, configuration-driven plugin that adds a unique craftable sword, a unique craftable sword, and simple ability mechanics designed for SMPs, RPG-style servers, and texture-pack-themed worlds.

Everything is powered by Custom Model Data and clean config-based item definitions, making this plugin easy to integrate into any resource pack setup.

---

🎶 Custom Music Disc — Reach

A fully configurable custom disc defined in `config.yml`.

Features:

* Custom name, lore, and material * Custom model data for texture-pack support * ExactChoice crafting protection * Interacts with jukeboxes for custom behavior

📥 How Players Obtain the Disc

Players can acquire the Reach disc naturally in gameplay:

> When a Wither kills a Cat, it drops the Reach disc.

This gives servers a fun, lore-friendly, progression-style method of obtaining the item without crafting or commands.

---

⚔️ Custom Sword — SoulSave

A powerful custom sword crafted from the Reach disc.

Includes:

* Custom name, lore, material, and model data * Lore auto-inserts cooldown values from config * Unbreakable with clean hidden attributes * Simple ability system with configurable cooldown * Perfect for unique gear progression or PvP modifiers

---

🛠 Crafting Recipe

``` D NJN FSF ```

S = Reach Disc (ExactChoice) S = Nether Star S = Jukebox S = Netherite Ingot S = Diamond Sword

Only the exact custom Reach disc works, preventing recipe bypassing and ensuring resource-pack accuracy.

---

⚙ Configuration

Everything is handled through `config.yml`, including:

* Item names * Lore lines * Materials * Custom model data * Cooldown duration * Sword ability formatting

This makes the plugin extremely easy to theme and customize for any server.

---

📌 Commands

`/givedisc` – Gives the Reach disc (optional for admins/testing)