**SpellCrafter** is a Minecraft data pack adds over 100 unique spells you can combine in endless ways! Inspired by _Noita_, this system lets you craft your own magic, discover rare spells, and create powerful combinations. Using the resource pack isn't required, but it's highly recommended. > **Note** \ > This project is currently in its alpha stage - you may encounter bugs and unbalanced features. The `1.0.0` release will introduce new spells, textures and system improvements. You can contribute on [GitHub](https://github.com/Ivaynn/SpellCrafter) or join the [Discord server](https://discord.gg/QAtc7ZgPxS).

Here's a [short video](https://youtu.be/tMNynL_ZzsY) showcasing this data pack.
## Getting Started ### 1. Find or spawn a Mystic Merchant These traders can spawn naturally, or you can spawn one: ``` /loot give @s loot spellcrafter:egg/trader ``` ### 2. Buy a wand and some spells Each trader offers a unique, randomly generated selection of spells and wands. ![Trader](https://raw.githubusercontent.com/Ivaynn/SpellCrafter/refs/heads/main/docs/img/trader.png) ### 3. Craft and place a Wand Editor | Wand Editor Recipe | Items | | -- | -- | | ![Recipe](https://raw.githubusercontent.com/Ivaynn/SpellCrafter/refs/heads/main/docs/img/recipe_table.png) | 4 Obsidian
2 Amethyst Shards
1 Book ``` /loot give @s loot spellcrafter:egg/table ``` ### 4. Open the editor while holding your wand Here, you can edit the spells of your wand. Put spells in this menu to add them to your wand. ![Wand Editor](https://raw.githubusercontent.com/Ivaynn/SpellCrafter/refs/heads/main/docs/img/wand_editor.png) ### 5. Save and shoot your wand Exit the Wand Editor to save the spells to your wand. You can check the item's description to see the spell list, mana cost, cooldown and available slots. ![Wand Description](https://raw.githubusercontent.com/Ivaynn/SpellCrafter/refs/heads/main/docs/img/wand_description.png)
## Spells **→** | Projectile \ Spells that shoot a projectile. They usually travel in a straight line and deal damage when they hit something, but this can be modified by other spells. The spell list continues where the projectile ends. **⛶** | Modifier \ Spells that modify a projectile. These can be stacked and completely change how the projectile behaves. They can change its damage, range, speed, trajectory, appearance, ... **✦** | Instant \ Spells that get cast instantly and cannot be modified. These can summon entities, protect you, create explosions, teleport entities, create shields, affect nearby projectiles, ... **⚝** | Special \ Spells that affect the wand in unique ways and don't fit any of the other categories. These can modify the wand properties, change spell order, copy other spells, ... A complete list of spells is available [here](https://ivaynn.github.io/SpellCrafter/).
## Advancements You can use advancements to track your progress! Find new spells to expand your collection: ![Advancements](https://raw.githubusercontent.com/Ivaynn/SpellCrafter/refs/heads/main/docs/img/advancements.png)
## Target Dummy Target dummies can be used to test your wands. They display the damage taken and they can even use a wand if you give them one. To remove the dummy, give it an egg or another target dummy's spawn egg. ![Target Dummy](https://raw.githubusercontent.com/Ivaynn/SpellCrafter/refs/heads/main/docs/img/target_dummy.png) | Target Dummy Recipe | Items | | -- | -- | | ![Recipe](https://raw.githubusercontent.com/Ivaynn/SpellCrafter/refs/heads/main/docs/img/recipe_dummy.png) | 8 Diamonds
1 Egg ``` /loot give @s loot spellcrafter:egg/dummy ```
## Mystic Merchant This wandering trader spawns wearing a magical hat. Their random spawns are linked to players, so you're more likely to see them on servers with other people. They sell a random selection of spells and a few wands that already have some spells in them. They can also sell their hat and mana cookies, used to permanently increase the player's mana. Mystic Merchants can be spawned with their egg (only obtainable with commands): ``` /loot give @s loot spellcrafter:egg/trader ```
## Enemies Most human-shaped mobs can also be spawned holding a randomly generated wand. ``` /loot give @s loot spellcrafter:egg/mob/husk /loot give @s loot spellcrafter:egg/mob/zombie_villager /loot give @s loot spellcrafter:egg/mob/stray /loot give @s loot spellcrafter:egg/mob/vindicator /loot give @s loot spellcrafter:egg/mob/wither_skeleton ``` These enemies always drop their wand when killed. Each mob type has a fixed "Tier" which controls their mana and how strong their spells and wands can be.
## Admin Tools ### Datapack Options An interactive options menu, used to toggle certain features. ``` /function spellcrafter:admin/options ``` ### Infinite Mana Disable mana restrictions when casting a spell (toggle). ``` /function spellcrafter:admin/infinite_mana ``` ### No Cooldown Disable cooldown restrictions when casting a spell (toggle). ``` /function spellcrafter:admin/no_cooldown ``` ### Clear Cooldowns Clear wand item cooldowns for all wands in your inventory. ``` /function spellcrafter:admin/clear_cooldowns ``` ### Untargetable Become untargetable by spells (toggle). ``` /function spellcrafter:admin/untargetable ``` ### Spells Menu Replaces your inventory with a menu containing all spells and a wand builder (toggle). ``` /function spellcrafter:admin/spells_menu ``` Disables the collection advancements while enabled.
## Compatibility Notes - Everything uses the `spellcrafter` namespace/prefix
## Contributing Found a bug? Have a suggestion? Join the [Discord](https://discord.gg/QAtc7ZgPxS) or create an [Issue](https://github.com/Ivaynn/SpellCrafter/issues)!