Files
skate-3-rust-engine/docs/hails-additions
Hails 810defa65e Performance: index stock collection lookups (game start and map switch -5.5 s)
Collections are looked up through a lazily built OnceLock<HashMap> index
with first-match semantics, identical to the linear scan on 145,807 real
lookups. See docs/hails-additions/07-collections-index.md (PR E).
2026-10-01 00:13:45 -06:00
..

Hails' additions

Changes made in the Hailey-Ross fork of SK8-ENGINE/skate-3-rust-engine, documented so upstream maintainers have the full context when reviewing a pull request: what broke, why, what changed, how it was verified, and what is still open.

Each document stands alone. File paths are relative to the repository root.

# Change Area Status
1 ISO extraction argument order Setup (Python) Done, verified with a real ISO
2 Windows long paths during setup Setup (Python) Done; UAC path not exercised end to end
3 SDL3 gamepad input Game (Rust), build scripts, vendored sdl3-sys Done, verified in play with an Xbox Elite Series 2
4 Authored map spawns Asset pipeline (Python) Done, all 10 maps confirmed in play
5 Invisible collision volumes Game data loader (Rust) Done, all four affected maps confirmed in play

Environment used for verification

  • Windows 11, Intel i7-14700KF, NVIDIA RTX 4080 SUPER (Vulkan).
  • Rust 1.98.1 (MSVC), Visual Studio 2026 C++ tools, Windows SDK 10.0.26100, LLVM 23.1.2, Python 3.13.15.
  • Skate 3 Xbox 360 disc image (103 files, 6,404,940,920 bytes).
  • Xbox Elite Series 2 controller over Bluetooth LE.

Conventions

  • Upstream behaviour is preserved unless a document says otherwise; where a behaviour changes on purpose (for example, a map's default spawn), the document lists the old and new values.
  • Project choices that are not dictated by retail data are called out as such, so maintainers can overrule them.