🪄️ Features

Data driven API

• 🗡️ Spells can be assigned to any weapon (data driven)
• 🔮 Spells deal damage based on Spell Power entity attributes
• ✍️ Spells defined in JSON format
• ⚙️ Spells have a set of different mechanical behaviours:
  • Cast options: duration, mode of release (charged or channeled)
  • Targeting mode: Area, Beam, Cursor, Projectile
  • Impact actions: Damage, Heal, StatusEffect
  • Cost: exhaust (hunger), item (runes), cooldown (time), durability, consume effects

Fancy audio and visuals

• 🔈 Spells have sound effects: at the start of casting, while casting, at release, at impact
• ✨ Spells have particle effects (any particle can be referenced by id), and the engine offers its custom set magical of particles
• 🎨 Custom Item/Block models can be used for Spell Projectiles and Status Effects
• 🤸 Custom player animations can be played at different stages of spell casting

In game features

• 🔧 Spell selection and casting is visible on the HUD (fully player configurable)
• 😌 QoL features included (such as automatic spell cast release)
• ⛓️ Add spells to eligible weapons using the Spell Binding Table

🔧 Configuration

Fabric

Client side settings can be accessed via the Mod Menu.

Forge

Client side settings can be accessed in Main Menu > Mods > Spell Engine > Config.

Server

Server side configuration can be found in the config directory, after running the game with the mod installed.

🔨 Using it as a mod developer

❗️ DOCUMENTATION IS INCOMPLETE!

❗️ API IS NOT FINALIZED, MAY INTRODUCE BREAKING CHANGE AT ANY POINT.

Installation

Add this mod as dependency into your build.gradle file.

maven {
    name = 'Modrinth'
    url = 'https://api.modrinth.com/maven'
    content {
        includeGroup 'maven.modrinth'
    }
}

modImplementation("maven.modrinth:spell-engine:${project.spell_engine_version}-fabric")

Install dependencies:

• Spell Power
• Player Animator
• Cloth Config

(Can be done locally by putting release jars into /run/fabric/mods, or can be resolved from maven and like Spell Engine.)

⭐️ Creating a spell

Create a new file at resources/data/MOD_ID/spells/SPELL_ID.json.

Write the content of the JSON file to match the structure of the Spell class. Your JSON will be parsed into a Spell instance.

Spells are automatically registered.

Resources

Sound

You can register a sound effects to be used for different stages of the spell casting. Alternatively you can use generic magic school related sound effects provided by this mod.

Icon

Place your spell icon to the following location: resources/assets/MOD_ID/textures/spell/SPELL_ID.png

Name and description

Add name and description entries into your translation file.

"spell.MOD_ID.SPELL_ID.name": "Spell Name",
"spell.MOD_ID.SPELL_ID.description": "Shoots and epic energy ball that does {damage} lightning damage",

The description supports multiple string token to display dynamic information.

Custom models

Spells can render custom models, using Item/Block format (can be created using BlockBench). Place your model to: resources/assets/MOD_ID/models/item/MY_PROJECTILE_NAME.json Register your own model, like this:

CustomModels.registerModelIds(List.of(
    new Identifier(MOD_ID, "MY_PROJECTILE_NAME")
));

Projectiles

Custom model projectiles can be used by just referencing the registered projectile model.

Status effects

Custom models can be used to be rendered over entities affected by custom status effects.

Create a renderer, implementing CustomModelStatusEffect.Renderer, and register it:

`CustomModelStatusEffect.register(MyStatusEffects.myEffectInstance, new MyRenderer());`

Example (Frost Shield, renders a big block around to player):

public class FrostShieldRenderer implements CustomModelStatusEffect.Renderer {
    public static final Identifier modelId_base = new Identifier(WizardsMod.ID, "frost_shield_base");
    private static final RenderLayer BASE_RENDER_LAYER = RenderLayer.getTranslucentMovingBlock();
    @Override
    public void renderEffect(int amplifier, LivingEntity livingEntity, float delta, MatrixStack matrixStack, VertexConsumerProvider vertexConsumers, int light) {
        float yOffset = 0.51F; // y + 0.01 to avoid Y fighting
        matrixStack.push();
        matrixStack.translate(0, yOffset, 0); // y + 0.01 to avoid Y fighting
        CustomModels.render(BASE_RENDER_LAYER, MinecraftClient.getInstance().getItemRenderer(), modelId_base,
                matrixStack, vertexConsumers, light, livingEntity.getId());
        matrixStack.pop();
    }
}

🪄 Assigning spells to items

Create a pool of spells

Create your pool, by creating a JSON file at: resources/data/MOD_ID/spell_pools/POOL_ID.json.

Example, an arbitrary set spells:

{
  "spell_ids": [
    "wizards:fireball",
    "wizards:fire_breath",
    "wizards:fire_meteor"
  ]
}

Example, all spells of a specified magic school:

{
  "all_of_schools": ["FIRE"]
}

The two solutions can be combined.

Assign to the item

Assign zero, one or more spells to an item, by creating a JSON file at: resources/data/MOD_ID/spell_assignments/ITEM_ID.json.

Your JSON file will be parsed into a Spell Container.

Example wand (one spell assigned, no more can be added)

{
  "spell_ids": [ "MOD_ID:SPELL_ID" ]
}

Example staff (zero spell assigned, 3 can be added)

{
  "pool": "MODID:POOL_ID",
  "max_spell_count": 3,
  "spell_ids": [ ]
}

When an item has an assigned Spell Container, it will be eligible for Spell Power enchantments.

✨ Audio and visuals

Spell Engine has multiple kind of assets built in:

• Sound effects (you can find the available sounds here)
• Particle effects (you can find the available effects here)
• Player Animations (you can find the available animations here)

These assets are referenced in spell json files, by using their Identifier.