aboutsummaryrefslogtreecommitdiff
path: root/docs/reference/tma.md
diff options
context:
space:
mode:
authorValentin Popov <valentin@popov.link>2026-10-20 07:11:45 +0300
committerValentin Popov <valentin@popov.link>2026-10-20 07:11:45 +0300
commitecc46ed17772816d6f0de565a0a1605d0299a1dd (patch)
treeefe00bb6c5c04005fd5e0ebaf125e3dc8aa4f190 /docs/reference/tma.md
parente4645b1d6278a2f766dac99815d3938c42f61640 (diff)
downloadfparkan-ecc46ed17772816d6f0de565a0a1605d0299a1dd.tar.xz
fparkan-ecc46ed17772816d6f0de565a0a1605d0299a1dd.zip
fix(runtime): preserve native mission AI selection word
Diffstat (limited to 'docs/reference/tma.md')
-rw-r--r--docs/reference/tma.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/reference/tma.md b/docs/reference/tma.md
index 30ee495..dff0796 100644
--- a/docs/reference/tma.md
+++ b/docs/reference/tma.md
@@ -60,5 +60,33 @@ u32 property_count
Property properties[property_count]
```
+Эти два слова после `resource_name` -- разные входные значения. В оригинале
+`MisLoad.dll!FUN_10003900` (RVA `0x3900`) читает первое в смещение `0x54`
+нативной записи, если версия секции объектов выше 2; следующее слово попадает
+в смещение `0x5c` только при версии выше 3. Getter
+`MisLoad.dll!FUN_10001440` (RVA `0x1440`) копирует первое слово в смещение
+`0x50` строки, передаваемой хосту. `iron3d.dll!FUN_100a1f30` (RVA `0xA1F30`)
+загружает миссию и вызывает `FUN_100a3e40` (RVA `0xA3E40`); тот запрашивает
+строку через vtable slot `+0x28` (callsite RVA `0xA3F1A`). Хост передаёт это
+значение в создание схемы объекта в ArealMap, откуда оно становится первым
+DWORD дескриптора создания World3D. `World3D.dll!CreateObject` (RVA `0x7CB0`)
+читает DWORD по RVA `0x7E58`, а callsite RVA `0x7E62` передаёт его через vtable
+slot `+0x40` в путь выбора AI в Behavior. Поэтому Rust сохраняет первое слово
+как `raw_after_resource: u32`: оригинал использует его как индекс выбора AI,
+но соответствие значения типу `OwnerId` в `fparkan-world` не доказано.
+Соседнее `identity_or_clan_raw` остаётся отдельным raw-полем; его имя не
+доказывает, кому объект принадлежит.
+
+Цепочка проверена на этих сборках (SHA-256): `MisLoad.dll`
+`c607762bb67db14ca530927c8e1347339b62b0a163ac90c708ee83142292e2bf`,
+`iron3d.dll`
+`d1dc4ea8535e2069b0a05c9e8be2724dd438ba44cca7a83007d8b2e50f9e35fa`,
+`ArealMap.dll`
+`a25f9254ebb339d70e2e07c8121950191e9584ca0858d8e9c2e2b6c671edf6ea`,
+`World3D.dll`
+`17e4a3089b2583a8cf2356c9db0390b1aba138356a09130d79b4e7e4791da61e` и
+`Behavior.dll`
+`ddfbdbde07832358fe6e35e01c8dba9b58e7313789498b6049ed51d4ed9baf99`.
+
`Property` состоит из четырёх raw `u32` и имени. Typed views разрешены только
для доказанных property names и consumers.