Model issues
Target API: 5 · Target build:
bbb6l5(2026-11-20, production and preprod) · Status: Analyzed (new v5 territory)
Issues around the new v5 Model hooks.
Players/mobs unaffected
- Cause: entities (players, mobs, NPCs, armour, cosmetics) are drawn by the Model program — terrain hooks don’t touch them
- Fix: add Model hooks (the models guide)
Slabs, stairs, plants unaffected
- Cause: block models (
slab/stairs/flat) are also Model-program geometry, never terrain - Fix: use Model hooks with
flags.slab/flags.stairs/flags.flat(Flags)
Water unaffected
- Cause: water is Liquid-hook-only; without Liquid hooks, no Terrain hook runs on water either (v5 change)
- Fix: define
bloxdLiquidSurface/bloxdLiquidLight(Variant issues)
Want to change only held items but everything changes
- Fix: select with
surface.flags.held(model shader recipes)
Flag checks don’t behave
- Likely causes:
- treating flags as a single-choice enum — they combine freely («sandstone is sand and rock», «possibly even none») (Flags)
- reading
elseas “everything else” — the else offlags.rockis merely “not rock”, possibly still sand
- Fix: combine material flags (
opaque…) independently of shape/state flags (slab/held…)
Enchant glint disappeared
- Fix: pass
enchantColourthrough or usebloxdLitColour()(Enchant effects)
Hurt flash disappeared / too strong
- Fix: pass
overlayColourthrough or adjustout.overlayColour.a(Enchant effects)
localPosition always reads 0
- By design:
localPositionisvec3f(0.0)on terrain and liquid faces — no model there - Fix: read it in Model hooks (model recipes)
bloxdTexel returns white on models
- By design:
textureId: 0(skins) samples as white - Fix: select with
surface.textureId != 0uor work fromsurface.colour(Texture issues)
Want armour-only / cosmetics-only changes
- Limit: no flag says “armour”;
flags.lifeformincludes armour and cosmetics - Approximation: combine with
localPosition(placement) or the presence ofoverlayColour(model recipes)