Skip to Content

API v1

Status: Historical — the first era of the shader-pack mechanism. Every v1 pack is rejected by the current game.

v1 was the first shader-pack API. v2 renamed the identifiers wholesale (v2 guide §32’s table), so the main value of knowing v1 vocabulary is reading old distributions and old community guides.

v1 vocabulary (renamed in v2)

v1v2 onward
bloxdTime()same (became bloxdSeconds() in v3)
bloxdOriginOffset()same (became bloxdRenderOffset() in v3)
bloxdFaceBlock(position, normal)same (removed in v3)
fogFactorfogVisibility (became fogAlpha in v5, inverted)
engineColoursame (removed in v5 — restructured into litColour and bloxdLitColour())
—blockId (added in v2, became blockFlags in v3)

Hooks were terrain / liquid × vertex / surface — 6 hooks, no light hooks (light hooks only became part of the default template in v5). Block identification was texture-color guessing only; blockId / blockFlags / flags did not exist yet.

Migrating v1 → v2

The wholesale rename means it is not a mechanical conversion. Read the v2 migration guide from the top:

  1. §31 The fate of v1 packs
  2. §32 Identifier renames (the table)
  3. §33 Where removed fields moved
  4. §37 v1 → v2 checklist

Then apply v3 → v4 → v5 in order (the fast path).