1.2 KiB
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.