Skip to Content
Getting StartedValidation

Validation

Target API: 5 · Target build: bbb6l5 (verified in production and preprod 2026-11-20) · Status: Verified

The 3-stage load check

  1. Loader limits — size, shape, manifest validity (see Pack structure)
  2. Static validation (analyzer) — syntax, types, reserved names, strict contract, across all 6 variants
  3. 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

  1. Load the zip or folder from settings → Shader Pack
  2. Check status: “Ready. Reload the page to use it.” right after selecting; after a page reload, “Ready to use” means success
  3. On “Saved, but it won’t run until you fix these errors…”, fix the listed errors (file:line + variant) and reload
  4. Test in a permissive game first, then a strict-mode game (most games). Vertex animation works only in allow games
  5. Replacing a pack reloads from the same screen; changes need a page reload
  6. 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.