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.