0 Fork 0

mirror of https://github.com/SK8-ENGINE/skate-3-rust-engine.git synced 2026-10-26 19:47:44 +00:00

Files

T

Hails 418dcecd41 Audio: interim cue tables retired, native water splash, published tools

- The interim cue tables and their opt-outs are gone; the native runtime is the only audio path. Old
  settings/audio.json files still load ("interim" / "native" ignored). Missing native data logs an error
  instead of falling back.
- Water splash from retail's mechanism (SFXObj_OffBoard start / update): Skate_Collisions 1187 / 1197 once
  per water stay, 1198 when the board is in water.
- The random interim riding bed is removed; riding collision and cloth sounds compared with the recomp
  (doc 11). Native output otherwise byte-identical (13 scenarios + 5 sessions).
- Published tools under tools/ (one folder per tool with a README; the recomp ones labelled for use with the
  research hooks), doc 14 and PR plan bucket L.
- Docs: doc 11 (retirement, bail density measured against the recomp, collision posts), doc 13 (usage guide).

2026-10-03 10:20:08 -06:00

2.6 KiB

Raw Blame History

Collision inspection

Extract a district's collision from your own disc and look at it, without touching the installation. Used to place map spawns and to find the invisible trigger volumes (see docs/hails-additions/04-map-spawns.md and 05-collision-volumes.md).

Script	What it does
`map_collision.py`	Extracts `world<District>.big` into `<work>/<District>/raw` (once), runs the map converter's collision pass and saves every triangle to `collision.npy` (N x 3 x 3 float64, Y-up metres). Prints the triangle count, bounds and the spawn the current spawn rule would choose.
`analyse_spawn.py`	Lists every collision surface at a point's X/Z (height, normal-up sign, area), plus the area-weighted centre of the flat surfaces. Nothing below a spawn = void; a much lower surface under it = roof or platform. Needs `map_collision.py` first.
`collision_attrs.py`	Saves the triangles with their surface id, unit flags (0x80 = has a surface id), mesh flags and mesh index to `collision_attrs.npy`. Needs the extracted district.
`scan_surfaceless.py`	For each district: counts collision meshes that are surfaced, mixed or surfaceless (no surface ids at all) and lists the non-surfaced ones with their size and bounds.
`unsigned_collision.py`	Imported by the others: makes the vendored collision decoder read 16-bit vertex deltas unsigned, as the game does. Without it, clusters spanning more than 32.8 m wrap by 65.536 m.

Inputs

Your extracted disc: --disc DIR (the folder holding data/), default $SKATE3_DISC or .local/skate3-disc.
District names without the DIST_ prefix: MegaPark, StartPark, BlackBoxPark, SkateSchool, IndustrialSkatePark, DownTownSkatePark, MaloofMoneyCup, University, Industrial, DownTown.
Work folder: --work DIR, default .local/collision (gitignored).

Usage

py -3.13 tools/collision-inspect/map_collision.py MegaPark
py -3.13 tools/collision-inspect/analyse_spawn.py MegaPark 21.7 21.6 -19.7
py -3.13 tools/collision-inspect/collision_attrs.py SkateSchool
py -3.13 tools/collision-inspect/scan_surfaceless.py SkateSchool StartPark

Parks take about a second; the city districts take minutes and a lot of memory.

Example output

(made-up values)

triangles 12000
bounds min [-120.0 -5.2 -130.0] max [140.0 40.1 125.0]
spawn (current rule) [10.5 0.1 6.0]

MapA surfaces at (21.7, -19.7) : [(0.0, 1.0, 12.5), (6.3, 1.0, 3.1)]

Requirements

Python 3.13 with numpy; the repository's setup modules (tools/asset_pipeline) and the vendored map extraction tools (tools/vendor/university, tools/vendor/utt).

2.6 KiB Raw Blame History