Les mcfunctions avec le plugin

Ce tutoriel vous expliquera comment utiliser les fonctions minecraft avec le plugin.

⚠️ Si votre serveur est dans une version antérieur à la 1.12 ce tutoriel ne fonctionnera pas !

Une fonction ?

D'abord, qu'est-ce qu'une fonction dans (ou en anglais function) ?

Une fonction est une liste de commande/tâche qui s'exécute grâce à des déclencheurs (lors de la réalisation d'un progrès par exemple).

Activer les fonctions avec le plugin ?

Il existe deux déclencheurs avec le plugin :

• newday → s'exécute quand un jour est passé.
• win → s'exécute quand une équipe capture la salle des coffres d'une équipe adverse.

Pour commencer, il faut activer les fonctions avec le plugin, donc rendez-vous dans ./plugins/FallenKingdom/config.yml

Aperçu du fichier config.yml par défaut :

#Activer ou non la vérification des permissions lorsqu'une commande est exécutée
enable-permissions: false

#Activer ou non le support des .mcfunction personnalisées (à partir de la 1.12)
enable-mcfunction-support: false

#Fichier de langue chargé
lang: "unknown"

# Choisir si le plugin s'active seulement dans certains mondes
world-check: false
# Mondes affectés par le plugin
affected-worlds:
  - world
  - world_nether
  - world_the_end

Il suffit maintenant de mettre true à la place de false sur la ligne 5 ! À présent que nous avons activé le support des fonctions avec le plugin, avant de créer nos propres fonctions, on va voir où devons-nous les créer !

Chemin d'accès

1.12	1.13+
world/data/functions/fallenkingdom	world/datapacks/<datapack>/data/fallenkingdom/functions

Les fonctions sont stockées dans le répertoire de la carte principale du serveur. Par défaut le monde se situe dans le dossier world. Ces répertoires sont à créer s'ils n'existent pas.

En 1.12, les fonctions sont directement définies pour le monde.

À partir de la 1.13, ce sont les packs de données ou datapacks en anglais qui contiennent les fonctions et d'autres ressources pour le jeu. Remplacez <datapack> par le nom de votre choix. Ajoutez un fichier pack.mcmeta pour que le datapack soit reconnu (world/datapacks/<datapack>/pack.mcmeta).

{
    "pack": {
        "description": "fk functions",
        "pack_format": 7
    }
}

Créer nos fonctions

La plupart des éditeurs de texte peuvent faire l'affaire pour commencer (bloc-notes, notepad++ etc).

Comme dit plus haut, la fonction newday s'exécutera à chaque nouveau jour. Nous allons créer cette fonction qui sera appelée à chaque nouveau jour :

• 1.12 : world/data/functions/fallenkingdom/newday.mcfunction
• 1.13+ : world/datapacks/<datapack>/data/fallenkingdom/functions/newday.mcfunction

Désormais, ouvrez votre fichier newday.mcfunction et écrivez la commande à exécuter sans le / (une commande par ligne). Nous utiliserons pour l'exemple les commandes tellraw et title.

J'ai envie qu'à chaque nouveau jour, il y ait écrit : "Bonjour !" avec la couleur verte dans le tchat et qu'un titre s'affiche sur l'écran avec écrit : "Un jour est passé !" de couleur jaune. Pour faire cela notre fichier newday.mcfunction ressemblera à ça :

tellraw @a {"text":"Bonjour !","color":"green"}
title @a title {"text":"Un jour est passé !","color":"yellow"}

Rendu en image :

Si vous avez du mal avec le JSON le site Minecraft Tools peut vous aider à générer certaines commandes !