# CasterOS<\/p>\n
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\u2019s style.<\/p>\n
—<\/p>\n
## \u2728 Main Features<\/p>\n
– **Easy Spell System:**
\n Add, remove, or change spells just by editing a config file. Each spell can have its own effects, particles, and sounds.<\/p>\n
– **Custom Incantations:**
\n Players cast spells by saying or typing magic words (incantations) that you define in `spells.yml`.<\/p>\n
– **Spell Synergy & Status Effects:**
\n Spells can interact with each other, creating combos or applying special effects for deeper gameplay.<\/p>\n
– **Magic Wand Support:**
\n Players can get a special magic wand (a stick with a unique name and tag).
\n *Note: For a custom wand image, a resource pack is required due to Minecraft limitations.*<\/p>\n
– **\/wand Command:**
\n Instantly gives you a magic wand for spellcasting.<\/p>\n
– **Reload Without Restart:**
\n Change your spell config and reload it in-game\u2014no server restart needed.<\/p>\n
– **Easy to Extend:**
\n Developers can add new spells by creating a new class and registering it.<\/p>\n
—<\/p>\n
## \ud83d\ude80 Getting Started<\/p>\n
1. **Install:**
\n Put the CasterOS JAR file in your server\u2019s `plugins` folder.<\/p>\n
2. **Configure Spells:**
\n Open `spells.yml` to add or edit spells, incantations, and aliases.<\/p>\n
3. **(Optional) Custom Wand Texture:**
\n If you want a custom image for the magic wand, you\u2019ll need a resource pack with the right `CustomModelData` setting.<\/p>\n
4. **Get Your Wand:**
\n Use `\/wand` in-game to receive your magic wand and start casting spells!<\/p>\n
—<\/p>\n
## \ud83d\udcc1 File Overview<\/p>\n
– `plugin.yml` \u2014 Plugin info and commands
\n– `spells.yml` \u2014 All spell settings and incantations
\n– `src\/main\/java\/com\/casteros\/paper\/` \u2014 Main plugin code
\n– `src\/main\/java\/com\/casteros\/paper\/spell\/` \u2014 All spell files<\/p>\n
—<\/p>\n
## \ud83e\udde9 How to Add a New Spell<\/p>\n
1. Make a new class in `com.casteros.paper.spell` that implements the `Spell` interface.
\n2. Register your spell in `SpellRegistry.java`.
\n3. Add your spell to `spells.yml` with a unique incantation.<\/p>\n
—<\/p>\n
## \u26a0\ufe0f Important: Custom Textures<\/p>\n
Minecraft does **not** allow plugins to change item textures or models without a resource pack.
\nIf you want your magic wand to have a custom look, you must use a resource pack.<\/p>\n
—<\/p>\n
## \ud83d\udcdc License<\/p>\n
CasterOS is open-source and released under the MIT License.<\/p>\n","protected":false},"excerpt":{"rendered":"
CasterOS is a cross-platform Minecraft magic plugin for Paper and Sponge servers. It features immersive spell casting, dynamic magic mode, and easy spell management with YAML files\u2014making it simple to customize and expand your server\u2019s magical experience.<\/p>\n","protected":false},"featured_media":37343,"template":"","meta":{"_minecraft_slug":"casteros","_minecraft_project_id":"80m9rI0h","_minecraft_author":"gaberd","_minecraft_license":"Apache-2.0","_minecraft_downloads":104,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"casteros.zip","_minecraft_size_bytes":48841,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:41:12.019665Z","_minecraft_date_created":"2025-12-21T05:18:11.635196Z","_minecraft_date_modified":"2025-12-25T20:19:19.737738Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/casteros","_minecraft_icon_attachment_id":37343,"_minecraft_imported_at":"2026-06-01T18:56:09+00:00","_minecraft_import_hash":"cd1d0b36f1e268d2af92b899fbafca1d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,43,125,89,873,122,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-37342","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-cursed","mod_category-folia","mod_category-game-mechanics","mod_category-library","mod_category-magic","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n