Les commandes sont de courtes lignes de texte qui déclenchent des actions dans Minecraft : donner des objets, téléporter des joueurs, faire apparaître des créatures, changer la météo et bien plus. C'est aussi le moyen le plus simple d'ajouter de la logique à un add-on, car tu peux les regrouper dans des fonctions.
La méthode rapide : GodCraft
Dans GodCraft, tu écris tes commandes dans une Fonction, avec des suggestions qui proposent les noms de commandes et les arguments pendant que tu tapes.
- Ouvre l'Atelier et ajoute une Fonction à ton add-on.
- Tape tes commandes. Les suggestions t'aident à respecter la syntaxe.
- Choisis quand elle s'exécute : à chaque tick, une fois au chargement du monde, ou seulement quand tu tapes
/function. - Exporte-la avec le reste de ton add-on.
La suite de cette page t'apprend le langage des commandes lui-même, dont tu as besoin dans tous les cas.
Activer les cheats
La plupart des commandes ne fonctionnent que si les cheats sont activés.
- Ouvre les paramètres de ton monde.
- Active Activer les cheats (dans la section Jeu ou Cheats).
- Ouvre le chat et tape
/. Une liste de commandes apparaît.
Succès
Activer les cheats désactive les succès pour ce monde, même si tu les désactives plus tard. Utilise un monde de test séparé pour travailler sur tes add-ons.
Quelques commandes, comme /say et /tell, fonctionnent sans cheats.
La syntaxe des commandes
Chaque commande commence par son nom, suivi d'arguments séparés par des espaces :
/give @p minecraft:diamond 5giveest la commande.@pdésigne qui reçoit l'objet (un sélecteur de cible, voir plus bas).minecraft:diamondest l'identifiant de l'objet. Pour les objets vanilla, tu peux omettreminecraft:.5est la quantité. Elle est facultative : si tu ne la mets pas, tu en obtiens 1.
Les pages de référence indiquent les arguments obligatoires et facultatifs. Par exemple, /give a besoin d'un joueur et d'un objet, alors que la quantité et les données sont facultatives. Chaque argument doit être dans le bon ordre, et tu ne peux pas sauter un argument facultatif pour définir celui qui le suit.
Astuce
Dans le chat, les commandes commencent par /. Dans les fichiers de fonction et les blocs de commande, la barre oblique est facultative et on l'omet généralement.
Les sélecteurs de cible
Un sélecteur de cible choisit les joueurs ou les entités concernés par une commande.
| Sélecteur | Choisit |
|---|---|
@p | Le joueur le plus proche |
@a | Tous les joueurs |
@r | Un joueur au hasard |
@s | Toi-même : l'entité qui exécute la commande |
@e | Toutes les entités (créatures, objets, joueurs, etc.) |
@initiator | Le joueur qui parle à un PNJ (utilisé dans les boutons de dialogue des PNJ) |
Tu peux aussi taper le nom d'un joueur au lieu d'un sélecteur, comme /give Steve diamond. Les noms avec des espaces se mettent entre guillemets : "Steve Two".
Les arguments de sélecteur
Ajoute des arguments entre crochets pour affiner la sélection. Sépare-les par des virgules, et ne mets pas d'espaces autour du =.
/kill @e[type=minecraft:zombie,r=10]Ceci supprime uniquement les zombies à moins de 10 blocs. Les arguments les plus utiles :
| Argument | Signification | Exemple |
|---|---|---|
type | Type d'entité | @e[type=minecraft:cow] |
name | Nom ou étiquette de nom | @e[name=Bob] |
family | Famille de type de la créature | @e[family=monster] |
r et rm | Distance maximale et minimale | @a[r=20] |
c | Combien en choisir, les plus proches d'abord | @e[type=minecraft:pig,c=3] |
tag | Possède un tag ajouté avec /tag | @a[tag=red_team] |
m | Mode de jeu | @a[m=survival] |
l et lm | Niveau d'XP maximal et minimal | @a[lm=10] |
x, y, z | Point à partir duquel mesurer la distance | @e[x=0,y=64,z=0,r=5] |
scores | Valeurs du tableau des scores | @a[scores={points=10..}] |
Ajoute ! pour inverser un test : @e[type=!minecraft:player] veut dire "toutes les entités qui ne sont pas des joueurs". Un c négatif choisit les plus éloignées au lieu des plus proches.
Tes propres créatures marchent aussi. Si tu as créé myname:critter dans Ta première créature personnalisée, essaie @e[type=myname:critter] ou @e[family=critter].
Les coordonnées
Les positions s'écrivent avec trois nombres : x (est et ouest), y (haut et bas) et z (sud et nord).
Coordonnées absolues
Des nombres simples désignent des emplacements précis dans le monde :
/tp @s 100 70 -250Coordonnées relatives : ~
Un tilde ~ veut dire "à partir de l'endroit où la commande s'exécute", mesuré selon les axes du monde. Un nombre après lui ajoute un décalage.
/tp @s ~ ~10 ~
/setblock ~2 ~ ~ minecraft:gold_block
/summon minecraft:pig ~ ~1 ~~ ~10 ~correspond à 10 blocs tout droit vers le haut.~2 ~ ~correspond à 2 blocs vers l'est.- Un
~seul veut dire "aucun changement" sur cet axe.
Voir /teleport, /setblock et /summon.
Coordonnées locales : ^
Un accent circonflexe ^ se mesure à partir de la direction où l'entité regarde : gauche, haut et avant.
/tp @s ^ ^ ^5Ceci te déplace de 5 blocs dans la direction où tu regardes, même si tu regardes en diagonale. Les trois parties sont ^left ^up ^forward, et les nombres négatifs vont dans l'autre sens.
Remarque
Tu ne peux pas mélanger ^ avec ~ ou des nombres simples dans une même position. Utilise ^ pour les trois, ou pour aucune.
Exécuter des commandes à la place des autres
/execute change qui exécute une commande et où. C'est la commande la plus puissante du jeu :
/execute as @a at @s run summon minecraft:lightning_bolt ~ ~ ~Lis-la de gauche à droite : pour chaque joueur (as @a), à sa propre position (at @s), exécute un summon. Dans /execute, @s désigne tour à tour chaque entité sélectionnée, et ~ ~ ~ est sa position.
Quelques commandes à essayer
/give @s minecraft:diamond_sword
/effect @a minecraft:speed 30 1
/time set day
/weather clear
/say Hello, world!
/kill @e[type=minecraft:item]- /effect donne Vitesse II pendant 30 secondes (l'amplificateur 1 correspond au niveau II).
- /time et /weather modifient le monde.
- La dernière supprime tous les objets au sol, ce qui est pratique quand un test devient le bazar.
Et ensuite
- Mets tes commandes dans un fichier pour en exécuter plusieurs d'un coup : Fonctions et blocs de commande.
- Utilise /function pour les déclencher depuis le chat.
- Parcours toutes les commandes dans la référence des commandes, en commençant par /execute.