Add traffic lane GPS weighting toolkit

2026-06-19 20:16:09 -05:00
parent 247fd73107
commit 85d1e326ee
8 changed files with 480 additions and 0 deletions
@@ -0,0 +1,57 @@
+# 2077 Edge Weight Mod
+
+Experimental Cyberpunk 2077 GPS route-weighting mod tooling.
+
+## Feasibility
+
+Cyberpunk exposes a native `gamegpsGPSSystem`, but the current public RTTI dump does
+not expose script-callable methods for replacing or overriding the GPS planner. The
+useful surface is the traffic lane resource data:
+
+- `worldTrafficPersistentResource.data.lanes`
+- `worldTrafficLanePersistent.length`
+- `worldTrafficLanePersistent.maxSpeed`
+- `worldTrafficLanePersistent.flags`
+- `worldTrafficLanePersistent.playerGPSInfo`
+- `worldTrafficLanePersistentFlags.Highway`
+- `worldTrafficLanePersistentFlags.GPSOnly`
+
+That strongly suggests the in-game GPS path is computed natively over the traffic
+lane graph, using lane metadata as edge cost inputs. A full replacement planner
+would require native hooks or patching the game executable. A feasible REDmod-style
+mod is to patch lane resources so highways and major roads have better effective
+costs than side streets.
+
+## Current Implementation
+
+This repo currently contains a WolvenKit-export patcher:
+
+```bash
+python3 tools/patch_traffic_lanes.py exported-json-dir patched-json-dir
+```
+
+The patcher recursively scans WolvenKit JSON exports for `lanes` arrays that look
+like `worldTrafficLanePersistent` data and applies configurable speed weighting:
+
+- highways get boosted toward a preferred GPS speed
+- regular roads get a moderate speed floor
+- pavement, crosswalk, and disabled traffic lanes are left alone
+- optional non-highway speed caps can make highways more attractive
+
+After patching, deserialize the JSON back into CR2W and pack the resulting
+resources into an archive.
+
+The toolbox now has WolvenKit CLI installed:
+
+```bash
+toolbox run --container 2077 bash -lc '$HOME/.dotnet/tools/cp77tools --help'
+```
+
+See [docs/tooling.md](docs/tooling.md) for the end-to-end archive build flow.
+
+## Status
+
+This is not yet a packaged playable mod because this workspace does not contain
+the Cyberpunk archive resources. The toolbox has the required CLI tooling now, so
+the next step is running the archive build script against a local Cyberpunk 2077
+install path.