Reverse Engineering: Gundam VS. Series - Gundam vs. Zeta Gundamre-gvs-gvzg
RESEARCH NOTEBOOK Local edition

Render-hook interface and patch generator

Project reference

This small export shows where the render-only path attaches to generated C++. It includes the original render_hooks.hpp interface and gundam_render_hooks.py helper, plus a wrapper that retains the later input and cue-clock corrections.

The address map connects 13 guest instruction sites to five generated units. An instruction address and its containing generated label can differ: the compiler groups instructions into C++ blocks.

Inspect the boundary

Swipe or scroll horizontally to read all columns.

Unit Main responsibility
unit_0039.cpp Model-copy and attachment-transform hooks
unit_0044.cpp Mode-update branch, camera preparation and render completion
unit_0049.cpp Application counters, input copy and corrected pre-poll gate
unit_004D.cpp Screen-effect update gate
unit_0047.cpp Corrected cue-clock store

Read the rendering-boundary chapter for the mechanism and manifest.json for supported inputs, retained output hashes and original source paths.

Verify the export without game files

python3 research/source/render-hooks/verify.py

This checks exported file fingerprints and mapping integrity. It does not compile the game or prove hook semantics. The separate input regression executes the bounded input-edge test.

Apply to matching generated inputs

If you already have the five generated units identified in the manifest:

python3 research/source/render-hooks/prepare.py \
  --generated PATH_TO_MATCHING_GENERATED_UNITS \
  --output .local/patched-render-units

The wrapper refuses different input hashes and existing output directories. It stages all five units, checks their hashes against retained research outputs, then writes the result. It does not modify the supplied inputs.

The shared helper predates the 0x226D30 input fix and 0x21C688 cue fix. Running it alone omits those corrections; use the wrapper for the combined patch set.

Local export validation reproduced all five retained output hashes. A changed-input control and an existing-output control were rejected. These are patch-generation checks, not a new game run.

Complete game integration

The complete repository now supplies the controller and interpolation in src/hooks/, the browser host in apps/game/, explicit runtime patches in patches/, the pinned runtime in vendor/, and the retained generated input in generated/. The game setup guide links these pieces through a fresh source build.

This directory remains the focused interface/patch package. It is not a generic high-refresh library for other games or regional releases. The original disc is supplied by the user; generated units are included separately in the repository.