Condividi tramite

Versioning del gioco base

Il versioning del gioco base permette di evitare che le modifiche apportate a Vanilla Minecraft: Bedrock Edition causino modifiche impreviste ai tuoi file del mondo. Ti permette di associare il tuo modello di mondo a una versione specifica di Minecraft, affinché le future modifiche al gioco non influiscano sui tuoi file .mcworld. Il versioning del gioco base non influisce sui tuoi pacchetti texture o pacchetti skin.

Ad esempio, se il tuo modello di mondo si basa sul comportamento di determinate entità o addirittura sui loro meccanismi di rigenerazione, il modello di mondo potrebbe funzionare in modi inaspettati se Minecraft viene aggiornato in modi che modificano i comportamenti interessati. Ad esempio, se utilizzi client versione 1.18, ma la base_game_version di un modello di mondo è impostata su 1.15, verranno caricate le risorse per tutte le versioni fino alla 1.15 e tutte le nuove risorse implementate tra la 1.16 e la 1.18 saranno ignorate.

Importante

Il versioning del gioco base è stato introdotto nella versione 1.13, quindi questa è la prima versione supportata da questo sistema. Non cercare di assegnare al parametro base_game_version un valore inferiore a 1.13.

Attenzione

Quando configuri i tuoi contenuti per il versioning di base, tieni presente che i contenuti potranno accedere solo ai contenuti relativi alla versione utilizzata. Ad esempio, se imposti "base_game_version": [1, 16, 0], non puoi utilizzare nessun contenuto di Caverne e scogliere in cui sono stati introdotti i componenti aggiuntivi nella versione [1, 17, 0].

In questo tutorial imparerai quanto segue:

  • Come applicare il versioning del gioco base per limitare le versioni in cui i tuoi modelli di mondo per Minecraft: Bedrock Edition potranno essere utilizzati.
  • Come aggiornare un modello di mondo esistente rilasciato nel marketplace.
  • Come gestire potenziali problemi quando aggiorni un modello di mondo alla versione 1.18.

Requisiti

Prima di iniziare questo tutorial, ti consigliamo di completare i seguenti passaggi:

Configurazione

Nell'intestazione del file manifest del modello di mondo dovrai specificare la versione di Minecraft per la quale il modello di mondo è stato creato. Per farlo si usa un campo chiamato base_game_version.

Se il tuo contenuto è indipendente dalla versione (una semplice generazione a tema sopravvivenza, ad esempio, che difficilmente presenterà dei malfunzionamenti con gli aggiornamenti futuri), puoi rinunciare a bloccare il tuo contenuto per una versione specifica utilizzando un "carattere jolly": "base_game_version": "*".

Esempio

Di seguito trovi un file manifest.json di esempio per un modello di mondo che utilizza [1, 13, 0] come base_game_version. Se lo utilizzi, ricorda di aggiornare gli UUID dell'intestazione e dei moduli.

{
    "format_version": 2,
    "header": {
        "name": "pack.name",
        "description": "pack.description",
        "version": [ 1, 0, 0],
        "lock_template_options": true,
        "base_game_version": [ 1, 13, 0],
        "uuid": "<FIRST GENERATED UUID>"
    },
    "modules": [
        {
        "version": [ 1, 0, 0],
        "type": "world_template",
        "uuid": "<SECOND GENERATED UUID>"
        }
    ],
    "metadata": {
        "authors": ["Author Name"]
    }
}

Specificare la versione per la quale il tuo mondo è verificato riduce notevolmente la probabilità di malfunzionamenti nelle versioni future di Minecraft. Il versioning del gioco base non sostituisce le procedure di test e manutenzione dei contenuti, ma ti consente di dedicare più tempo alla creazione di elementi nuove anziché alla correzione dei contenuti esistenti.

Aggiornamento di una versione del gioco base di un modello di mondo nel Minecraft Marketplace

Oggi un creatore può inviare un aggiornamento al proprio modello di mondo in qualsiasi momento. Questi aggiornamenti possono includere la revisione della versione del gioco base del relativo modello di mondo a una versione più recente.

Quando il modello del mondo viene aggiornato nel Minecraft Marketplace:

  1. Tutti i nuovi mondi creati dal modello seguiranno il più recente stato disponibile.
  2. ANCHE tutti i mondi istanziati dal modello riceveranno l'aggiornamento.

Questo comportamento permette ai creatori del marketplace di aggiornare i propri prodotti in qualsiasi momento per risolvere bug e altri problemi nella produzione.

Aggiornamento del gioco base di un modello di mondo alla versione 1.18

Con l'imminente rilascio della versione 1.18 per Caverne e scogliere Parte 2, stiamo apportando notevoli modifiche alla generazione di mondi. Vi è la possibilità che il contenuto si danneggi quando si lavora con i modelli esistenti.

Per garantire che il contenuto continui a funzionare come previsto, i creatori di Minecraft Marketplace non potranno aggiornare la versione del gioco base del proprio contenuto alla versione 1.18+ dopo il rilascio del client v1.18. Si tratta di una misura temporanea per assicurare che il contenuto continui a funzionare come previsto dopo questo importante aggiornamento.

I creatori della community devono essere a conoscenza di un potenziale scenario:

  1. Un creatore crea un modello di mondo denominato TemplateA e imposta la base_game_version su [1, 17, 0].
  2. Un giocatore apre Minecraft: Bedrock Edition v1.18 e scarica il TemplateA.
  3. Il creatore istanzia un nuovo mondo utilizzando il TemplateA e lo chiama WorldA.
  4. Il creatore imposta la base_game_version del TemplateA su [1, 18, 0].
  5. Il giocatore apre il WorldA.

In questo scenario un creatore crea e rilascia un modello di mondo per una versione di Minecraft che non utilizza le modifiche all'altezza dei mondi aggiornate. Se il creatore aggiorna il modello esistente alla versione [1, 18, 0] (che utilizza la nuova altezza dei mondi), i mondi che i giocatori hanno generato mediante tale modello si aggiorneranno automaticamente alla nuova altezza dei mondi. Ciò può potenzialmente modificare il layout dei mondi e danneggiare il contenuto esistente.

Per evitare qualsiasi perdita di informazioni, è consigliabile creare una copia del modello esistente, TemplateB dello scenario descritto, con la base_game_version impostata su [1, 18, 0] e utilizzare questo nuovo modello per distribuirlo ai giocatori.

  1. Un creatore crea un modello denominato TemplateA e imposta la base_game_version su [1.17.4] o sulla versione precedente.
  2. Un giocatore apre Minecraft: Bedrock Edition in una versione precedente alla 1.18 e scarica il TemplateA.
  3. Il creatore istanzia un nuovo mondo utilizzando il TemplateA denominato WorldA.
  4. Il client di Minecraft: Bedrock Edition viene aggiornato alla versione 1.18+.
  5. Il creatore copia il TemplateA e crea un TemplateB con la base_game_version impostata su [1, 18, 0].
  6. Il creatore testa e convalida il TemplateB prima della pubblicazione.
  7. Il giocatore scarica il TemplateB e crea un nuovo mondo, WorldB.