Iron's Spells:Mana Awakened

1. Targeting and Casting Conditions

• Target filtering: can target only specific mobs or tags, skip shield-blocking players, select targets only within a certain health range, avoid hitting teammates, and avoid hitting creative-mode players.

• Creative-mode players are no longer chased/attacked by default (configurable).

• World conditions: decide whether to cast based on time (day/dusk/night/dawn), weather (clear/rain/thunder), moon phase, dimension, difficulty, and world day count.

• Caster states: on fire, in water, in lava, and frozen by powder snow.

• The Nether and the End have no sky, so time conditions never hold there; use dimension conditions instead.

2. Aiming, Landing Points, and Spell Execution

• Teleport-type spells can land behind the player: added the BEHIND_TARGET aiming mode.

• Safer random landing points: can be configured to avoid liquids and lava, so spells are no longer dropped into water.

• /spellmob validate will warn that patterns like “aiming mode + projectile spell” only change orientation.

• Casting sounds no longer play repeatedly.

• Spells being cast at the moment of death are no longer swallowed.

• Entity and dimension blacklists now also apply to spells triggered by death and kills.

• Global cooldown: after one cast, all spells share a cooldown. Disabled by default; used to prevent a Boss from dumping its entire spell table in one round.

• Spell circle particle count is adjustable; Boss effects return to “large ring under the feet + pulse + shockwave + interrupt smoke.”

3. Tamed Branching and Pets

• Tamed branching: use select.tamed to give tamed mobs a different rule set, switching automatically at the moment of taming.

• When the owner is attacked, nearby pets retaliate against the attacker; “active targeting” can be enabled so pets find the nearest enemy themselves.

• Pet casting consumes the owner’s mana; the consumption ratio is adjustable.

• Pet spell cooldowns are calculated as “the spell’s own cooldown × 2,” clamped to 60–600 ticks.

• Pet casting priority can be set separately per mob type; pets do not cast while sitting, but can still learn scrolls.

4. Scroll Learning

• For tamed pets, drop a spell scroll at their feet; a spell circle of the corresponding school lights up on the ground, and after about 5 seconds the scroll is consumed and the pet learns the spell.

• A scroll with the same name but a higher level overwrites the old level, and an extra ring of spiraling upward particles appears on the spell circle.

• Blacklisted spells draw a black spell circle and leave the scroll in place; learning cooldown and count limits also show messages.

• Only mobs with the spellmob_learner tag (or "learner": true in the datapack) can learn; by default, only scrolls dropped by you count.

5. Bosses, Drops, and Health Bars

• Special mob drop fixes: drop rules written in variants now actually take effect; multiple drop rules are resolved simultaneously; files with only drops and no spells also work.

• Boss drops are no longer empty.

• Boss phase locking: add sticky to a variant so a Boss will not revert to the previous phase even if healed back up.

• Boss health bar: toggleable, color configurable, visibility distance configurable; by default it is only shown for entities with the spellmob_boss tag.

• Individual entities can toggle their health bar independently: within the same species, one can show it and another can hide it.

• Health bar displays casting: while a Boss is casting, the health bar name changes to “Name is casting xxx.”

• Boss post-fight reset: after all players have stayed far away for a while, the Boss heals to full, returns to phase 1, and retains learned spells.

6. Adaptive Bosses

• Bosses with the spellmob_adaptive tag (or "adaptive": true in the datapack) remember what spells players who fought them cast.

• After a player is defeated by it, the next time they come, it randomly learns one spell from the previous record and always casts it at the highest level.

• By default it learns only 1 spell in its lifetime, configurable; teleport, Blood Step, dodge, and summon-type spells are prohibited from learning by default.

• If you find that “it learned it but never casts it,” it is most likely busy with melee; set learnedPriority to 0.

7. Commands, Examples, and Upgrade Notes

• Two new commands: /spellmob dump spells exports all spell IDs to a file; /spellmob resetcooldown resets pets’ learning cooldown.

• Four new built-in examples: a wolf named Bryan, an iron golem named king, a wither skeleton demonstrating world conditions, and a zombified piglin demonstrating caster states.

• Upgrade notes

  • Upgrading from 2.0.x to 2.1.0: existing datapacks require no changes and continue to work; all new features are optional.

  • The config file will automatically add the new [adaptive], [scrollLearning], [pets], and [bosses] sections and their default values.

  • After changing datapacks, run /reload first, then /spellmob resync; if only the config file is changed, restart the game or server.
    

    The newly added built-in JSON files can be used for testing and do not affect normal gameplay.

    # king: If the player dies while challenging king, king will gain several spells that the player used during the challenge. After the player respawns and comes to challenge king again, king will cast the spells it obtained from the player (at the highest level of each spell). If the player defeats king, the next summoned king will return to its initial state;
    The red health bar comes from the global config `bossBarColor="red"`;
    `/summon minecraft:iron_golem ~ ~ ~5 {CustomName:'{"text":"king"}',PersistenceRequired:1b}`

    Wolf: Use a name tag or command to rename a wolf to “Bryan”; it will gain the Fang Strike spell. If Bryan is then tamed, it can learn new spells (throw a spell scroll to it and wait).
    # Zombie: The three variants are “with health bar,” “without health bar comparison,” and “world state.”
    `/summon minecraft:zombie ~ ~ ~5 {Tags:["spellmob_test_state"],PersistenceRequired:1b,Fire:-1s}`
    `/summon minecraft:zombie ~ ~ ~5 {Tags:["spellmob_test_state_nobar"],PersistenceRequired:1b,Fire:-1s}`
    `/summon minecraft:zombie ~ ~ ~5 {Tags:["spellmob_test_world"],PersistenceRequired:1b,Fire:-1s}`

    # Blaze: caster states (in lava / on fire)
    `/summon minecraft:blaze ~ ~ ~5 {Tags:["spellmob_test_lava"],PersistenceRequired:1b}`

    # Stray: frozen state
    `/summon minecraft:stray ~ ~ ~5 {Tags:["spellmob_test_frozen"],PersistenceRequired:1b}`

    # Wither Skeleton: world states (time/weather/moon phase/dimension/difficulty/in water)
    `/summon minecraft:wither_skeleton ~ ~ ~5 {Tags:["spellmob_test_world"],PersistenceRequired:1b}`

    # Zombified Piglin: caster states (mutually exclusive forms for on fire/in lava/in water/frozen)
    `/summon minecraft:zombified_piglin ~ ~ ~5 {Tags:["spellmob_test_self"],PersistenceRequired:1b}`