Fonction (édition Bedrock)

Pour la commande, voir Commandes/fonction. : Fonction (Édition Java) Il a été suggéré que cette page soit déplacée vers les fonctions de l'édition Bedrock.
Si ce déplacement affecte de nombreuses pages ou peut potentiellement être controversé, ne déplacez pas la page jusqu'à ce qu'un consensus soit atteint. [discuter] Raison: Cohérence avec d'autres articles qui ont une variante Java et substratum ; il faut discuter du pluriel
Lors du déplacement, assurez-vous d'utiliser l'outil approprié au lieu de simplement copier et coller le contenu de la page, afin de préserver l'historique des modifications. Cette fonctionnalité est exclusive à Bedrock Edition. 

Les fonctions permettre aux joueurs d'exécuter des listes de commandes à l'aide de fichiers texte avec l'extension .mcfunction. Cette page explique comment utiliser les fonctions de Bedrock Edition.

Contenu

• Utilisation de 1
  • 1.1 Sous-dossiers et espacement des noms
  • 1.2 /recharger
  • 1.3 Résultats de réussite
• 2 Syntaxe de la fonction
  • 2.1 min_engine_version
    • 2.1.1 Exemple de manifeste
    • 2.1.2 Exemple de fonction simple
    • 2.1.3 Exemple de fonction plus complexe
• 3 Exécuter une fonction
  • 3.1 Limites
  • 3.2 commandes
    • 3.2.1 /fonction
• 4 Histoire

Utilisation

Les fichiers texte doivent être placés dans un dossier de niveau supérieur nommé « functions » au sein d'un pack de comportement, situé à l'adresse com.mojang/behavior_packs/[behavior_pack]/functions.

Sous-dossiers et espacement des noms

Des sous-dossiers peuvent être ajoutés à ce dossier pour servir d'espaces de noms.

Par exemple, l'exécution de la fonction sub/foo exécute le fichier situé dans [behavior_pack]/functions/sub/foo.mcfunction.

/ recharger

A Noter: Actuellement, /reload recharge uniquement les fonctions qui existent déjà au moment du lancement du jeu, ce qui signifie que des modifications peuvent être apportées aux fonctions existantes, mais le jeu doit être redémarré pour les fonctions nouvellement ajoutées.

Résultats de réussite

Lors de l'exécution réussie d'une fonction, un message s'affiche dans le chat : « Executed [amount] Command(s) from function [function file directory]." Dans la version 1.12.0, il s'agit des « entrées de fonction [quantité] exécutées avec succès. »

Syntaxe de la fonction

Dans le fichier .mcfunction, une commande valide est placée par ligne, sans la barre oblique habituelle /. Les joueurs peuvent ajouter des commentaires dans le fichier texte de la fonction en les faisant précéder d'un #.

min_engine_version

Les fonctions nécessitent une version de moteur minimale spécifiée dans le fichier pack manifest.json.

Ce champ détermine la version d'une commande à exécuter. Le numéro spécifié ici doit correspondre au numéro de version du jeu. Par exemple, disons que /fill a été modifié dans la 1.9.0. Si votre pack de comportement a "min_engine_version": [1, 8, 0] et exécute une fonction qui contient /fill, il exécute l'ancienne version de fill (comme si la version était toujours la 1.8.0).

Exemple de manifeste

{ "format_version": 1, "header": { "description": "Function worldedit", "name": "Function worldedit", "uuid": "11111111-1111-1111-1111-111111111111", "version": [1, 11, 3], "min_engine_version": [1, 11, 3] }, "modules": [ { "description": "", "type": "data", "uuid": "22222222-2222 -2222-2222-222222222222", "version": [1, 11, 3] } ] }

Exemple de fonction simple

title @p title Test setblock ~ ~2 ~ diamond_ore say Test #ceci est un commentaire

Exemple de fonction plus complexe

Cette fonction construit une maison de base en pierre et bois autour de l'exécuteur. Notez que parce que la fonction exécute les commandes dans l'ordre, les fenêtres en verre et la porte en bois remplacent les murs de pierre créés par la première commande.

remplissage ~-2 ​​~-1 ~-2 ~2 ~2 ~2 brique de pierre 0 remplissage creux ~-2 ~-1 ~-2 ~2 ~-1 ~2 planches remplissage ~ ~ ~2 ~ ~ ~2 bois_porte 1 remplissage ~ -2 ~1 ~ ~-2 ~1 ~ verre rempli ~2 ~1 ~ ~2 ~1 ~ verre rempli ~ ~1 ~-2 ~ ~1 ~-2 verre

Exécuter une fonction

Les fonctions tentent d'exécuter toutes les commandes dans un seul tick, y compris les commandes des fonctions imbriquées appelées dans une autre fonction.

Limites

Un seul appel de fonction exécute jusqu'à 10,000 XNUMX commandes (y compris les appels à d'autres fonctions, c'est-à-dire la récursivité).

Commandes

/fonction

• Permet aux joueurs d'exécuter une fonction une fois
• Les commandes de la fonction sont exécutées via l'entité ou le bloc de commandes qui a exécuté la commande /function.
• Utilisation : /fonction

Histoire