Skip to Content
Getting Startedpack.json (manifest)

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

FieldTypeRequiredDescription
apiVersionnumberrequiredMust exactly equal 5 (strict ===). A string "5" or any other type fails, reported with the JSON spelling
namestringrequiredNon-empty after trimming. Shown in the settings UI
authorstringoptionalMay 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 entirely
  • This 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.