Validation errors
Target API: 5 · Status: Verified (messages recorded verbatim from the live validator)
Static-validation (analyzer, stage 1) errors — mostly reserved names, the strict contract, and cross-hook call restrictions.
“Packs can’t construct BloxdSurface directly” / “Packs can’t construct BloxdLight directly, since header structs gain fields; …”
- Cause: calling constructors like
BloxdSurface(...) - Fix: start from
bloxdDefaultSurface(s)/bloxdDefaultLight(s, l)and mutate fields (var out = s;works in light hooks)
“Packs can’t declare names starting with bloxd, other than the hook functions bloxd<Terrain|Liquid|Model><Vertex|Surface|Light>”
- Cause: an identifier starting with
bloxd(case-insensitive) - Fix: rename (e.g.
packTint). Only the 9 hook names are allowed - Prevention: prefix your own names with
pack/myetc.
“bloxdPackInputs isn’t part of the bloxd_ header”
- Cause: referencing the uniform directly
- Fix: use it via the header functions (Pack format)
”… reaches bloxdTexel, which only surface and light hooks can use.”
- Cause: called from a vertex hook (or a function reachable from one) — “reaches” means the call path
- Fix: move the call to a surface / light hook
”… reaches bloxdOpaqueBehind, which needs BLOXD_SCENE_DEPTH, and <program> doesn’t define it; …”
- Cause:
bloxdOpaqueBehind()needsBLOXD_SCENE_DEPTH, defined only in all-liquid variants; sharing the call from terrain/model-hook code creates uncompilable variants - Fix: wrap the call in
#ifdef BLOXD_SCENE_DEPTH - Prevention: isolate depth reads as liquid-only processing
The strict contract
| Message | Meaning |
|---|---|
<hook> moves terrain, which strict games prevent. | unguarded vertex hook |
discard makes terrain see-through, which strict games prevent. | reachable discard |
- Important: these are not compile errors — strict games auto-disable the whole pack (
shaderPack:offInStrict) - Fix: wrap vertex hooks and
discardin#ifndef BLOXD_STRICT(Variants)
Current-version messages
| Message | Action |
|---|---|
BLOXD_LIGHTING was removed in apiVersion 5; test bloxdLit() in code instead. | migrate #ifdef BLOXD_LIGHTING → if (bloxdLit()) (Lighting) |
bloxdBlockFlagRock isn't part of the shader pack API... | leftover bit constant → flags.rock (Flags) |
bloxdSpLitColour isn't part of the shader pack API... | v4 internal symbol → use the public bloxdLitColour() |
The analyzer gives dedicated messages to packs that keep reading blockFlags or wrapping light hooks in #ifdef BLOXD_LIGHTING, so nothing misbehaves silently (the migration steps: v5 migration).
Texture-name resolution errors (spelling suggestions, frame/rotation spellings) live in Texture issues.