Skip to content

Resource Pack

Giovanni Albanese edited this page Jun 13, 2026 · 1 revision

Resource Pack

Open Roleplay mantiene asset e resource pack in formato aperto.

Ogni modulo che ha asset pubblici espone una cartella:

<modulo>/assets/resource-pack/

Dentro devono esserci:

pack.mcmeta
assets/

Questa struttura permette di:

  • aprire e modificare il pack senza strumenti proprietari;
  • generare uno zip Minecraft-ready;
  • versionare separatamente gli asset per modulo;
  • evitare un pack monolitico difficile da mantenere.

Moduli con resource pack

open-cosmetics/assets/resource-pack/
open-weapons/assets/resource-pack/

Open Access non richiede resource pack nella versione attuale.

Generazione zip

bash scripts/build-resource-packs.sh

Output:

target/resource-packs/open-cosmetics-resource-pack.zip
target/resource-packs/open-weapons-resource-pack.zip

Lo script verifica che ogni pack contenga:

  • pack.mcmeta;
  • assets/.

Poi crea uno zip con questi elementi alla radice. Questo e' importante perche' Minecraft non accetta zip con una cartella contenitore extra sopra pack.mcmeta.

Maven

La generazione resource pack e' agganciata al phase Maven package del parent.

Quindi:

mvn -B -ntp package

genera anche gli zip in target/resource-packs/.

Convenzioni consigliate

  • Tieni gli asset cosmetici in open-cosmetics.
  • Tieni gli asset arma base in open-weapons.
  • Non duplicare model data fra moduli.
  • Documenta ogni range custom model data nel README del pack.
  • Prima di una release apri lo zip e verifica che pack.mcmeta sia alla radice.

Test manuale

  1. Genera lo zip.
  2. Copialo o servilo al client Minecraft.
  3. Controlla che Minecraft lo carichi senza errori.
  4. Verifica item, modelli, texture e suoni nel server.
  5. Se hai modificato suoni, controlla anche assets/minecraft/sounds.json.

Clone this wiki locally