58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
# 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.
|