Condividi tramite


Creazione del pacchetto di un modello di mondo

In questo tutorial imparerai quanto segue:

  • Che cos'è un modello di mondo e come può essere utilizzato.
  • La struttura di cartelle e file necessaria per la creazione di modelli di mondo.

Un modello di mondo è un framework che può essere utilizzato per creare nuovi mondi basati sul modello. Ogni mondo creato dal modello è uguale, il che è particolarmente utile per le generazioni a tema sopravvivenza. Tutti i mondi nel marketplace sono modelli di mondo. Un modello di mondo presenta l'estensione file .mctemplate e ha una struttura leggermente diversa rispetto a un normale file di mondo (.mcworld).

Per creare il pacchetto di un modello di mondo, crei una cartella world_template che contiene i file del mondo (una cartella db con un file manifest.json, level.dat, ecc.), world_behavior_packs.json, world_resource_packs.json e la tua chiave grafica come ad esempio world_icon.jpeg. Se disponi di un pacchetto di comportamenti, inseriscilo nella cartella world_template (vedi Introduzione ai pacchetti di comportamenti per la creazione di tali pacchetti).

Infine devi limitare la lunghezza dei nomi delle cartelle del pacchetto di risorse e del pacchetto di comportamenti a 10 caratteri o meno. Ciò è dovuto a un problema su Xbox per cui i percorsi lunghi possono impedire il caricamento corretto del pacchetto di risorse o di comportamenti. Ti consigliamo di utilizzare un acronimo del titolo del tuo contenuto per i nomi delle cartelle del pacchetto.

Avviso

Con il rilascio della versione 1.18, i modelli creati con la versione del gioco base 1.17.4 o precedente saranno aggiornati con il nuovo strumento di generazione del mondo e il contenuto potrebbe danneggiarsi durante la creazione di nuove mappe basate su tale modello.

Per saperne di più su questo scenario, fai riferimento a Aggiornamento del gioco base di un modello di mondo alla versione 1.18

Struttura delle cartelle del modello di mondo

Nell'immagine seguente viene mostrato come può essere configurata la struttura di una cartella Modello di mondo.

Struttura delle cartelle dell'intero modello di mondo

Importante

Il percorso massimo predefinito dei file consentito in Windows 10 è di 260 caratteri. Presta attenzione quando imposti la tua directory di cartelle e usa abbreviazioni se hai quasi raggiunto il limite di caratteri.

manifest.json

Crea un file JSON chiamato manifest.json che definisca il tuo contenuto come un modello di mondo.

  • name: questo campo è sempre pack.name
  • description: questo campo è sempre pack.description
  • version: questo dice al gioco di quale versione del pacchetto si tratta. Crei sempre nuovi contenuti con [1, 0 ,0]
  • uuid: devi generare due diversi UUID da questo sito: https://www.uuidgenerator.net/version4.
  • type: questo dice al gioco di trattare il pacchetto come un modello di mondo

Modello manifest.json del modello di mondo:

{
  "header": {
    "name": "pack.name",
    "description": "pack.description",
    "version": [1, 0, 0],
    "uuid": "<GENERATE A UUID>"
  },
  "modules": [
    {
      "version": [1, 0, 0],
      "type": "world_template",
      "uuid": "<GENERATE A UUID>"
    }
  ],
  "format_version": 2
}

world_behavior_packs.json e world_resource_packs.json

Se il tuo mondo richiede un pacchetto di risorse e/o comportamenti, devi definirli esplicitamente qui utilizzando il pulsante uuid dei pacchetti. Entrambi questi file JSON utilizzano lo stesso formato, ma devi avere la certezza di inserire il corretto uuid in ciascuno dei file.

  • pack_id: l'UUID della risorsa richiesta o del pacchetto di comportamenti.
  • Assicurati che world_resource_packs.json contenga solo i pacchetti di risorse richiesti e che world_behavior_packs.json contenga solo i pacchetti di comportamenti richiesti.
  • version: la versione del pacchetto di risorse o comportamenti, definita nel file manifest.json dei pacchetti.

Modello world_behavior/resource_packs.json:

[
    {
        "pack_id": "<UUID FROM REQUIRED PACK>",
        "version": [1, 0, 0]
    }
]

world_icon.jpeg

Questa è l'immagine che appare quando viene creato il mondo dal modello. Per i modelli di mondo sul marketplace, questa icona dovrebbe avere uno stile simile alla tua chiave grafica. I modelli esterni al marketplace non necessitano di un'icona del mondo, anche se qualora un modello venga creato da un mondo esistente, l'icona del mondo sarà già disponibile per l'uso.

  • Dimensioni: 800x450 px
  • Formato del file: JPEG

Cartella testi

La cartella dei testi all'interno della cartella world_template è il posto in cui vengono definiti il nome e la descrizione del tuo mondo nel file en_US.lang.

Struttura delle cartelle per i testi

en_US.lang

Qui è dove vengono definiti il nome e la descrizione del tuo mondo. Nel tuo file .lang devono essere riportate queste due righe:

  • Nome del pacchetto: pack.name=[name of pack]
  • Descrizione del pacchetto: pack.description=[description of pack]
    • Usa un "Elevator Pitch" che riassuma brevemente i tuoi contenuti.

Modello en_US.lang:

I nomi dopo = corrispondono a ciò che apparirà nell'interfaccia utente del gioco.

pack.name=Western World
pack.description=Howdy partner

languages.json

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

Modello languages.json:

[
    "en_US"
]