0x81 — VIB_SEQ_PLAY
Resolves a character abstraction, locates act data through CCharacterManager::_get_act_data and GetKodsAddress, then calls CVibPlayer::AttachData and CVibPlayer::PlayVibSequence.
traced— handler traced, but no shipped script uses this opcode, so the operand layout rests on the trace alone with no real data to check it against.
At a glance
| Opcode | 0x81 (129) |
|---|---|
| Handler | CRadiScript::Command_81 |
| Signature | CRadiScript::Command_81(int,SCR_DATA*,unsigned int,unsigned int) |
| Translation unit | r_script_run8.cpp |
| Address | — debug build; click for all 3 |
| Handler size | 0x1AC (428 bytes) |
| Family | Vibration, dialogue and text |
| Command size | 4 + extra_words * 4 bytes |
Handler behaviour
Resolves a character abstraction, locates act data through CCharacterManager::_get_act_data and GetKodsAddress, then calls CVibPlayer::AttachData and CVibPlayer::PlayVibSequence.
Encoding
The command header is one 32-bit word, as described in §3 Instruction encoding:
31 24 23 16 15 8 7 0
+----------------+----------------+----------------+----------------+
| flags | argument byte | extra words | 0x81 |
+----------------+----------------+----------------+----------------+Bits 8–15 give the number of 32-bit operand words that follow. Bits 16–23 are handed to the handler as a bitfield; on character commands bit 0 normally says whether a character selector word is present. Bit 31 is the keep-going bit.
Engine calls
Engine functions this handler was observed calling:
CVibPlayer::AttachDataCVibPlayer::PlayVibSequence