Version History
Status: Historical — version-by-version records; each guide names its own target build
Changes, migration steps and removed APIs for v1 through v5. For migrating legacy packs and for the preserved per-era specifications.
Timeline
| Version | Live since | Guide | Highlights |
|---|---|---|---|
| v1 | (initial) | v1 | first shader-pack API. 6 hooks (terrain/liquid × vertex/surface); bloxdTime / bloxdOriginOffset / bloxdFaceBlock / engineColour / fogFactor vocabulary |
| v2 | — | v2 | full identifier rename, blockId, BLOXD_SCENE_DEPTH and bloxdOpaqueBehind() |
| v3 | 2026-10-19 | v3 | blockId → blockFlags bit flags, bloxdPi / bloxdTau, official liquid hooks, hook-invocation internals |
| v4 | 2026-10-26 | v4 | texture API (bloxdTexel / bloxdTextureSize / bloxdTextureId*), the strict contract, engine header & registry analysis |
| v5 | 2026-11-03 | v5 | current — BloxdFlags struct (14 bools), Model hooks (9 total), the bloxdLit() / bloxdLitColour() lighting API, localPosition, enchant/overlay inputs & outputs, 6 variants |
The shared preface
The current game accepts only apiVersion: 5 and old-version packs fail at the instant of load (saved packs are silently deactivated — Compatibility). Each guide covers “previous → next”. Crossing several versions? Apply them oldest-first.
Fast path to a checklist
- v4 pack → v5 guide §77 (mostly mechanical)
- v3 pack → v4 §61 → v5 §77
- v2 pack → v3 §47 → v4 → v5
- v1 pack → start at v2 §37
For the current spec itself see API Reference; for current-build internals see Engine Internals.