Skip to content

0x2C — CHAR_PERSIST

Resolves a character and calls CSsfHandler2::SetPersistenceAll(bool) or CCharacter::SetPersistenceWithChild(bool, name); the boolean comes from arg bit 7.

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

Opcode0x2C (44)
HandlerCRadiScript::Command_2c
SignatureCRadiScript::Command_2c(int,SCR_DATA*,unsigned int,unsigned int)
Translation unitr_script_run2.cpp
Address— debug build; click for all 3
Handler size0x164 (356 bytes)
FamilyCharacters
Command size4 + extra_words * 4 bytes

Handler behaviour

Resolves a character and calls CSsfHandler2::SetPersistenceAll(bool) or CCharacter::SetPersistenceWithChild(bool, name); the boolean comes from arg bit 7.

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   |  0x2C          |
+----------------+----------------+----------------+----------------+

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:

  • CCharacter::SetPersistenceWithChild
  • CSsfHandler2::SetPersistenceAll