Bonjour à toutes et à tous.

Dans cette série de blog nous allons apprendre à créer un datapack de A à Z en abordant les concepts les plus basiques au plus pousser.

Cette série de blogs est un support à une série de vidéo. Bien qu'il ne soit pas nécessaire d'avoir vue la série pour comprendre ces blogs, le support visuel et les exemples pourront, je le pense, être d'une grande aide pour beaucoup de personnes.

Ceci étant dit, bonne lecture à vous.

Chapitre 0 : Les bases

Création :

Tout d'abord pour la création d'un datapack il vous faudra créer un dossier que vous renommerez comme vous le souhaitez et qui contiendras l'ensemble des fichiers nécessaires à votre datapack. Pour la bonne compréhension de ce blogs, notre dossier ce nommeras "TUTORIEL".

Notre dossier TUTORIEL étant maintenant créer nous allons créer à l’intérieur trois (3) éléments.

• Un dossier "data"
• Un fichier "pack.mcmeta"
• Un fichier "pack.png" => Ce fichier est optionnel, vous n'êtes pas obligé de l'ajouter à votre datapack.

Le dossier "data" contiendras l'ensemble des "espaces de noms" de notre datapack. Les "espaces de noms" sont des dossiers permettant de séparer nos fichiers afin de les rangés par catégories.

Le fichier "pack.mcmeta" est un fichier qui correspond à l'identité de notre datapack, ce fichier permet à Minecraft de comprendre que notre dossier TUTORIEL est un dossier datapack.

Enfin le fichier "pack.png" est l'icône de notre datapack, il permet, entre autre choses, de distinguer notre datapack dans l'interface d'ajout de datapacks à un monde minecraft.

C'est trois fichiers étant créer, il nous faut désormais créer l'identité de notre datapack.

Le fichier "pack.mcmeta" :

Dans le fichier pack.mcmeta, ajoutez le code suivant :
{
  "pack":{
    "pack_format":7,
    "description":"Ma description"
  }
}

Le code ci-dessus est composé de plusieurs éléments, à commencé par l'objet JSON "pack". C'est cet objet qui vas apporter à minecraft les informations nécessaires à l'interprétation de notre datapack.

Cet objet ce compose de deux (2) attributs, "pack_format" et "description".
L'attribut "pack_format" prendras pour valeur un entier numérique qui correspondras à la version de notre datapack. (Par "version" nous entendons la version à comprendre par minecraft).

Dans notre exemple, la valeur de cet attribut est "7" car c'est la version de datapack correspondant à la version courante de minecraft.



L'attribut "description" prendra pour valeur une chaîne de caractères étant la description, affichée dans l'interface d'ajout de datapack de minecraft, de notre datapack.

Les espaces de noms:

Dans le dossier "data" vous allez créer au moins deux (2) espaces de noms, "minecraft" et "example". (Vous pouvez nommer l'espace de nom "example" comme vous le souhaitez tant que vous utilisez des minuscules, des chiffres, des underscore (_) et/ou des tirets (-) ).

L'espace de nom "minecraft" contiendra l'ensemble des fichiers qui visent à modifier des comportements déjà présent dans minecraft vanilla (sans utilisation d'autres datapacks).

Les autre espaces de noms contiendrons l'ensemble des fichiers qui visent à ajouter des fonctionnalité à minecraft.

Synthèse :

Si vous avez suivie toutes les étapes correctement vous devriez vous retrouver avec un dossier ayant cette forme ci :

TUTORIEL
|->pack.mcmeta
|->pack.png (optionnel)
|->data
 |->minecraft
 |->example

Avec bien sûre les nom des dossiers "TUTORIEL"' et "example"' qui diffèrent.

Installation :

Pour installer votre datapack sur votre monde minecraft il existe deux (2) moyen :

A la création :

A la création de votre monde il possible d'ajouter un datapack en cliquant sur le bouton "Datapack", une interface vas alors s'ouvrir. Cliquez ensuite sur le bouton "Ouvrir le dossier Datapack" et glissez dans la fenêtre qui vient de s'ouvrir votre dossier "TUTORIEL". Fermez cette fenêtre et cliquez sur votre datapack dans l'interface de minecraft. Cliquez ensuite sur le bouton "Valider" et créez votre monde.

Après la création :

Si vous souhaitez ajouter un datapack à un monde déjà existant, ouvrez le dossier de votre monde (soit par l'interface de minecraft, soit avec l'invite de commande), cherchez dans le dossier de votre monde, le dossier datapack et glissez-y votre dossier "TUTORIEL".

Pour prendre en compte les modifications qu'apporte votre datapack, relancez votre monde ou utilisez la commande :
/datapack reload

Cette fonction rechargeras les datapack de votre monde.

Merci d'avoir lu le blog jusqu'ici, dans la prochaine version de ce blogs nous aborderons la création et la modification de recettes de minecraft simples (Déjà disponible ici => CLICK).



Lien vers le template du datapack => https://www.planetminecraft.com/data-pack/template-datapack/