pack.json (manifest)
Target API: 5 · Target build:
bbb6l5(verified in production and preprod 2026-11-20) · Status: Verified
pack.json is the pack manifest — exactly one JSON object at the zip root.
{
"apiVersion": 5,
"name": "My Pack",
"author": "your name"
}Fields
| Field | Type | Required | Description |
|---|---|---|---|
apiVersion | number | required | Must exactly equal 5 (strict ===). A string "5" or any other type fails, reported with the JSON spelling |
name | string | required | Non-empty after trimming. Shown in the settings UI |
author | string | optional | May be omitted; must be a string if present |
All other fields are ignored by the loader.
What happens on version mismatch
The loader compares manifest.apiVersion !== 5 strictly and fails at the instant of load. Messages, verbatim from the live i18n dictionary:
pack.json needs "apiVersion": {{version}}.— the key is missing entirelyThis pack is shader pack API version {{packVersion}}. Bloxd supports version {{version}}.— the key exists but isn’t 5
Previously-saved older packs don’t throw exceptions; they resolve to {kind: "none", reason: "otherApiVersion"} and become silently inactive. The shader-pack settings tab explains why:
This shader pack is for API version {{packVersion}}, so it won't run. Load a version {{version}} pack to replace it.
For migrating from v1–v4, see Version History.