mirror of
https://github.com/brues-code/ClassicAPI.git
synced 2026-11-16 16:10:36 +00:00
A ClassicAPI extension. actor:PlaySpellVisual(spellID [, target [, castTimeMs]]) plays the visual of a spell cast between two actors. It follows the steps of the world chain between two units. That chain depends on units, missile objects and world objects, and an actor has none of them, so model/SceneSpell.cpp repeats each step on actor models: - The visual comes from GetSpellVisualRecord (0x006EC1E0), which also makes the violenceLevel swap. The cast time comes from FUN_GET_CAST_TIME, unless the caller gives one. The speed is Spell +0x94. - Precast (0x006EC220): the visual's +0x04 kit loops on the caster for the cast time. - Cast: the +0x08 kit plays once. A visual with a missile (+0x18 set, speed above 0, a target other than the caster) makes the +0x1C model, or Spells\ErrorCube.mdx, as the launcher 0x0060A3D0 does. Without a missile, the impact plays at once (0x006E8BF0). - Release: at the caster model's $CSL, $CSR or $CST event. The actor model gets the engine's event callback (CM2Model::SetEventCallback, 0x007133A0), as a unit's model does (0x00607800). Without the event, the release follows ReleaseMissilesFromHand (0x0060C9B0): it uses the first of those events that the model has, else the caster's position. The release then happens when the cast kit has no animation, when the cast animation ends, or 2000 ms after the queue. - Flight (0x0061CEB0, 0x0061E2A0): the speed is fitted to the time the missile was queued (t = d/speed - queued, capped at 100). The missile plays 144 InFlight and turns to its direction of travel. It aims each frame at the target's attachment: +0x24 through s_spellVisualAttachments (0x00860A18), else 15, else 19, else 0.75 of the target's height. The +0x28 sound loops through the 2D loop player 0x00458900 until arrival, then fades over 0.15 s. - Arrival (0x0061DC50): the target plays its wound animation, then the +0x0C impact kit. A +0x30 impact model stays at the point until it has no live particles (the impact list, 0x0061E930). A kit's animation plays in place of the actor's animation. It does not fire OnAnimFinished, and SetAnimation cancels it. Kit sounds play through the by-ID player. Sound::Play gets a small header (PlayKitID, PlayKitLooped, Stop) so that other modules can start a sound and stop it safely. M2.h gets the event, particle and attachment helpers, and VisualKit exposes its loop callback.