Validation
Target API: 5 · Target build:
bbb6l5(verified in production and preprod 2026-11-20) · Status: Verified
The 3-stage load check
- Loader limits — size, shape, manifest validity (see Pack structure)
- Static validation (analyzer) — syntax, types, reserved names, strict contract, across all 6 variants
- Real WebGPU compilation in the browser — static validation’s type-checking is incomplete, so some mistakes only surface here
For reading each error, see Troubleshooting (organized by symptom).
Procedure
- Load the zip or folder from settings → Shader Pack
- Check status: “Ready. Reload the page to use it.” right after selecting; after a page reload, “Ready to use” means success
- On “Saved, but it won’t run until you fix these errors…”, fix the listed errors (file:line + variant) and reload
- Test in a permissive game first, then a strict-mode game (most games). Vertex animation works only in allow games
- Replacing a pack reloads from the same screen; changes need a page reload
- Remove with Remove Pack. After game updates, saved packs re-validate automatically on page load (header/registry changes mark them “needs re-check”)
On-device test checklist
See the testing guide for the full checklist and the complete list of factors that change what a pack sees.