i-want-to-heal-mmo/src/assets/game

Runtime game assets

Only assets referenced by the game ship from this folder. They are copied from the ignored game_assets source library, retain their source-relative path, and are imported with Vite new URL(...) calls.

Use pnpm assets:import <path-within-game_assets> to add a source asset. Add --replace only when deliberately updating an existing runtime copy.

KTX2/UASTC pilot

The tracked *-uastc.glb files are parallel optimized copies. Their original GLBs remain the rollback path and must not be replaced or deleted during this pilot.

KTX-Software toktx is an authoring dependency. Rebuild source copies with:

TOKTX=/path/to/toktx pnpm assets:build-ktx2
TOKTX=/path/to/toktx pnpm assets:build-dungeon-kit
TOKTX=/path/to/toktx pnpm assets:build-gravehorn

Import each generated path from game_assets/ with pnpm assets:import <path> --replace. Builds and dev startup copy Three.js's matching Basis transcoder into the ignored public/basis/ generated directory.

Force all original GLBs at runtime with ?legacyGameAssets=1. Force them in an Android/browser build with VITE_LEGACY_GAME_ASSETS=1 pnpm build. legacyDungeonAssets and VITE_LEGACY_DUNGEON_ASSETS=1 remain supported aliases.