Introduction

Au cours de ce projet, vous allez explorer le monde virtuel de Minecraft Pi, l’édition spéciale de Minecraft développée pour le Raspberry Pi. Vous apprendrez à contrôler le joueur, à construire avec des blocs manuellement et à utiliser l’interface Python pour manipuler le monde autour de vous.

Minecraft est un jeu vidéo très populaire de type construction libre (“sandbox”). Une version gratuite de Minecraft est disponible pour le Raspberry Pi. Cette version vient aussi avec une interface de programmation. Vous pouvez ainsi écrire des commandes et scripts en language Python pour construire et manipuler des éléments dans le jeu automatiquement. C’est une bonne manière d’apprendre Python!

Lancer et utiliser Minecraft

Liste de contrôle d’activité

• Lancez Minecraft à partir du menu ou bien tapez minecraft-pi dans le terminal.

• Une fois Minecraft lancé, cliquez sur Start Game, suivi de Create New.

(Dans certains cas, il se peut que la fenêtre apparaisse légèrement décalée par rapport à l’affichage du jeu. Cela veut dire que pour déplacer la fenêtre, vous devez attraper la barre de titre derrière l’affichage du jeu.)

Vous êtes maintenant dans une partie de Minecraft! Promenez-vous, modifiez et construisez des choses!

• Utilisez la souris pour regarder autour de vous et utilisez les touches suivantes du clavier:

• Vous pouvez choisir des items du panneau d’accès rapide situé au bas de la fenêtre en utilisant la roulette de la souris (ou les chiffres du pavé numérique). Vous pouvez presser E et choisir un item de votre inventaire complet.

• Vous pouvez presser deux fois la barre d’espace pour voler dans les airs. Vous arrêterez de monter en relâchant la barre d’espace et retomberez au sol si vous la pressez deux fois à nouveau.

• Avec l’épée en main, vous pouvez cliquer sur des blocs devant vous pour les enlever (ou creuser). Avec un bloc en main, vous pouvez utiliser le clic droit pour placer le bloc devant vous ou le clic gauche pour enlever un bloc.

Utiliser l’interface de programmation Python

Liste de contrôle d’activité

• Avec Minecraft Pi lancé et un monde créé, appuyez sur Tab pour libérer la souris et accéder au bureau du Raspberry Pi. Lancez Python 3 (IDLE) à partir du menu et déplacez la fenêtre pour qu’elle soit côte-à-côte avec celle de Minecraft Pi.

Vous pouvez soit saisir les commandez directement dans la fenêtre de Python ou bien créer un fichier séparé que vous pourrez sauvegarder et ré-exécuter à nouveau plus tard. Si vous voulez créer un fichier, cliquez File > New file puis File > Save dans la nouvelle fenêtre.

• Commencez par importer la librarie Minecraft Pi, créer une connection avec le jeu et la tester en affichant un message “Bonjour monde Minecraft” à l’écran.

Si vous entrez les commandes dans la fenêtre Python, pressez Entrée (Enter) après chaque ligne. Si vous utilisez un fichier, sauvegardez le d’abord avec Ctrl + s puis exécutez le avec F5. Lorsque votre code s’exécute, vous devriez voir votre message s’afficher dans la fenêtre du jeu.

Trouvez votre position

Liste de contrôle d’activité

• Pour trouver votre position, tapez:

pos contient maintenant votre position. Accédez chacune des coordonnées avec pos.x, pos.y et pos.z.

• Alternativement, vous pouvez assigner les coordonnées à des variables indépendantes en utilisant la technique de décompression de Python:

x, y et z contiennent maintenant chacune une partie des coordonnées de votre position. x et z sont les directions horizontales (avant/arrière et gauche/droite) et y est la direction verticale (haut/bas).

Notez que la fonction getPos() retourne la position du joueur au moment où elle est appelée. Si vous changez votre position, vous devrez appeler la fonction à nouveau ou bien utiliser la position stockée dans pos ou dans x, y et z.

Téléportation

Liste de contrôle d’activité

• En plus de trouver votre position, vous pouvez spécifier une position particulière où vous téléporter.

Ceci déplacera votre joueur à une hauteur de 100 blocs dans les airs. Cela veut dire que vous vous téléporterez au milieu du ciel et retomberez là où vous étiez.

• Essayez de vous téléporter ailleurs!

Placer des blocs

Liste de contrôle d’activité

• Vous pouvez placer un bloc unique à des coordonnées spécifiques avec la fonction mc.setBlock():

Un bloc de pierre devrait apparaître à côté de là où vous vous trouvez. S’il n’est pas directement devant vous, il peut être à côté ou derrière vous. Retournez à la fenêtre Minecraft et utilisez la souris pour tourner sur place jusqu’à-ce que vous voyez un bloc gris directement devant vous.

Les arguments passés à la fonction setBlock sont x, y, z et id. (x, y, z) correspond à la position dans le monde (nous avons spécifié un bloc à côté de la position du joueur avec x + 1) et id correspond au type de bloc à placer. 1 correspond à de la pierre (“STONE”).

• Vous pouvez essayer les blocs suivants:

• Maintenant, avec le bloc en vue, essayez de le changer en d’autre chose:

Vous devriez voir le bloc de pierre gris changer devant vos yeux!

Constantes de blocs

Liste de contrôle d’activité

• Vous pouvez utiliser des constantes prédéfinies pour spécifier vos types de blocs si vous connaissez leurs noms (en Anglais). Pour ce faire, vous devrez ajouter une autre ligne import:

• Vous pouvez maintenant écrire le code suivant pour placer un bloc:

