Skip to Content
TroubleshootingTroubleshooting

Troubleshooting

Errors and visual problems, findable by symptom. Pages follow the structure: symptom → cause → how to check → fix → prevention.

Symptom index

SymptomPage
Pack won’t load / zip & pack.json errorsLoading errors
apiVersion messages / old packs not runningAPI version errors
Won’t compile / must be declared as / WGSL syntaxCompilation errors
Validation errors (reserved names, strict contract, reaches)Validation errors
Fails only in some variants / dropped in strict gamesVariant-specific issues
Looks wrong (white haze, no shadows, odd night)Visual issues
Texture-name errors / did you meanTexture issues
Brightness / shadow / fog problemsLighting issues
Model / entity / enchant problemsModel issues
Slow / dropped by the on-device checkPerformance
Legal, safety, common questionsFAQ

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

  1. Settings → Shader Pack status line — loader-stage errors (IDs are shaderPack:load*)
  2. The loader screen’s error list — validation & compilation (file:line + variant)
  3. Browser devtools console — runtime & stage-2 (browser WGSL compiler) errors

The 3-stage load check is detailed in Getting Started: Validation.