Introduction aux fonctions

Alors que les commandes de Minecraft: Bedrock Edition permettent aux créateurs d'ajouter des fonctionnalités de logique et d'expérience de jeu à leurs extensions, elles nécessitent qu'un utilisateur saisisse manuellement leurs arguments ou configure des chaînes élaborées de blocs de commandes pour une exécution correcte. Cependant, avec les fichiers de fonction, vous pouvez regrouper plusieurs commandes dans un seul fichier, ce qui vous permet d'exécuter une série de commandes en une seule exécution. Avec les fonctions, vous pouvez définir des moyens de générer des bâtiments et des structures autour d'un joueur sélectionné, de configurer un système de récompense pour offrir des objets à un joueur ou de téléporter des joueurs vers des emplacements relatifs.

Conseil

Minecraft ne peut pas exécuter plus de 10000commandes dans un seul fichier de fonction. Cela inclut les commandes de fonction exécutées par la fonction d'origine. Nous ne recommandons cependant pas d'exécuter autant de commandes à la fois, car cela affecterait la performance de votre jeu.

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

• Comment créer un fichier de fonction.
• Comment utiliser un fichier de fonction dans le jeu.

Conditions

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

• Introduction aux packs de comportement
• Introduction aux commandes

Vous aurez également besoin des éléments suivants:

• Votre propre dossier de pack de comportement contenant déjà un fichier manifest.json.
• Un monde Minecraft avec des commandes de triche activées.

Configuration du dossier Fonctions

Les fichiers de fonction ont une extension .mcfunction et sont localisés dans le dossier fonctions de votre pack de comportement.

1. Commencez par créer un dossier dans votre pack de comportements et nommez-le functions. Ce dossier doit être au même niveau que votre fichier manifest.json.

2. Ouvrez le dossier functions et créez un fichier texte.

3. Nommez le fichier ouch.mcfunction.

4. Ouvrez le fichier, puis copiez et collez-y le code suivant:

   say Bye...
   teleport @s ~10 ~10 ~10 true
   say OUCH!
   

5. Enregistrez le fichier.

Important

Lorsque vous travaillez avec des commandes dans un fichier .mcfunction, les commandes n'ont pas besoin de commencer par /.

Tester la fonction

1. Lancez Minecraft.
2. Ouvrez un monde où les commandes de triche doivent être activées et le pack de comportement créer doit être appliqué.
3. Saisissez /function ouch.

Fonctionnalité de fonction avancée

Vous pouvez placer des fonctions dans des répertoires pour les organiser et éviter les conflits avec les fonctions présentes d'autres packs de comportement.

Par exemple, si vous avez un autre dossier dans votre dossier de fonctions nommé init et que vous placez ouch.mcfunction dedans, vous l'exécuteriez de cette façon: /function init/ouch

Étape suivante

Maintenant que vous avez une vue d'ensemble du fonctionnement d'un fichier de fonction, vous pouvez apprendre à utiliser la fonction tick dans le jeu et un fichier tick.json afin de déclencher des fonctions personnalisées de façon répétitive.

Introduction au fichier tick.json