Skip to content

Resource Packs

Dan Alexander edited this page Nov 3, 2026 · 2 revisions

Resource packs and hosting

Target profiles, compilation, self-hosting and delivery of Java resource packs.

Documentation for VoxelCore v1.0.0. Home · Installation · Compatibility

Resource-pack targets

VoxelCore provides explicit validated pack profiles rather than assuming one resource-pack format works across an entire historical version range:

Target Mode Pack format
mc-1.12.2 legacy durability/damage predicate 3
mc-1.13.2 legacy durability/damage predicate 4
mc-1.14.4 numeric Custom Model Data 4
mc-1.19.4 numeric Custom Model Data 13
mc-1.20.5 numeric Custom Model Data 32
mc-1.21.4 item-model / structured CMD 46
mc-26.2 item-model / structured CMD 88.0
mc-26.3 item-model / structured CMD 97.1

Minecraft 26.2 and 26.3 use modern min_format/max_format pack metadata. Earlier targets retain the legacy pack_format field.

Self-hosted delivery

VoxelCore can optionally serve the latest successfully built pack at http://<public-host>:24464/resourcepack.zip. Enable resource_pack.host.enabled, allow the configured port through the machine and network firewalls, and set resource_pack.host.public_host to the address clients can reach. public_url can instead point to a TLS reverse proxy base URL. The host exposes only the pack endpoint, supports GET/HEAD, and replaces the served ZIP atomically. If a pack already exists for the current target, it is made available after startup. Every successful pack build updates the hosted copy and, when enabled, sends the new pack to online players.

Player delivery is controlled separately with resource_pack.players.send_on_join and send_on_build. Set required: true to kick players who decline the pack or encounter a download/reload failure, and configure prompt and failure_kick_message for client-facing text. VoxelCore sends the pack SHA-1 on API versions that support it; custom prompts are passed on server APIs that expose them. A public address is required for clients outside the server machine; when public_host and public_url are both blank, the server's configured server-ip is used if available.

Pack output is deterministic and stored below:

plugins/VoxelCore/build/resource-packs/<target>.zip

Clone this wiki locally