Download docs/research/QVM_MOVEMENT_FRAME.md from nmarshall/urt-rs: direct link, hf CLI and curl.
- Browser
- Download file 7.81 kB
-
https://huggingface.co/nmarshall/urt-rs/resolve/main/docs/research/QVM_MOVEMENT_FRAME.md
- Command line
-
hf download hf://nmarshall/urt-rs/docs/research/QVM_MOVEMENT_FRAME.md
-
curl -L -o QVM_MOVEMENT_FRAME.md https://huggingface.co/nmarshall/urt-rs/resolve/main/docs/research/QVM_MOVEMENT_FRAME.md
Game-QVM movement setup and frame assembly
RE-413β415 / F-169β171. qvm-movement-frame.json retains verified shipped qagame instruction slices, 72 finite gravity/speed probes, four packed-word probes and 160 complete frame-assembly probes. Reproduce with python3 scripts/analyze_qvm_movement_frame.py; verify with python3 scripts/test_qvm_movement_frame.py.
This follows think/inactivity gates. Results are bounded synthetic instruction evaluations. No complete QVM, original executable, native callee or movement physics runs. The earlier trap100 frame-zeroing effects are supplied. Helper151954 returns are supplied with omitted side effects; helper54475 receives a recorded request only. Semantic names for fields/masks/callbacks are candidates pending consumer/producer recovery.
FRAME-001 β Finite gravity/speed and packed words (RE-413)
At instructions154441β154507, global35000452 bit0 selects zero writes to client+48 and client+52. The branch retains any entity+852 pointer instead of consuming it.
Otherwise global34086640 is treated as binary32 and converted by truncation to client+48. When entity+852 is nonzero, the value is first multiplied by binary32 at that pointed record+628, rounded to binary32, then converted. The entity+852 pointer is cleared afterward. Client+52 becomes220 on both bit0-clear paths. Gravity and speed are provisional interpretations of these two player-state words; their configuration registration and physical consumers remain open.
72 probes cover lock words0/1/2, finite base values0/800/801.9/-1.5 and absent or finite multiplier values0/0.5/1/1.5/2. Independent binary32 rounding/truncation verifies the two output words and pointer consumption. Nonfinite and out-of-int32 conversions fail closed in the model; they are not a specification of original-runtime exceptional behavior or floating-control state.
Instructions154507β154544 store global34992556 OR (global34992560 <<8) at client+288 and global35000356 OR (global35000360 <<8) at client+292, modulo32. There are no byte masks in these slices. Four fixtures include ordinary byte values and high/out-of-byte-range words, proving that an inferred two-byte packing rule would discard observed bits. Local332 preserves client+108 for later use. Meaning and legal ranges of these globals/packed words remain open.
FRAME-002 β Signed command suppression and mask gates (RE-414)
Before the frame copy, instructions154579β154653 suppress movement only when client+208 >0, client+4324 ==0 and (client+220 &2) !=0. They clear command forward/right bytes at client+493/+494. The up byte at +495 is sign-extended: it is cleared only when positive, while zero and negative values remain unchanged. Weapon, timestamps, angles and buttons are retained by this particular gate. This is separate from the earlier think gates that clear all three movement bytes/buttons.
The frame mask at local84 follows these branches:
| Condition, in priority order | Observed word |
|---|---|
| Client+4 ==3 | 65537 / 0x00010001 |
| Otherwise client+4396 nonzero and supplied helper151954(entity, linked entity) result nonzero | 65537 / 0x00010001 |
| Linked path with helper result zero | 33619969 / 0x02010001; clear own client+4396 and linked entity's client[+4396] |
| No linked path, entity+424 bit8 nonzero | 37814273 / 0x02410001 |
| Otherwise global34090788 ==9 and client+3704 nonzero | 67174401 / 0x04010001 |
| Remaining path | 33619969 / 0x02010001 |
The linked-client pointer comes from linked entity+520. Its validity, helper151954 semantics, legitimate links and cleanup effects outside these two stores remain open. Type3 takes precedence and bypasses the linked-helper call entirely. These words resemble movement trace/content masks, but this batch does not assign individual content-bit names or prove collision consumers.
Sixty command-gate fixtures cover health-like/other/flag words and up bytes0/1/127/128/255. Sixty-four mask fixtures exercise type/linked/helper/bit8/game9/condition branches. Independent checks verify exact command bytes, mask priority, pointer cleanup and recorded helper requests.
FRAME-003 β Complete supplied-zero movement frame (RE-415)
The earlier code requests trap target-101 with (local56,0,268). This is a recorded zeroing request from instructions154544β154552; its actual trap effects are supplied explicitly in these assembly fixtures. The modeled frame spans 268 bytes at local56. Offsets below are relative to that frame, not absolute QVM record offsets.
| Frame offset | Observed input |
|---|---|
| 0 | Entity's client pointer (candidate player-state pointer) |
| 4β27 | Full 24-byte command copied from client+472 after suppression |
| 28 | Selected mask from FRAME-002 |
| 32 | Raw global34085164 word |
| 220 | Raw client+712 word |
| 224 | -25 encoded callback value |
| 228 | -26 encoded callback value |
| 232 | Boolean(global34992512 !=0) |
| 236 | Boolean(entity+424 bit8 !=0) |
| 244 | Boolean(global35000452 bit0 !=0) |
| 248 | Raw client+700 word |
All other bytes in the fixture retain supplied zero unless written by the recorded assembly. This is a complete fixture output, not a declaration that every unmodified frame word is unused by the real consumer. Callback values are retained literally; their call ABI, actual trace/point-content behavior and native bridge require consumer recovery.
The assembly also copies client+20's three words to client+4072 and client+152's three words into local336. These are bit-preserving 12-byte copies, with vector/origin meanings still requiring complete layout evidence.
At instruction154870 it records helper54475(local56), then stops before movement effects or subsequent post-processing. 160 assembly probes combine the 60 command and 64 mask fixtures with 36 independent raw/Boolean global/client flag combinations. Tests construct an independent 268-byte frame and compare every byte, both vectors, pointer mutations, neighboring command canaries and every recorded call. Nonzero global flag -1 becomes Boolean1, bit1 lock word2 becomes Boolean0, while client+712/+700 words pass through raw.
The shared evaluator adds restricted aligned word-backed BLOCK_COPY with a byte overlay so earlier STORE1 command mutations are included in copied words. It also adds BOR and finite binary32 MULF/CVFI. Unknown/unbacked or unaligned copies and nonfinite/out-of-range arithmetic fail closed. General overlapping/unaligned byte copies, aliasing, exceptional arithmetic and QVM runtime memory masking remain unverified.
Validation and remaining work
Eight independent tests verify finite arithmetic/pointer consumption, unmasked shift/OR packing, signed input suppression/canaries, complete frame/vector bytes, mask/cleanup/call precedence, provenance, byte-overlay copy/failure domains and finite conversion/OR boundaries. Existing report regeneration checks protect previous evaluator users.
RE-412 remains open for complete setup/producer/simulation/runtime work. RE-416 must recover helper54475 and its entire frame layout/consumers, callback ABI/native collision integration, helper151954 and link producers, gravity/speed and packed-word registrations/legal ranges, byte-copy/float/alias/runtime edge cases, post-movement mutations and full packet-to-simulation composition. Validate actual gameplay and macOS/Linux behavior before Rust/Bevy/Solari compatibility claims; entity/player/snapshot codecs and rendering also remain open.
Follow-up: scheduler/output gates recovers bounded outer-loop scheduling under supplied child clock progress, the child input prefix and a separate post-loop suffix. Actual child clock/physics/callbacks and event effects remain open.