Update Healer Man server

docs/ROM_SPELL_MEDIA_MAPPING.md

@@ -0,0 +1,206 @@
+# RuneWaker primary-five spell media mapping
+
+Generated by `node scripts/combat-effects/audit-rom-media.mjs --write` from the player catalog and combat effect manifest. The five accepted pairings follow `src/game/romFiveIdentities.ts`. Castable skills are listed; passives have no cast media event.
+
+The effect column records original client ROS/RAS references and their cast phase. 6 castable skills have browser-playable original phases; other source visuals use the game's generated runtime effect until their controller families are supported. The sound column lists client cues that are packaged and played on their mapped phase. A dash means the source record or matching sound file did not provide that media.
+
+| Primary class | Skill group | Castable skills | With source effect | With packaged sound | With playable original effect |
+| --- | --- | ---: | ---: | ---: | ---: |
+| Priest | Base | 25 | 19 | 18 | 3 |
+| Priest | Accepted elite pair | 6 | 6 | 4 | 0 |
+| Knight | Base | 19 | 17 | 14 | 2 |
+| Knight | Accepted elite pair | 6 | 6 | 3 | 0 |
+| Scout | Base | 20 | 16 | 14 | 0 |
+| Scout | Accepted elite pair | 4 | 4 | 3 | 0 |
+| Rogue | Base | 20 | 10 | 9 | 0 |
+| Rogue | Accepted elite pair | 4 | 4 | 2 | 0 |
+| Mage | Base | 21 | 20 | 11 | 1 |
+| Mage | Accepted elite pair | 5 | 5 | 5 | 0 |
+
+## Priest — base
+
+| Skill | Source spell IDs | Effect phase and source model | Sound phase and source cue |
+| --- | --- | --- | --- |
+| Soul Source | 490288 | — | — |
+| Wave Armor | 490273 | impact: act_holywater_armor_t_top.ros<br>aura-start: act_watershieldbuff_c_down_i.ros | impact: act_holywater_armor_t_top.mp3 |
+| Heal | 490261 | cast-start: act_casting_c_hand.ros | cast-start: act_casting_c_hand.wav |
+| Ice Fog | 490274 | cast-start: act_cone01_c_hand.ros | cast-start: act_cone01_c_hand.mp3 |
+| Bone Chill | 491165 | cast-start: act_ice_hand_wave_c_hand_e.ros | — |
+| Resurrection | 490280 | cast-start: act_casting_c_hand.ros<br>impact: act_anabiosis_t_down.ros | cast-start: act_casting_c_hand.wav<br>impact: act_anabiosis_t_down.mp3 |
+| Soul Bond | 490297 | cast-start: act_casting_c_hand.ros | cast-start: act_casting_c_hand.wav |
+| Grace of Life | 490290 | — | — |
+| Group Heal | 490281 | cast-start: act_casting_c_hand.ros | cast-start: act_casting_c_hand.wav |
+| Chain of Light | 491164 | cast-start: act_light_chain_c_hand_i.ros<br>impact: act_light_chain_t_down_i.ros<br>impact: act_light_chainhit_t_down_e.ros | impact: act_light_chain_t_down_i.mp3 |
+| Amplified Attack | 490491 | cast-start: act_casting_c_hand.ros | cast-start: act_casting_c_hand.wav |
+| Ice Fog | 490275 | cast-start: act_cone01_c_hand.ros | cast-start: act_cone01_c_hand.mp3 |
+| Healing Salve | 490294 | — | — |
+| Blessing of Humility | 490301 | — | — |
+| Ice Fog | 490276 | cast-start: act_cone01_c_hand.ros | cast-start: act_cone01_c_hand.mp3 |
+| Holy Candle | 490304 | — | — |
+| Cleanse | 491175 | impact: act_dispersion_t_freeze_hit_e.ros | impact: act_dispersion_t_freeze_hit_e.mp3 |
+| Advanced Resurrection | 491176 | cast-start: act_casting_c_hand.ros<br>impact: act_anabiosis_t_down.ros | cast-start: act_casting_c_hand.wav<br>impact: act_anabiosis_t_down.mp3 |
+| Supreme Resurrection | 491177 | cast-start: act_casting_c_hand.ros<br>impact: act_anabiosis_t_down.ros | cast-start: act_casting_c_hand.wav<br>impact: act_anabiosis_t_down.mp3 |
+| Urgent Heal | 491147 | cast-start: act_casting_c_hand.ros | cast-start: act_casting_c_hand.wav |
+| Rising Tide | 490256 | cast-start: act_icecone01_c_hand.ros<br>release: act_icecone01_f.ros | cast-start: act_icecone01_c_hand.wav |
+| Regenerate | 490269 | cast-start: act_casting_c_hand.ros<br>cast-start: act_holy_hand_wave_c_hand_e.ros | cast-start: act_casting_c_hand.wav |
+| Holy Aura | 490300 | cast-start: act_casting_c_hand.ros<br>cast-start: act_flash_candle_c_down_e.ros | cast-start: act_casting_c_hand.wav |
+| Magic Barrier | 491166 | — | — |
+| Blessed Spring Water | 490298 | cast-start: act_icecone01_c_hand.ros | cast-start: act_icecone01_c_hand.wav |
+
+## Priest — accepted elite pair
+
+| Skill | Source spell IDs | Effect phase and source model | Sound phase and source cue |
+| --- | --- | --- | --- |
+| Last Prayer | 491648 | impact: act_benedictory_heal_t_down.ros | impact: act_benedictory_heal_t_down.mp3 |
+| Divine Incarnation | 491366 | cast-start: act_sacredincarnation_c_down.ros | cast-start: act_sacredincarnation_c_down.mp3 |
+| Calm Heart | 492639 | cast-start: act_casting_c_hand.ros<br>impact: act_fearless_t_down_e.ros | cast-start: act_casting_c_hand.wav |
+| Sacrificial Cure | 492934 | cast-start: act_scrifice_healing_c_freeze_down_e.ros<br>impact: act_scrifice_healing_t_down_e.ros | — |
+| Holy Power | 493044 | cast-start: act_holyenergy_c_down_e.ros<br>cast-start: act_holyenergy_c_down_i.ros | — |
+| Light Fairy | 493271 | cast-start: act_casting_c_hand.ros<br>cast-start: act_beckon_holy_c_freeze_down_e.ros | cast-start: act_casting_c_hand.wav |
+
+## Knight — base
+
+| Skill | Source spell IDs | Effect phase and source model | Sound phase and source cue |
+| --- | --- | --- | --- |
+| Holy Shield | 490495 | cast-start: act_godshield_c_down.ros | cast-start: act_godshield_c_down.mp3 |
+| Holy Seal | 490149 | impact: act_sanink_c_hit_point_e.ros | impact: act_sanink_c_hit_point_e.mp3 |
+| Holy Power Explosion | 490172 | cast-start: act_physical_casting_c_hand.ros<br>cast-start: act_vengeance_c_down.ros | cast-start: act_physical_casting_c_hand.mp3<br>cast-start: act_vengeance_c_down.mp3 |
+| Whirlwind Shield | 490175 | cast-start: act_shieldstorm_c_down_e.ros<br>impact: act_shieldstorm_t_freeze_hit_e.ros | — |
+| Shackles of Light | 490189 | cast-start: act_chain_c_shoot02.ros | cast-start: act_chain_c_shoot02.mp3 |
+| Resolution | 490168 | cast-start: act_physical_casting_c_hand.ros<br>cast-start: act_responsibility_c_down.ros | cast-start: act_physical_casting_c_hand.mp3<br>cast-start: act_responsibility_c_down.mp3 |
+| Charge | 490150 | cast-start: act_charge02_c_down.ros | cast-start: act_charge02_c_down.mp3 |
+| Threaten | 490153 | — | — |
+| Shield of Valor | 490468 | cast-start: act_courage_shield_c_top.ros | cast-start: act_courage_shield_c_top.mp3 |
+| Truth Shield Bash | 490186 | cast-start: act_truth_shield_c_top.ros | cast-start: act_truth_shield_c_top.mp3 |
+| Shock | 490154 | cast-start: act_holy_hand_wave_c_hand_e.ros | — |
+| Holy Strength | 491321 | cast-start: act_manafreeback_c_down_e.ros | cast-start: act_manafreeback_c_down_e.mp3 |
+| Hall of Dead Heroes | 495724 | aura-start: act_herosoul_buff_c_top.ros | aura-start: act_herosoul_buff_c_top.mp3 |
+| Punishment | 490151 | cast-start: act_holy_hand_wave_c_hand_e.ros | — |
+| Holy Strike | 490148 | impact: act_san_sword_t_down_e.ros | impact: act_san_sword_t_down_e.mp3 |
+| Disarmament | 490159 | — | — |
+| Strike of Punishment | 490179 | impact: act_brokenhit_t_hit_point.ros | impact: act_brokenhit_t_hit_point.mp3 |
+| Enhanced Armor | 490152 | cast-start: act_armorup_c_top.ros | cast-start: act_armorup_c_top.mp3 |
+| Shield of Discipline | 490192 | cast-start: act_discipline_shield_c_top.ros | cast-start: act_discipline_shield_c_top.mp3 |
+
+## Knight — accepted elite pair
+
+| Skill | Source spell IDs | Effect phase and source model | Sound phase and source cue |
+| --- | --- | --- | --- |
+| Arrow of Vengeance | 491616 | release: act_revengearrow_f_i.ros<br>impact: act_revengearrow_t_hit_point_e.ros | impact: act_revengearrow_t_hit_point_e.mp3 |
+| Holy Chains | 491613 | impact: act_chain_t_down.ros | impact: act_chain_t_down.mp3 |
+| Heavenly Arrow | 491354 | cast-start: act_holy_hand_wave_c_hand_e.ros<br>impact: act_heavenarrow_t_down_e.ros | impact: act_heavenarrow_t_down_e.mp3 |
+| Sacred Resistance | 492939 | cast-start: act_holyresist_c_down_e.ros | — |
+| Sacred Protection | 493046 | cast-start: act_holyprotect_c_down_e.ros<br>impact: act_ingoreself_t_down_e.ros | — |
+| Disregard Danger | 493273 | cast-start: act_fire_hand_wave_c_hand_e.ros<br>impact: act_ingoreself_t_down_e.ros | — |
+
+## Scout — base
+
+| Skill | Source spell IDs | Effect phase and source model | Sound phase and source cue |
+| --- | --- | --- | --- |
+| Arrow of Essence | 490494 | — | — |
+| Wind Arrows | 491128 | release: act_gustwindarrow_f_hit_point_i.ros<br>impact: act_gustwindarrow_t_hit_point_e.ros | impact: act_gustwindarrow_t_hit_point_e.mp3 |
+| Mana Drain Shot | 490441 | release: act_sorcerersting_f.ros | release: act_sorcerersting_f.mp3 |
+| Lasso | 490454 | cast-start: act_casting_c_hand.ros | cast-start: act_casting_c_hand.wav |
+| Piercing Arrow | 490400 | release: act_immolatingshot_f.ros | release: act_immolatingshot_f.mp3 |
+| Snipe | 490450 | release: act_snipe_f.ros | release: act_snipe_f.mp3 |
+| Detection | 490463 | cast-start: act_focus_c_top.ros | cast-start: act_focus_c_top.mp3 |
+| Combo Shot | 490424 | release: act_arrow_f.ros | release: act_arrow_f.mp3 |
+| Neck Strike | 490438 | impact: act_neckattack_t_mouth.ros | impact: act_neckattack_t_mouth.mp3 |
+| Reflected Shot | 490457 | release: act_deflecting_shot_f.ros | release: act_deflecting_shot_f.mp3 |
+| Concentration | 490460 | impact: act_concentration_t_top.ros | impact: act_concentration_t_top.mp3 |
+| Target Area | 490464 | cast-start: act_physical_casting_c_hand.ros<br>cast-start: act_shooterexpert_c_down.ros | cast-start: act_physical_casting_c_hand.mp3<br>cast-start: act_shooterexpert_c_down.mp3 |
+| Frost Arrow | 491163 | release: act_icearrow_f.ros | release: act_icearrow_f.mp3 |
+| Autoshot | 492589 | release: act_normalarrow_f_i.ros | — |
+| Shot | 490423 | release: act_arrow_f.ros | release: act_arrow_f.mp3 |
+| Vampire Arrows | 491292 | release: act_bitesbloodarrow_f_hit_point_i.ros<br>impact: act_bitesbloodarrow_t_hit_point_e.ros<br>impact: act_bloodstain_t_freeze_down.ros | impact: act_bitesbloodarrow_t_hit_point_e.mp3<br>impact: act_bloodstain_t_freeze_down.mp3 |
+| Joint Blow | 490420 | — | — |
+| Blood Arrow | 490434 | cast-start: act_fear_c_hand.ros | — |
+| Throat Attack | 490428 | — | — |
+| Wrist Attack | 490451 | — | — |
+
+## Scout — accepted elite pair
+
+| Skill | Source spell IDs | Effect phase and source model | Sound phase and source cue |
+| --- | --- | --- | --- |
+| Weak Spot | 491493 | release: act_bitesbloodarrow_f_hit_point_i.ros<br>impact: act_lockbuff_t_top.ros | impact: act_lockbuff_t_top.mp3 |
+| Blinding Powder | 491336 | impact: act_blindpowder_t_top_e.ros | impact: act_blindpowder_t_top_e.mp3 |
+| Sapping Arrow | 491496 | release: act_weakarrow_f_i.ros<br>impact: act_weakarrow_t_freeze_hit_e.ros | impact: act_weakarrow_t_freeze_hit_e.mp3 |
+| Deadly Poison Bite | 492621 | cast-start: act_poison_casting_c_hand.ros<br>release: act_deadlypoison_f_i.ros<br>impact: act_deadlypoison_t_hit_point_e.ros | — |
+
+## Rogue — base
+
+| Skill | Source spell IDs | Effect phase and source model | Sound phase and source cue |
+| --- | --- | --- | --- |
+| Assassins Rage | 490506 | cast-start: act_absolute_strike_c_top.ros | cast-start: act_absolute_strike_c_top.mp3 |
+| Low Blow | 490323 | — | — |
+| Wound Attack | 490313 | — | — |
+| Blind Spot | 490311 | — | — |
+| Numbing Dagger | 490347 | cast-start: nor_dark_casting.ros<br>release: act_throw01_f.ros | release: act_throw01_f.mp3 |
+| Poison | 490329 | cast-start: act_apply_poison_c_hand.ros | cast-start: act_apply_poison_c_hand.mp3 |
+| Hide | 490312 | cast-start: act_snug_c_freeze_down.ros | cast-start: act_snug_c_freeze_down.mp3 |
+| Premeditation | 490507 | — | — |
+| Sneak Attack | 490337 | — | — |
+| Vanish | 490354 | cast-start: act_hiding_c_freeze_down.ros | cast-start: act_hiding_c_freeze_down.mp3 |
+| Sprint | 490341 | — | — |
+| Evasion | 490355 | cast-start: act_illusionmoving_c_down.ros | cast-start: act_illusionmoving_c_down.mp3 |
+| Combo Throw | 490338 | release: act_throw01_f.ros | release: act_throw01_f.mp3 |
+| Shadow Prison | 490346 | cast-start: act_dark_hand_wave_c_hand_e.ros | — |
+| Informer | 490350 | — | — |
+| Fervent Attack | 490333 | cast-start: act_attackspeedup_c_down.ros | cast-start: act_attackspeedup_c_down.mp3 |
+| Shadowstab | 490306 | — | — |
+| Throw | 490309 | release: act_throw01_f.ros | release: act_throw01_f.mp3 |
+| Blind Stab | 490317 | — | — |
+| Shadow Step | 490344 | — | — |
+
+## Rogue — accepted elite pair
+
+| Skill | Source spell IDs | Effect phase and source model | Sound phase and source cue |
+| --- | --- | --- | --- |
+| Death's Touch | 491339 | cast-start: act_dark_hand_wave_c_hand_e.ros<br>impact: act_deathtouch_t_down_e.ros | impact: act_deathtouch_t_down_e.mp3 |
+| Poisonous Infection | 492625 | impact: act_poisondot_t_down.ros | impact: act_poisondot_t_down.mp3 |
+| Poison Spray | 492920 | cast-start: act_earth_hand_wave_c_hand_e.ros<br>impact: act_vriusinfection_t_freeze_down_e.ros | — |
+| Decay | 493017 | impact: act_rot_t_down_e.ros | — |
+
+## Mage — base
+
+| Skill | Source spell IDs | Effect phase and source model | Sound phase and source cue |
+| --- | --- | --- | --- |
+| Elemental Catalysis | 490238, 497971 | cast-start: act_casting_c_hand.ros<br>cast-start: act_castup01_c_down.ros | cast-start: act_casting_c_hand.mp3<br>cast-start: act_castup01_c_down.mp3 |
+| Flame | 491150 | cast-start: act_fireball01_c_hand_i.ros<br>cast-start: act_fireball02_c_hand_e.ros<br>release: act_fireball01_f_i.ros | — |
+| Electrostatic Charge | 491156 | cast-start: act_casting_c_hand.ros<br>cast-start: act_electricfield_c_top.ros<br>aura-start: act_electricfieldbuff_c_down_i.ros | cast-start: act_casting_c_hand.mp3<br>cast-start: act_electricfield_c_top.mp3 |
+| Discharge | 490242 | cast-start: act_wind_hand_wave_c_hand_e.ros<br>cast-start: act_lightningstrike_c_shoot.ros | cast-start: act_lightningstrike_c_shoot.mp3 |
+| Meteor Shower | 490252 | cast-start: act_noncasting_c_hand.ros<br>impact: act_shottingstars_t_down.ros | impact: act_shottingstars_t_down.mp3 |
+| Phoenix | 490239 | cast-start: act_vengeance_c_hand.ros<br>cast-start: act_phoenix_c_freeze_down.ros | cast-start: act_vengeance_c_hand.mp3<br>cast-start: act_phoenix_c_freeze_down.mp3 |
+| Purgatory Fire | 491153 | cast-start: act_fireball02_c_hand_e.ros<br>impact: act_fireball01_t_freeze_hit_e.ros | — |
+| Energy Influx | 490218 | aura-start: act_magebuff01_c_top.ros | aura-start: act_magebuff01_c_top.mp3 |
+| Energy Well | 490251 | impact: act_manareduce01_c_hit_point.ros | impact: act_manareduce01_c_hit_point.mp3 |
+| Elemental Weakness | 490247, 497977 | cast-start: act_casting_c_hand.ros<br>impact: act_elementdecay_t_down.ros | impact: act_elementdecay_t_down.mp3 |
+| Thunderstorm | 490244 | cast-start: act_casting_c_hand.ros<br>cast-start: act_torodo_c_freeze_down.ros | cast-start: act_casting_c_hand.mp3<br>cast-start: act_torodo_c_freeze_down.mp3 |
+| Plasma Arrow | 491169 | cast-start: act_electric_casting_c_hand_i.ros<br>release: act_electric_arrow_f_i.ros<br>impact: act_electric_explode_t_freeze_hit_e.ros | — |
+| Electric Bolt | 491168 | cast-start: act_electric_casting_c_hand_i.ros<br>release: act_electric_ball_f_i.ros<br>impact: act_electric_ball_t_freeze_hit_e.ros<br>impact: act_electric_dot_t_down_e.ros | — |
+| Electric Explosion | 491170 | cast-start: act_electric_casting_c_hand_i.ros<br>impact: act_electric_explode_f_i.ros<br>impact: act_electric_explode_t_freeze_hit_e.ros | — |
+| Electric Compression | 491171 | cast-start: act_electricnet_recharge_c_down_e.ros | — |
+| Static Field | 491172 | cast-start: act_electric_casting_c_hand_i.ros<br>cast-start: act_electric_net_c_down_e.ros<br>impact: act_electric_net_t_down_i.ros | — |
+| Fireball | 490204 | cast-start: act_fire_hand_wave_c_hand_e.ros<br>release: act_fireball02_f.ros | release: act_fireball02_f.mp3 |
+| Lightning | 490212 | cast-start: act_wind_hand_wave_c_hand_e.ros | — |
+| Intensification | 490225, 497976 | — | — |
+| Silence | 490296 | cast-start: act_casting_c_hand.ros<br>cast-start: act_dark_hand_wave_c_hand_e.ros | — |
+| Fire Ward | 490248 | cast-start: act_vengeance_c_hand.ros<br>cast-start: act_fireresistance_c_top.ros | cast-start: act_vengeance_c_hand.mp3<br>cast-start: act_fireresistance_c_top.mp3 |
+
+## Mage — accepted elite pair
+
+| Skill | Source spell IDs | Effect phase and source model | Sound phase and source cue |
+| --- | --- | --- | --- |
+| Static Resonance | 498744 | cast-start: act_electricity-field_c_down_e.ros | cast-start: act_electricity-field_c_down_e.mp3 |
+| Breath Erase | 498750 | cast-start: act_hide_c_down_e.ros | cast-start: act_hide_c_down_e.mp3 |
+| Soul Stepping | 498757 | cast-start: act_soul_walker_c_down_e.ros | cast-start: act_soul_walker_c_down_e.mp3 |
+| Deep Inspiration | 498758 | cast-start: act_deep_open_c_down_e.ros | cast-start: act_deep_open_c_down_e.mp3 |
+| Fire Lightning Burst | 498759 | cast-start: act_fireball01_c_hand_i.ros<br>cast-start: act_electric_casting_c_hand_i.ros<br>release: act_fire-thunder_f.ros<br>impact: act_fire-thunder_t_hitpoint_e.ros | impact: act_fire-thunder_t_hitpoint_e.mp3 |
+
+## Decoded particle archive
+
+The particle archive covers 123 referenced ROS models, with 7 fully decoded models and 116 partial models. 4 models are renderer-ready, including the Priest holy cast whose remaining EventTrigger is an audio callback. It exports 510 sprite controllers and 103 distinct PNG textures. See `public/assets/game/combat-effects/original/runewaker/manifest.json` for per-model details.
+
+## Next conversion step
+
+The WebGL sprite renderer plays Priest Urgent Heal, Heal, and Group Heal casting, Knight Charge cast and Whirlwind Shield impact, and Mage Electric Bolt projectile. The Priest holy model's EventTrigger starts a looping 3D WAV and is handled by phase-matched combat audio while its three sprite layers render. Next, verify more spell phases against the source motion and controller semantics before attaching their `effectGraphUrl`. The Direct3D source and packaged ROS data remain the reference for those ports.