Elemental storms and charged release
Shared storm delivery, two-element infusion and the native material contract.
The storm family uses one server entity and one material-driven native effect. Tempest retains its travelling vortex geometry and timing; the other three spells select elemental payloads, colours and sparse particle sheets.
What it does
ElementalStormSpell implements the internal spell workflow through IStormSpell. StormElement supplies the four spell IDs and payloads. Players use the existing Spell Engine adapter; NPCs can use the same IEntitySpell casting surface.
| Spell ID | School | RGB24 | Sheet |
|---|---|---|---|
isekaiexpansion:tempest | Wind | 0x7DFF7A | 0 |
isekaiexpansion:ignis_maelstrom | Fire | 0xFF7434 | 1 |
isekaiexpansion:nereid_vortex | Water | 0x42BDEB | 2 |
isekaiexpansion:gaia_cyclone | Earth | 0xDDAA58 | 3 |
Runtime model
Each storm is tier 5, with a 2-second cast, 14-second cooldown and 24-block target search. Base lifetime is 120 ticks (6 seconds), damage radius 1.8 blocks and pull radius 3.6 blocks. The server applies one payload every 10 ticks (0.5 seconds), 1 + 0.3P before defences and tuning. The authored energy entry is 28 for each spell.
The STORM form allows one distinct storm partner: two total elements. Existing formula validation limits contents and requires the same form; its partner weight/energy/strain share is 0.45. Infusion alternates payload schools within the original pulse cadence. It does not create a second entity or double hit frequency. Main/sub element indices are tracked and saved by the entity.
All four storms use hold-and-release casting. Release at or above a 0.2 hold ratio, with 0.8 output scaling. With the default linear curve, output is 0.2 + 0.8 × ratio; damage uses that output and size uses its square root. At minimum release the output is 0.36 and size is 0.6; full release is 1. Direct NPC casts use full output; castCharged accepts an explicit ratio.
Spell descriptions pass through the translation formatter before custom tokens are substituted. Write literal percentages as 20%% in language sources so the tooltip displays 20%.
Contracts
The native ID is isekaiexpansion:studio/elemental-storm/elemental-storm. EntityEffekAPI owns the entity-bound handle and live inputs. The original Tempest graph retains all 12 nodes and all simulation fields. Existing ribbon/track layers carry the two colours; broad spiral masks stay smooth. Sparse sprites select wind debris, flame, bubble or rock textures. A distinct secondary track uses 0.55 opacity to preserve the main-colour hierarchy.
| Dynamic input | Type | Default | Meaning |
|---|---|---|---|
0 | float containing integer | 0x7DFF7A | Main RGB24, 0–16777215. |
1 | positive float | 1 | Live overall size; geometry and entity magnitude agree. |
2 | float containing integer | 0x7DFF7A | Secondary RGB24; use main colour for solo storms. |
3 | float containing integer | 0 | Main sheet + 8 × secondary sheet; each sheet is 0–3. |
Trigger 0 stops generation; the authored drain allowance is 180 frames. Keep handle lifetime attached to the entity. A detached one-shot spawn cannot implement cancellation. Quantize packed selectors with floor(value + 0.5) before modulo: interpolated values just below an integer otherwise select no texture and create speckling.
Only the original wind palette with the wind sheet preserves the original vertex hues. All other palettes use the maximum vertex RGB channel as brightness, then apply the selected RGB24 colour. This removes inherited green from non-wind currents, including track vertices whose red channel is zero. Both lanes select this policy independently, so an infusion retains each element’s colour. Regression tests cover all 16 main/secondary pairs and custom red, blue, magenta and white palettes reusing the wind sheet.
Extending it
Charge support is shared by custom entity spells:
var spell = IsekaiSpellDefinitionBuilder.custom(school)
.tier(5).charge(2, .2F, .8F)
.cursorTarget().release().cooldown(14).build();
Use IEntitySpell.castCharged(caster, target, tuning, ratio) for an explicit non-player release. The adapter uses the authoritative charge ratio supplied by Spell Engine. SpellCharging applies its curve once into SpellTuning; payload implementations must use tuning potency and magnitude. The charge scalar does not alter velocity or lifetime. This is internal spell authoring, not a public facade for other mods.
Verifying
Run the charge and formula tests and compile Java. In the native studio, compare the original Tempest and a combined storm at the same seed, frame, camera and size. Check integer selector boundaries, single-element variants, daylight, prolonged holding, release and cancellation. Studio regression tests compare all simulation fields against the original source.
In Minecraft, verify player and NPC casts, earliest/full release, moving targets, terrain obstruction, two-element alternation, reload/rejoin and observer synchronisation. Native compilation and browser review do not prove in-game rendering parity.