Troubleshooting
Errors and visual problems, findable by symptom. Pages follow the structure: symptom → cause → how to check → fix → prevention.
Symptom index
| Symptom | Page |
|---|---|
| Pack won’t load / zip & pack.json errors | Loading errors |
apiVersion messages / old packs not running | API version errors |
Won’t compile / must be declared as / WGSL syntax | Compilation errors |
Validation errors (reserved names, strict contract, reaches) | Validation errors |
| Fails only in some variants / dropped in strict games | Variant-specific issues |
| Looks wrong (white haze, no shadows, odd night) | Visual issues |
Texture-name errors / did you mean | Texture issues |
| Brightness / shadow / fog problems | Lighting issues |
| Model / entity / enchant problems | Model issues |
| Slow / dropped by the on-device check | Performance |
| Legal, safety, common questions | FAQ |
Target API: 5 · Target build:
bbb6l5(verified in production and preprod 2026-11-20) · Status: Verified (messages recorded verbatim from the live validator & loader)
Where errors appear
- Settings → Shader Pack status line — loader-stage errors (IDs are
shaderPack:load*) - The loader screen’s error list — validation & compilation (file:line + variant)
- Browser devtools console — runtime & stage-2 (browser WGSL compiler) errors
The 3-stage load check is detailed in Getting Started: Validation.