0xC7 — PERSON_INCLUDE
Resolves a character and calls CCharacterPerson::SetIncludeCharacter.
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 | 0xC7 (199) |
|---|---|
| Handler | CRadiScript::Command_c7 |
| Signature | CRadiScript::Command_c7(int,SCR_DATA*,unsigned int,unsigned int) |
| Translation unit | r_script_runc.cpp |
| Address | — debug build; click for all 3 |
| Handler size | 0x140 (320 bytes) |
| Family | Person, battle and effects |
| Command size | 4 + extra_words * 4 bytes |
Handler behaviour
Resolves a character and calls CCharacterPerson::SetIncludeCharacter.
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 | 0xC7 |
+----------------+----------------+----------------+----------------+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:
CCharacterPerson::SetIncludeCharacter