Skip to Content
Getting StartedOverview & prerequisites

Overview & prerequisites

Target API: 5 · Target build: bbb6l5 (verified in production and preprod 2026-11-20) · Status: Verified

What a shader pack is

A Bloxd.io shader pack changes the look of the game’s WebGPU renderer only. Packs are written in a restricted subset of WGSL and loaded from the in-game settings → Shader Pack screen as a zip or folder. While a pack is installed, the WebGPU renderer is force-enabled in settings.

Packs are validated and compiled as pure WGSL — no JavaScript execution, no networking. Nothing dangerous can happen with normal code.

What you can change

A pack plugs into the renderer’s 3-stage per-face pipeline. The render targets split into three programs with a total of 9 hooks:

TargetHooks (Vertex / Surface / Light)What is drawn
TerrainbloxdTerrainVertex · bloxdTerrainSurface · bloxdTerrainLightAll blocks except water and block models
LiquidbloxdLiquidVertex · bloxdLiquidSurface · bloxdLiquidLightWater
ModelbloxdModelVertex · bloxdModelSurface · bloxdModelLightBlock models (slabs, stairs, plants), items, players, mobs, NPCs, armour, cosmetics
  • Can do: change colors, transparency and emission; rebuild lighting (the Lighting API); projected-style shadows (via skyLight); sample textures (bloxdTexel — reading the existing block-texture atlas); per-model effects (flags tell you “this is a held item”, “this is a player”); vertex animation (allow games only)
  • Cannot do: add your own textures (that is the texture-pack system’s job); post-processing (bloom etc.); shadow-map shadows that rotate with the sun; true reflections (SSR); affect the sky, clouds or the sun disc itself
  • Easy to miss but powerful: projected-style shadows using skyLight (voxel sky occlusion) — clearly darken areas under trees and roofs. Breaking blocks makes LightEngine recalculate immediately, so shadows follow in real time

strict and allow modes

Every game has a shader-pack policy (shaderPackPolicy), and most games run in strict mode (no vertex animation, no discard). Packs for general distribution must work in strict mode. See Variants and the policy reference.

Assumptions in this documentation

  • The current game only accepts apiVersion: 5 packs; v1–v4 packs are rejected at load (saved packs become silently inactive — Compatibility)
  • Migrating a pack written for an older version? See Version History
  • Engine internals may change with updates, so every page names its target build