[PR #232] [MERGED] kb: Porting a vehicle from another game: the semantic traps #234

New issue

Closed

opened 2026-10-15 20:54:37 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-15 20:54:37 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/rehan-remade/universal-modder/pull/232
Author: @Proudnoob4
Created: 10/11/2026
Status: ✅ Merged
Merged: 10/12/2026
Merged by: @rehan-remade

Base: main ← Head: kb/technique-porting-a-vehicle-semantic-traps

📝 Commits (3)

1ca61d2 kb: Porting a vehicle from another game: the semantic traps
09c06ed kb: vehicle semantic-traps technique: review fixes
88ed6e5 Merge remote-tracking branch 'origin/main' into land/pr-232

📊 Changes

3 files changed (+182 additions, -1 deletions)

View changed files

📝 knowledge/INDEX.md (+2 -1)
📝 knowledge/index.json (+21 -0)
➕ knowledge/techniques/porting-a-vehicle-semantic-traps.md (+159 -0)

📄 Description

Adds a technique note: the SEMANTIC traps when porting a vehicle between games - our most expensive defect class.

Named traps, each with the guest value, what the consuming code MEANS, and how we got it wrong first:

damping is a COEFFICIENT (s^-1), not a dimensionless ratio;
the TREAD (hub - radius) is the contact point, not the hub;
damage is a region PERMUTATION swap, not a texture swap;
near/far must come from the live camera, not a guess;
the suspension travel lives in the animation graph, not the vehicle tag.

Includes the PORT CONTRACT table (name / value / units / meaning / source / host mechanism / conversion / oracle / reference / tolerance) with the rule that an empty semantics cell BLOCKS implementation.

Verified in Fallout: New Vegas (host) with Halo 3/MCC content (guest); unverified items are tagged.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/rehan-remade/universal-modder/pull/232 **Author:** [@Proudnoob4](https://github.com/Proudnoob4) **Created:** 10/11/2026 **Status:** ✅ Merged **Merged:** 10/12/2026 **Merged by:** [@rehan-remade](https://github.com/rehan-remade) **Base:** `main` ← **Head:** `kb/technique-porting-a-vehicle-semantic-traps` --- ### 📝 Commits (3) - [`1ca61d2`](https://github.com/rehan-remade/universal-modder/commit/1ca61d2597f02e0563597a1a2e7359bfb69669fb) kb: Porting a vehicle from another game: the semantic traps - [`09c06ed`](https://github.com/rehan-remade/universal-modder/commit/09c06edf2325e04acf14dd4166c928408e332dff) kb: vehicle semantic-traps technique: review fixes - [`88ed6e5`](https://github.com/rehan-remade/universal-modder/commit/88ed6e536e8c8b3e9a4c41c74d1087d7fc4a6faf) Merge remote-tracking branch 'origin/main' into land/pr-232 ### 📊 Changes **3 files changed** (+182 additions, -1 deletions) <details> <summary>View changed files</summary> 📝 `knowledge/INDEX.md` (+2 -1) 📝 `knowledge/index.json` (+21 -0) ➕ `knowledge/techniques/porting-a-vehicle-semantic-traps.md` (+159 -0) </details> ### 📄 Description Adds a technique note: the SEMANTIC traps when porting a vehicle between games - our most expensive defect class. Named traps, each with the guest value, what the consuming code MEANS, and how we got it wrong first: - damping is a COEFFICIENT (s^-1), not a dimensionless ratio; - the TREAD (hub - radius) is the contact point, not the hub; - damage is a region PERMUTATION swap, not a texture swap; - near/far must come from the live camera, not a guess; - the suspension travel lives in the animation graph, not the vehicle tag. Includes the PORT CONTRACT table (name / value / units / meaning / source / host mechanism / conversion / oracle / reference / tolerance) with the rule that an empty semantics cell BLOCKS implementation. Verified in Fallout: New Vegas (host) with Halo 3/MCC content (guest); unverified items are tagged. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-15 20:54:37 +00:00