Gestion des versions du jeu de base

La gestion des versions du jeu de base est un moyen d’empêcher les modifications apportées à la version standard de Minecraft: Bedrock Edition de provoquer des changements inattendus dans vos fichiers de monde. Cela vous permettra de verrouiller votre modèle de monde sur une version spécifique de Minecraft et de garantir que les futurs modifications du jeu n'influenceront pas vos fichiers .mcworld. La gestion des versions du jeu de base n'affectera pas vos packs de textures ou de skins.

Par exemple, si votre modèle de monde repose sur le comportement de certaines entités, ou même sur leurs mécanismes d’apparition, le modèle de monde peut être endommagé de manière inattendue si Minecraft est mis à jour d’une manière qui modifie ces comportements. Par exemple, si vous exécutez un version client 1.18, mais que la base_game_version d’un modèle de monde est définie sur 1.15, les ressources pour toutes les versions jusqu'à 1.15 seront chargées, en ignorant toutes les autres nouvelles ressources intégrées dans les versions de 1.16 à 1.18.

Important

La gestion des versions du jeu de base a été introduite dans la version 1.13, c’est donc la version du jeu la plus récente qui est compatible avec ce système. N’essayez pas de définir votre base_game_version sur toute version antérieure à 1.13.

Attention

Lors de la configuration de votre contenu pour la gestion des versions de base, veuillez noter que votre contenu ne pourra accéder qu’au contenu relatif à la version utilisée. Par exemple, si vous mettez en place la "base_game_version": [1, 16, 0], vous ne pouvez pas utiliser n’importe quel contenu Cavernes et falaises dans vos extensions introduites dans [1, 17, 0].

Dans ce tutoriel, vous apprendrez les éléments suivants:

  • Comment appliquer la gestion des versions du jeu de base pour restreindre les versions dans lesquelles vos modèles de monde Minecraft: Bedrock Edition peuvent être utilisés.
  • Comment mettre à jour un modèle de monde existant qui a été publié dans le Magasin.
  • Comment gérer les problèmes potentiels lors de la mise à jour d'un modèle de monde vers la version 1.18.

Conditions

Nous vous recommandons de compléter les étapes suivantes avant de commencer ce tutoriel.

Configuration

Dans l'en-tête du manifeste de votre modèle de monde, vous devrez indiquer la version de Minecraft pour laquelle votre modèle de monde a été créé. Cela se fait à l'aide d'un champ appelé base_game_version.

Si votre contenu ne dépend d'aucune version, tel qu'un simple spawn survie qui est peu susceptible d'être endommagé par les futures mises à jour, vous pouvez renoncer à verrouiller votre contenu sur une version spécifique en utilisant un «métacaractère»: "base_game_version": "*".

Exemple

Vous trouverez ci-dessous un exemple de manifest.json pour un modèle de monde qui utilise une base_game_version de [1, 13, 0]. Si vous l'utilisez, n'oubliez pas de mettre à jour les UUID d'en-tête et de modules.

{
    "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"]
    }
}

Le fait d'indiquer la version pour laquelle votre monde est vérifié le rend beaucoup moins susceptible d'être endommagé dans les futures versions de Minecraft. La gestion des versions du jeu de base ne remplace pas les tests approfondis et la maintenance de votre contenu, mais elle vous permet de passer plus de temps à vous concentrer sur la création de nouveaux éléments intéressants plutôt que la réparation de l'ancien contenu.

Mise à jour de la version de base du jeu d'un modèle de monde dans le Magasin Minecraft

Aujourd'hui, un créateur peut soumettre une mise à jour de son modèle de monde à tout moment. Ces mises à jour peuvent inclure la révision de la version de base du jeu de leur modèle de monde pour une nouvelle version plus récente.

Lorsque le modèle de monde est mis à jour dans le Magasin Minecraft:

  1. Tous les mondes créés récemment à partir du modèle suivront le dernier état disponible.
  2. Tous les mondes instanciés à partir du modèle seront ÉGALEMENT mis à jour.

Ce comportement permet aux créateurs du Magasin de mettre à jour leurs produits quand ils le souhaitent pour résoudre les bugs et tout autre problèmes survenant pendant la production.

Mise à jour de la version de base du jeu d'un modèle de monde vers 1.18

Avec la prochaine version 1.18 de Cavernes et falaises, 2epartie, nous apportons des modifications significatives à la génération de mondes. Il se peut que votre contenu soit endommagé lorsque vous travaillez avec des modèles existants.

Pour s'assurer que votre contenu continue de fonctionner comme prévu, les créateurs du Magasin Minecraft ne pourront pas mettre à jour la version de base du jeu de leur contenu vers la version 1.18+ après la sortie de la version 1.18 client. Il s'agit d'une mesure temporaire pour garantir que le contenu continue de fonctionner comme prévu après cette importante mise à jour.

Les créateurs de la communauté doivent être conscients d'un des scénarios possibles suivants:

  1. Un créateur crée un modèle de monde appelé TemplateA et configure la base_game_version sur [1, 17, 0].
  2. Un joueur ouvre Minecraft: Bedrock Edition v1.18 et télécharge TemplateA.
  3. Le créateur instancie un nouveau monde en utilisant TemplateA et l'appelle WorldA.
  4. Le créateur met à jour le TemplateA de la base_game_version vers [1, 18, 0].
  5. Le joueur ouvre le monde WorldA.

Dans ce scénario, un créateur crée et publie un modèle de monde pour une version de Minecraft qui n'utilise pas les changements de hauteur du monde actualisé. Si le créateur met à jour le modèle existant vers la version [1, 18, 0] qui utilise la nouvelle hauteur de monde, alors les mondes que les joueurs ont générés à l'aide de ce modèle seront automatiquement mis à jour avec cette nouvelle hauteur. Cela peut potentiellement modifier la disposition des mondes et endommager le contenu existant.

Afin d'éviter toute perte d'informations, il est recommandé de créer une copie du modèle existant, TemplateB de notre scénario, dont la base_game_version est définie sur la version [1, 18, 0] et d'utiliser ce nouveau modèle pour le distribuer aux joueurs.

  1. Un créateur crée un modèle appelé TemplateA et définit la base_game_version sur [1.17.4] ou une autre version précédente.
  2. Un joueur ouvre Minecraft: Bedrock Edition dans une version antérieure à 1.18 et télécharge TemplateA.
  3. Le créateur instancie un nouveau monde en utilisant TemplateA nommé WorldA.
  4. La version client Minecraft: Bedrock Edition est actualisée vers la v1.18+.
  5. Le créateur copie TemplateA et crée un TemplateB avec la base_game_version définie sur [1, 18, 0].
  6. Le créateur teste et valide le TemplateB avant de le publier.
  7. Le joueur télécharge le modèle TemplateB et crée un nouveau monde, WorldB.