soulsave

🎵 CustomDiscPlugin

A lightweight, configuration-driven plugin that adds a custom music disc, 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

D = Reach Disc (ExactChoice) F = Nether Star J = Jukebox N = 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)