Packs

Download a 3D armour set

A 3D armour set as its page offers it: bbmodel (the default) is the whole set as a Blockbench project, to open and change there; atlas is the PNG every piece is painted on (an image over MCP). {set} is the set's name from the asset listing, with or without its armor3d:.

GET/packs/{pack}/armor3d/{set}/file

Path parameters

packstringrequired

The pack's slug, as returned by the packs endpoints.

setstringrequired

The set's id.

Query parameters

formatstringdefault "bbmodel"

Which file.

Options: bbmodel, atlas

Response · 200

The .bbmodel (JSON) or the atlas (PNG).

Error codes

Branch on error.code, never on the message.

invalid_request400

Something in the body or query is wrong. message says what.

invalid_api_key401

The key isn't one of ours, or it has been revoked.

missing_api_key401

No Authorization: Bearer header was sent.

wrong_key_kind401

An MCP key sent to the REST API, or an API key sent to the MCP server. Each only opens its own.

account_suspended403

The account is suspended, so its keys open nothing. message says until when, if the suspension has an end date.

forbidden403

Valid key, but not permitted to do this in this pack.

plan_required403

The key is valid, but its account's plan does not include the API.

not_found404

No such pack, asset or job.

still_generating409

The asset exists but isn't finished. Poll its job until it's ready.