Skip to Content
Version HistoryVersion History

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

VersionLive sinceGuideHighlights
v1(initial)v1first shader-pack API. 6 hooks (terrain/liquid × vertex/surface); bloxdTime / bloxdOriginOffset / bloxdFaceBlock / engineColour / fogFactor vocabulary
v2—v2full identifier rename, blockId, BLOXD_SCENE_DEPTH and bloxdOpaqueBehind()
v32026-10-19v3blockId → blockFlags bit flags, bloxdPi / bloxdTau, official liquid hooks, hook-invocation internals
v42026-10-26v4texture API (bloxdTexel / bloxdTextureSize / bloxdTextureId*), the strict contract, engine header & registry analysis
v52026-11-03v5current — 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.