Files
OpenMaidEngine/docs/engine-ctx-reference.md
gamer147 c3729170dc re: EngineCtx field registry (engine-ctx.toml) + builder
Canonical source vm-map/engine-ctx.toml (35 documented ctx fields) +
engine_ctx_build.py (--build/--lint, unit-tested) -> build/engine-ctx.json
+ docs/engine-ctx-reference.md. Applied to Ghidra in the next task.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 10:01:54 -04:00

3.5 KiB

EngineCtx field reference

Generated from vm-map/engine-ctx.toml by tools/engine_ctx_build.py --build. Do not edit.

Struct EngineCtx, size 0xa1000. Applied to the Ghidra /v2 image (dispatch-handler this = EngineCtx *).

offset name type note
0x408 gfx_obj_registry int gfx object registry (std::map handle->object); op 0x1a2 insert / 0x215 find
0x40c sys4ini_count int SYS4INI record count
0x410 archive_name_table void* archive-name table base (arc_id*0x100 indexes it)
0x414 sys4ini_records void* SYS4INI 80-byte record base {name[64],arc_id,file_number,offset,size}; record = base + id*0x50
0x3028 alt_pack_table int call-script high-byte alternate pack table (unused by corpus)
0xb558 gfx_dirty_a int gfx dirty flag (anim set raises)
0xb560 gfx_dirty_b int gfx dirty flag
0x14d54 gfx_obj_ptr_table void* per-object pointer table (ops 0x212/0x213 write obj+0x64/0x68/0x6c)
0x14f45 script_frame_index int call-script frame index (0x1e-dword frames)
0x46d14 query_table_46d14 void* stride-0x14 table read by op 0x216
0x51b64 frame_timer int frame timer (present updates 0x51b64/0x51b68)
0x51b78 anim_clock_elapsed int global anim clock elapsed (op 0x238 zeroes)
0x51b7c anim_clock_duration int global anim clock total duration (op 0x238 sets)
0x52bd4 surfaces void* surface array base [~1000 slots]; create/set-texture (0x1f8/0x1f9) allocate
0x53d14 cur_ctx_index uint current gfx-object / script-context index (curCtx); indexes 0x78-byte records
0x53d28 frame_codebase void* current frame codebase (PC = codebase + off*4)
0x53d2c frame_pc int current frame PC column (op = (0x53d2c + curCtx0x78))
0x53d60 ctx_record_base void* 0x78-byte context-record array base (coroutine/script contexts)
0x53d64 gfx_obj_record_array void* gfx object-record array (field[0]=0xffffffff free; cmd-type at rec+0x24)
0x53d88 cmd_type_table int per-object cmd-type column base (write (0x53d88 + curCtx0x78))
0x55120 anti_tamper_a int anti-tamper checksum operand
0x55124 anti_tamper_b int anti-tamper checksum operand
0x5512c anti_tamper_fp int anti-tamper (import fn ptr / result)
0x55248 ret_stack_a void* per-frame return stack (op 0x8f call pushes)
0x552e8 ret_stack_b void* per-frame return stack (companion)
0x5f304 sleep_timer int sleep timer object (op 0xc8; +8 active, +0x14 start-ms, +0x18 duration)
0x6da88 coroutine_yield_a void* op 0x7b yield-state save (op1 -> +ctxidx*4)
0x6db28 coroutine_yield_b void* op 0x7b yield-state save (op2 -> +ctxidx*4)
0x6dbc8 coroutine_runstate int op 0x7c resume gate (run-state bit 0x2000000)
0x6dbcc coroutine_resume_off int op 0x7c resume PC offset
0x9b24c dispatch_table void* opcode->handler table base [0x400]; handler(op) = (0x9b24c + op4)
0xa0cc0 screen_w int screen width (640)
0xa0cc4 screen_h int screen height (480)
0xa0cc8 screen_bpp int screen bpp (8)
0xa0ce4 run_state_flags uint interpreter run-state flags (bit1 sleeping; 0x8000000 skip/fast-forward)