Skip to Content
TroubleshootingValidation errors

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 / my etc.

“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() needs BLOXD_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

MessageMeaning
<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 discard in #ifndef BLOXD_STRICT (Variants)

Current-version messages

MessageAction
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.