Débuter avec Minecraft pour Raspberry Pi

Aucun matériel supplémentaire n'est nécessaire pour utiliser ce tutoriel, en dehors bien sûr de votre Raspberry Pi et de ses périphériques habituels.

Aucun logiciel supplémentaire n'est nécessaire pour utiliser ce tutoriel, en dehors de ce qui est préinstallé dans l'image Raspian actuelle. Pour garantir que votre carte SD est à jour, veuillez consulter la question relative à la mise à jour dans la FAQ Raspberry Pi.

Pour lancer Minecraft PI, ouvrez-le depuis le menu ou tapez minecraft-pi au terminal.

Dès que le jeu est chargé, cliquez sur Start Game, suivi de Create New. Vous constaterez que la fenêtre principale de l'application est légèrement décalée. Ceci signifie que pour déplacer la fenêtre, vous devez attraper la barre de titre située derrière la fenêtre Minecraft.

Vous êtes maintenant dans un jeu de Minecraft. Promenez-vous, explorez, bidouillez et construisez des choses.

Utilisez la souris pour observer les alentours et utilisez les touches suivantes du clavier :

Vous pouvez choisir un élément dans le panneau de sélection rapide avec la roue de défilement de la souris (ou en utilisant les chiffres) ou en tapant la touche E.

Vous pouvez aussi taper deux fois la barre d'espacement, en la gardant appuyée la seconde fois, pour voler en l'air. Vous arrêtez de voler quand vous relâchez la barre d'espacement, et si vous tapez à nouveau deux fois, vous retombez sur le sol.

Avec une épée dans votre main, vous pouvez cliquer sur les blocs devant vous pour les faire disparaître (ou pour creuser). Avec un bloc dans votre main, vous pouvez utiliser un clic droit pour placer le bloc devant vous, ou le clic gauche pour supprimer un bloc.

Pendant que Minecraft tourne (et une fois le monde créé), amenez le focus hors du jeu en appuyant sur la touche Tab, ce qui libérera la souris. Ouvrez Python 3 à partir du menu application et déplacez les fenêtres en sorte qu'elles soient par exemple l'une à côté de l'autre.

Vous pouvez soit taper des commandes directement dans la fenêtre Python, soit créer un fichier pour sauvegarder votre code et pouvoir le réutiliser.

Pour créer un fichier, allez à File > New Window ou File > New File de la fenêtre Python et, pour le sauvegarder, File > Save. Vous voudrez sans doute le sauvegarder dans votre répertoire personnel ou dans un nouveau répertoire projet.

Commencez par importer la bibliothèque Minecraft, établir une connexion avec le jeu et la tester en postant le message « Hello Word » à l'écran.

from mcpi.minecraft import Minecraft
mc = Minecraft.create()
mc.postToChat("Hello world")

Si vous saisissez les commandes directement dans la fenêtre Python, tapez simplement la touche Entrée après chaque ligne. Si vous utilisez un fichier, sauvegardez-le avec Ctrl + S et lancez l'exécution avec la touche F5. À l'exécution, vous devriez voir votre message s'afficher sur l'écran du jeu.

3-2-1. Trouvez votre position▲

pos = mc.player.getPos()

>>>  print(pos)
Vec3(0.5,0.0,0.5)
>>>  print(pos.x)
0.5

x, y, z = mc.player.getPos()

3-2-2. Téléportation▲

x, y, z = mc.player.getPos()
mc.player.setPos(x, y+100, z)

3-2-3. Placer un bloc▲

Vous pouvez placer un (seul) bloc à une position matérialisée par ses coordonnées avec la fonction mc.setBlock() :

 

Sélectionnez

x, y, z = mc.player.getPos()
mc.setBlock(x+1, y, z, 1)

Maintenant, un bloc de pierre doit apparaître près de là où vous vous trouvez. S'il n'est pas juste devant vous, il se trouve peut-être sur le côté ou derrière vous. Retournez dans la fenêtre Minecraft et utilisez la souris pour tourner sur vous-même jusqu'à ce que vous voyiez un bloc gris devant vous.

