Creazione di un pacchetto skin

In questo tutorial imparerai quanto segue:

• La struttura di cartelle e file per i pacchetti skin in Minecraft: Bedrock Edition.
• Come costruire i file di metadati necessari per un pacchetto skin e come definire le skin che li utilizzano.

Struttura della cartella Pacchetto skin

manifest.json

Un file manifest fornisce a Minecraft informazioni generali sul tuo pacchetto skin. Crea un file JSON chiamato manifest.json alla radice del pacchetto skin. Al suo interno contiene quanto segue:

• name: il nome del pacchetto, che è sempre pack.name.
• version: la versione del pacchetto. Ad esempio, [1, 0 ,0] indicherebbe la versione 1.0.0.
• uuid: un identificatore univoco per prevenire conflitti tra pacchetti, che possono essere generati da questo sito: https://www.uuidgenerator.net/version4 (devono essere generati due diversi UUID).
• type: impostato su skin_pack per dire al gioco di trattare questo pacchetto come un pacchetto skin.

Modello manifest.json

{
  "header": {
    "name": "pack.name",
    "version": [1, 0, 0],
    "uuid": "<FIRST GENERATED UUID>"
  },
  "modules": [
    {
      "version": [1, 0, 0],
      "type": "skin_pack",
      "uuid": "<SECOND GENERATED UUID>"
    }
  ],
  "format_version": 1
}

skins.json

Un file skins.json definirà le skin che vengono fornite con il tuo pacchetto skin. Crea un file JSON chiamato skins.json alla radice del pacchetto skin. Al suo interno contiene quanto segue:

• localization_name e serialize_name: queste saranno le stesse; si tratta delle chiavi di localizzazione il cui valore sarà definito più avanti in en_US.lang con la chiave completa, ovvero skinpack.<localization_name>. Quel valore sarà il titolo del pacchetto. La chiave sarà inoltre sempre anteposta alla chiave di localizzazione di ogni singola skin.
• skins: una raccolta di definizioni, ognuna delle quali definisce una singola skin.

Ogni singola definizione di skin conterrà quindi quanto segue:

• localization_name: la chiave di localizzazione il cui valore è definito in seguito in en_US.lang. Il valore sarà il nome della singola skin.
• geometry: il modello base per cui è prevista questa skin. geometry.humanoid.customSlim è il modello di Alex e geometry.humanoid.custom è il modello di Steve.
• texture: il nome del file per ciascuna delle texture di skin così come appaiono nella radice del pacchetto di skin.
• type: o free o paid. I partner esterni al marketplace possono avere un numero qualsiasi di skin gratuite ma nessuna skin a pagamento, mentre i partner del marketplace possono avere fino a 2 skin gratuite e possono aggiungere skin a pagamento.

Modello skins.json

{
  "serialize_name": "TemplateSkinPack",
  "localization_name": "TemplateSkinPack",
  "skins": [
    {
      "localization_name": "TemplateSkin1",
      "geometry": "geometry.humanoid.customSlim",
      "texture": "skin_file_name1.png",
      "type": "free"
    },
    {
      "localization_name": "TemplateSkin2",
      "geometry": "geometry.humanoid.custom",
      "texture": "skin_file_name2.png",
      "type": "free"
    },
    {
      "localization_name": "TemplateSkin3",
      "geometry": "geometry.humanoid.customSlim",
      "texture": "skin_file_name3.png",
      "type": "paid"
    },
    {
      "localization_name": "TemplateSkin4",
      "geometry": "geometry.humanoid.custom",
      "texture": "skin_file_name4.png",
      "type": "paid"
    },
    {
      "localization_name": "TemplateSkin5",
      "geometry": "geometry.humanoid.custom",
      "texture": "skin_file_name5.png",
      "type": "paid"
    }
  ]
}

Texture di skin

Le effettive texture delle skin sono i PNG. I nomi dei file sono indicati nel file di metadati skins.json. Possono essere usati solo alla radice del pacchetto skin. Puoi usare Blockbench per creare una skin PNG utilizzabile per il tuo pacchetto skin.

Cartella testi

All'interno di questa cartella ci sono i file en_US.lang e languages.json che definiscono i nomi effettivi del pacchetto e delle skin e le lingue supportate del pacchetto. I nomi dopo = sono quelli che appaiono nel gioco, come ad esempio nel selettore di skin.

en_US.lang

Questo è il file in cui dai il nome al tuo pacchetto e alle skin.

• Nome del pacchetto: skinpack.[skins.json localization_name]=[name of pack]
• Nomi delle skin: skin.[skins.json localization_name].[skins.json single skin localization_name]=[name of skin]

Il modello seguente utilizza le "chiavi di localizzazione" dal modello skin.json per denominare il pacchetto "Nome del tuo pacchetto skin" e per denominare le singole skin "Nome skin 1-5".

Modello en_US.lang

skinpack.TemplateSkinPack=Your Skin Pack Name Here
skin.TemplateSkinPack.TemplateSkin1=Skin Name 1
skin.TemplateSkinPack.TemplateSkin2=Skin Name 2
skin.TemplateSkinPack.TemplateSkin3=Skin Name 3
skin.TemplateSkinPack.TemplateSkin4=Skin Name 4
skin.TemplateSkinPack.TemplateSkin5=Skin Name 5

languages.json

Questo file dice a Minecraft quali lingue supporta il tuo pacchetto skin. Solo l'inglese è obbligatorio. Se vuoi supportare altre lingue puoi creare altri file xx_YY.lang e quindi apportare una modifica per dire al gioco che le supporti.

Attualmente sono supportate le seguenti impostazioni internazionali/lingue:

• "en_US"
• "de_DE"
• "ru_RU"
• "zh_CN"
• "fr_FR"
• "it_IT"
• "pt_BR"
• "fr_CA"
• "zh_TW"
• "es_MX"
• "es_ES"
• "pt_PT"
• "en_GB"
• "ko_KR"
• "ja_JP"
• "nl_NL"
• "bg_BG"
• "cs_CZ"
• "da_DK"
• "el_GR"
• "fi_FI"
• "hu_HU"
• "id_ID"
• "nb_NO"
• "pl_PL"
• "sk_SK"
• "sv_SE"
• "tr_TR"
• "uk_UA"

Modello languages.json

[
  "en_US"
]