Les noms des constantes de blocs sont assez faciles à deviner si vous connaissez leur nom Anglais. Dans la majorité des cas, utilisez simplement des MAJUSCULES. Voici quelques noms particuliers que vous pouvez apprendre (essayez-les):

Des blocs comme variables

Liste de contrôle d’activité

• Si vous connaissez l’id d’un bloc, il peut être utile de le définir comme une variable. Vous pouvez utiliser le nom de constante ou bien l’id:

ou

Blocs spéciaux

Liste de contrôle d’activité

• Certains blocs ont des propriétés additionnelles, tel que la laine (“WOOL”) qui a un paramètre permettant d’en spécifier la couleur. Pour la régler, utilisez le quatrième paramètre optionel de la fonction setBlock:

Ici, le quatrième paramètre 1 règle la couleur à orange. Sans le quatrième paramètre, elle est réglée à la valeur par défaut 0 qui correspond à blanc. D’autres couleurs disponibles sont:

• Essayez d’autre numéros de couleurs et regardez la couleur du bloc changer!

D’autre blocs qui ont des propriétés additionnelles sont le bois (“WOOD”, 17): ‘oak’, ‘spruce’, ‘birch’, etc., le gazon long (“GRASS_TALL”, 31): ‘shrub’, ‘grass’, ‘fern’, etc., la torche (“TORCH”, 50): ‘pointing east, west, north, south’ et d’autres. Voir la référence d’API pour tous les détails.

Placer plusieurs blocs

Liste de contrôle d’activité

• En plus de pouvoir placer des blocs individuels avec setBlock, vous pouvez remplir un volume en une seule commande avec setBlocks:

Ceci remplira un cube de 10 x 10 x 10 blocs de pierre.

Vous pouvez remplir de plus grands volumes avec la fonction setBlocks mais il faudra plus de temps pour les générer.

Placer des blocs en marchant

Liste de contrôle d’activité

Maintenant que vous savez comment placer des blocs, utilisons votre position en mouvement pour placer des blocs lorsque vous vous déplacez.

• Le code suivant placera une fleure derrière vous partout où vous irez:

• Maintenant, marchez un certain temps puis tournez vous pour voir les fleurs que vous avez placées derrière vous.

Puisque nous avons utilisé une boucle while True, celle-ci continuera indéfiniment. Pour l’arrêter, faites Ctrl + c dans la fenêtre Python.

• Essayez de vous déplacer dans les airs et regardez les fleurs que vous laissez dans le ciel:

• Que faire si on ne voulait placer des fleurs que si le joueur est sur du gazon? Nous pouvons utiliser getBlock pour trouver de quoi est fait un bloc à une position donnée.

Ceci nous indique l’id du bloc à la position où le joueur se trouve (il s’agira de 0, c’est à dire un bloc d’air). Nous voulons connaître le type de bloc sur lequel le joueur se tient Pour ce faire, nous soustrayons 1 à la valeur y et utilisons getBlock pour déterminer le l’id du bloc sur lequel nous nous trouvons:

• Testez le un exécutant une boucle qui imprime l’id du bloc sur lequel le joueur se tient.

• Nous pouvons utiliser une condition if pour choisir si nous voulons placer une fleur ou non:

• Peut-être voudriez vous changer le bloc sur lequel le joueur se tient en gazon s’il n’en est pas déjà? :

Maintenant nous pouvons marcher et si nous marchons sur du gazon, nous y plaçons une fleur. Si le bloc n’est pas du gazon, nous le changeons en gazon. Lorsque nous nous tournons et rebroussons chemin, nous laissons maintenant une fleur derrière nous.

Jouer avec des blocs de TNT!

Liste de contrôle d’activité

• Un autre bloc intéressant est le bloc de TNT! Pour placer un bloc de TNT, utilisez:

• Toutefois, ce bloc de TNT est plutôt ennuyant. Essayez de régler data à 1:

• Maintenant, utilisez votre épée et cliquez à gauche sur le bloc de TNT: Il sera activé et explosera d’ici quelques secondes!
• Essayez maintenant de créer un énorme cube de blocs de TNT!

Vous verrez maintenant un gros cube plein de blocs de TNT. Allez activer un bloc puis courrez pour aller regarder le spectacle d’une bonne distance! Le rendu graphique sera lent étant donné que beaucoup de choses changent en même temps.

Du plaisir avec la lave en fusion!

Liste de contrôle d’activité

• Un bloc qui est très amusant à utiliser est la lave en fusion.

Trouvez le bloc que vous venez de placer et vous devriez voir de la lave en fusion couler du bloc vers le sol.

• Ce qui intéressant avec la lave c’est qu’en refroidissant elle devient de la pierre. Déplacez vous à une autre position dans le monde et essayez ceci:

Vous pouvez ajuster les paramètres de la fonction sleep pour laisser plus ou moins de lave couler.

Et ensuite?

Il y a de nombreuses autres choses que vous pouvez faire maintenant que vous savez vous déplacer dans le monde de Minecraft et utiliser l’interface de programmation Python.

Jeu en réseau

Si plusieurs personnes connectent des Raspberry Pis à un réseau local, il peuvent joindre le même monde Minecraft et jouer ensemble. Les joueurs peuvent se voir dans le monde Minecraft.

Référence d’API

Pour une documentation complète des fonction de Minecraft Pi et une liste complète des id de blocs, vous pouvez consulter la référence d’API.

Faites un jeu

Essayez un autre ressource et faites un jeu de type “Tape la marmotte”: Minecraft Whac-a-Block (ressource en Anglais).