CasterOS

# CasterOS CasterOS is a powerful and easy-to-use magic system for Minecraft PaperMC servers. It lets players cast a variety of spells using simple commands or incantations, with support for spell combos, status effects, and custom spell logic. CasterOS is designed to be flexible, so server owners can easily add or change spells to fit their server’s style. --- ## ✨ Main Features - **Easy Spell System:** Add, remove, or change spells just by editing a config file. Each spell can have its own effects, particles, and sounds. - **Custom Incantations:** Players cast spells by saying or typing magic words (incantations) that you define in `spells.yml`. - **Spell Synergy & Status Effects:** Spells can interact with each other, creating combos or applying special effects for deeper gameplay. - **Magic Wand Support:** Players can get a special magic wand (a stick with a unique name and tag). *Note: For a custom wand image, a resource pack is required due to Minecraft limitations.* - **/wand Command:** Instantly gives you a magic wand for spellcasting. - **Reload Without Restart:** Change your spell config and reload it in-game—no server restart needed. - **Easy to Extend:** Developers can add new spells by creating a new class and registering it. --- ## 🚀 Getting Started 1. **Install:** Put the CasterOS JAR file in your server’s `plugins` folder. 2. **Configure Spells:** Open `spells.yml` to add or edit spells, incantations, and aliases. 3. **(Optional) Custom Wand Texture:** If you want a custom image for the magic wand, you’ll need a resource pack with the right `CustomModelData` setting. 4. **Get Your Wand:** Use `/wand` in-game to receive your magic wand and start casting spells! --- ## 📁 File Overview - `plugin.yml` — Plugin info and commands - `spells.yml` — All spell settings and incantations - `src/main/java/com/casteros/paper/` — Main plugin code - `src/main/java/com/casteros/paper/spell/` — All spell files --- ## 🧩 How to Add a New Spell 1. Make a new class in `com.casteros.paper.spell` that implements the `Spell` interface. 2. Register your spell in `SpellRegistry.java`. 3. Add your spell to `spells.yml` with a unique incantation. --- ## ⚠️ Important: Custom Textures Minecraft does **not** allow plugins to change item textures or models without a resource pack. If you want your magic wand to have a custom look, you must use a resource pack. --- ## 📜 License CasterOS is open-source and released under the MIT License.