Les arguments passés à setBlock() sont x, y, z et id. Les arguments (x, y, z) sont les coordonnées dans le monde (nous avons spécifié une distance de 1 bloc de l'endroit où se trouve le joueur avec la valeur x+1) et id est l'identifiant du type de bloc que nous désirons placer. L'identifiant 1 correspond à un bloc de roche.

Vous pouvez essayer d'autres types de blocs :

• Air : 0 ;
• Herbe : 2 ;
• Terre : 3.

Maintenant que vous avez le bloc en vue, essayez de le changer en quelque chose d'autre :

 

Sélectionnez

mc.setBlock(x+1, y, z, 2)

Vous devriez voir le bloc de roche grise se transformer devant vos yeux.

3-2-4. Les constantes de bloc▲

from mcpi import block

mc.setBlock(x+3, y, z, block.STONE.id)

3-2-5. Des variables de blocs▲

terre = 3
mc.setBlock(x, y, z, terre)

terre = block.DIRT.id
mc.setBlock(x, y, z, terre)

3-2-6. Blocs spéciaux▲

wool = 35
mc.setBlock(x, y, z, wool, 1)

3-2-7. Blocs multiples▲

Si la fonction setBlock permet de placer ou modifier un seul bloc, la fonction setBlocks vous permet de remplir tout un espace d'un seul coup :

 

Sélectionnez

roche = 1
x, y, z = mc.player.getPos()
mc.setBlocks(x+1, y+1, z+1, x+11, y+11, z+11, roche)

Ceci créera un volume cubique 10 x 10 x 10 de roche.

Vous pouvez créer des volumes plus grands avec setBlocks, mais ça peut prendre un peu de temps à générer.

Maintenant que vous savez poser des blocs, utilisons notre position mobile pour déposer des blocs au fur et à mesure de notre déplacement.

Le code suivant va déposer une fleur derrière vous chaque fois que vous marchez :

from mcpi.minecraft import Minecraft
from time import sleep

mc = Minecraft.create()

fleur = 38

while True:
    x, y, z = mc.player.getPos()
    mc.setBlock(x, y, z, fleur)
    sleep(0.1)

Maintenant, promenez-vous pour un moment puis retournez-vous pour voir les fleurs que vous avez semées derrière vous.

Comme nous avons utilisé une boucle while True, le code continuera sans fin. Pour l'arrêter, tapez Ctrl + C dans la fenêtre Python.

Essayez aussi de voler et observez les fleurs que vous laissez dans le ciel.

Supposons que nous voulions ne semer des fleurs que quand le joueur marche dans l'herbe. Nous pouvons utiliser la fonction getBlock pour connaître le type d'un bloc :

x, y, z = mc.player.getPos()    # position du joueur : (x, y, z)
ce_bloc = mc.getBlock(x, y, z)  # Identifiant du bloc
print(ce_bloc)

Mais ceci donne la position du bloc dans lequel nous nous trouvons (cela donnera 0, car nous nous trouvons dans un bloc d'air). Nous voulons trouver le type de bloc sur lequel nous marchons. Pour cela, nous retranchons 1 à la valeur y (l'altitude) et utilisons getBlock() pour déterminer le bloc sur lequel nous nous trouvons :

x, y, z = mc.player.getpos()  # position du joueur : (x, y, z)
bloc_en_dessous = mc.getBlock(x, y-1, z)  # Identifiant du bloc
print(bloc_en_dessous)

Ceci donne l'identifiant du bloc sur lequel se trouve le joueur.

Testez cette boucle qui imprime l'identifiant du bloc sur lequel nous nous trouvons actuellement :

while True:
    x, y, z = mc.player.getPos()
    bloc_en_dessous = mc.getBlock(x, y-1, z)
    print(bloc_en_dessous)

Nous pouvons utiliser une instruction conditionnelle if pour décider si nous semons ou non des fleurs :

herbe = 2
fleur = 38

while True:
    x, y, z = mc.player.getPos()  # position du joueur :  (x, y, z)
    bloc_en_dessous = mc.getBlock(x, y-1, z)  # Identifiant du bloc

    if bloc_en_dessous == herbe:
        mc.setBlock(x, y, z, fleur)
    sleep(0.1)

Nous pourrions aussi décider de transformer le sol sur lequel nous marchons en herbe si ça n'en est pas déjà :

if block_beneath == herbe:
    mc.setBlock(x, y, z, fleur)
else:
    mc.setBlock(x, y-1, z, herbe)

Maintenant, quand nous avançons, nous semons des fleurs derrière nous si nous marchons sur de l'herbe. Si le bloc n'est pas de l'herbe, il se transforme en herbe. Et quand nous rebroussons chemin et repassons au même endroit, nous plantons maintenant des fleurs, puisque le bloc où nous marchons a été changé en herbe.

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

tnt = 46
mc.setBlock(x, y, z, tnt)

Ce bloc de TNT n'est cependant pas très intéressant. Ajoutez un paramètre additionnel 1 :

tnt = 46
mc.setBlock(x, y, z, tnt, 1)

Maintenant, utilisez l'épée et faites un clic gauche sur le bloc de TNT. Celui-ci sera armé et explosera environ une seconde plus tard !

Essayez maintenant de construire un gros cube de blocs de TNT :

tnt = 46
mc.setBlocks(x+1, y+1, z+1, x+11, y+11, z+11, tnt, 1)

Vous devriez maintenant voir ce gros cube de TNT. Approchez-vous et activez l'un des blocs, puis enfuyez-vous au plus vite et observez la scène. Il se peut que le rendu graphique soit un peu lent, car il y a vraiment beaucoup de choses à changer en même temps.

Un type de bloc très amusant à utiliser est la lave en fusion.

from mcpi.minecraft import Minecraft
mc = Minecraft.create()

x, y, z = mc.player.getPos()
lave = 10
mc.setBlock(x+3, y+3, z, lave)

Trouvez le bloc que vous venez de placer et vous devriez voir de la lave s'écouler du bloc vers le sol.

Ce qui est amusant avec la lave, c'est qu'elle se solidifie et se transforme en roche quand elle refroidit. Déplacez-vous ailleurs dans votre monde et essayez ceci :

from mcpi.minecraft import Minecraft
from time import sleep

mc = Minecraft.create()

x, y, z = mc.player.getPos()

lave = 10
eau = 8
air = 0

mc.setBlock(x+3, y+3, z, lave)
sleep(20)
mc.setBlock(x+3,y+5, z, eau)
sleep(4)
mc.setBlock(x+3, y+5, z, air)

Vous pouvez ajuster le paramètre de la fonction sleep pour moduler la quantité de lave qui s'écoule.

Si plusieurs joueurs connectent leur Raspberry Pi à un réseau local, ils peuvent se connecter au même monde Minecraft et jouer ensemble. Les joueurs se verront les uns les autres dans le jeu.

Vous trouverez une documentation plus approfondie sur les fonctionnalités disponibles et une liste des identifiants de blocs dans le guide de l'API Python.