Comment configurer l’API Python de Minecraft sur un Raspberry Pi

Comment configurer l'API Python de Minecraft sur un Raspberry Pi

L’avantage de l’édition Raspberry Pi de Minecraft est que vous pouvez manipuler le monde du jeu à l’aide de scripts Python. Vous pouvez déplacer le joueur ainsi que créer et détruire des blocs. Cela vous permet de créer des structures en quelques secondes qui prendraient des heures à créer à la main.

En répétant un script, vous pouvez rapidement créer des structures que vous avez conçues. Par exemple, vous pouvez écrire un script pour créer une tour et une section de mur et l’utiliser pour créer rapidement un château massif.

Pour configurer votre Pi pour permettre cela, vous devez suivre quelques étapes initiales. Ils sont assez simples et ne prennent que cinq minutes.

Mise à jour 2015 :

La dernière version de Raspbian inclut l’installation de Minecraft et de l’API Minecraft. Cela signifie que vous pouvez sauter les étapes 1 à 3. Vos scripts Python peuvent être exécutés à partir de n’importe quel répertoire. Je vous suggère fortement de mettre à jour votre carte SD avec la dernière image Raspbian si vous n’avez pas déjà installé Minecraft ou l’API.

Étape 1 – Installez Minecraft

Veuillez suivre mon tutoriel Installer Minecraft sur Raspberry Pi et vérifier que le jeu fonctionne comme prévu.

Étape 2 – Configurer l’API

Les fichiers requis sont maintenant déjà installés mais pour les rendre un peu plus faciles d’accès, nous allons les copier dans un nouveau dossier. Créons-le donc dans le répertoire personnel par défaut :

mkdir ~/mcpi-api

puis copiez les fichiers de l’installation de Minecraft :

cp -r ~/mcpi/api/python/mcpi ~/mcpi-api/

Étape 3 – Accédez au dossier

Avant de plonger dans vos propres scripts, il est préférable de tester que tout fonctionne correctement. Accédez au répertoire API créé précédemment :

cd ~/mcpi-api

Étape 4 – Test API

Pour tester votre configuration, vous pouvez utiliser le script simple suivant. Il crée un cube en pierre et vous place dessus.

#!/usr/bin/python
# Import Minecraft libraries
import mcpi.minecraft as minecraft
import mcpi.block as block

mc = minecraft.Minecraft.create()

# Get player position
pPos = mc.player.getTilePos()

mc.postToChat("API Test!")

# Change block
print "Create stone 3x3 cube"
mc.setBlocks(pPos.x-1,pPos.y,pPos.z-1,pPos.x+1,pPos.y+2,pPos.z+1,block.STONE)

print "Position player on top"
mc.player.setPos(pPos.x,pPos.y+3,pPos.z)

mc.postToChat("Move and have another go.")

Vous pouvez télécharger ce script directement sur votre Pi en utilisant :

wget https://bitbucket.org/MattHawkinsUK/rpispy-misc/raw/master/minecraft/api_test.py

Il peut être exécuté en utilisant :

python api_test.py

Assurez-vous que Minecraft est en cours d’exécution avant d’essayer le script de test ou rien ne se passera ! Appuyez sur TAB pour libérer la souris de la fenêtre de jeu et vous permettre d’utiliser le LXTerminal.

Une fois le script exécuté, vous devriez voir un cube de pierre sous vos pieds :

Test de l'API Minecraft

Référence des noms de blocs d’API Minecraft Python

Pour référence, les noms de blocs suivants sont disponibles si vous souhaitez modifier le script ci-dessus pour créer un cube composé d’un matériau différent :

AIR                 
STONE               
GRASS               
DIRT                
COBBLESTONE         
WOOD_PLANKS         
SAPLING             
BEDROCK             
WATER_FLOWING       
WATER               
WATER_STATIONARY    
LAVA_FLOWING        
LAVA                
LAVA_STATIONARY     
SAND                
GRAVEL              
GOLD_ORE            
IRON_ORE            
COAL_ORE            
WOOD                
LEAVES              
GLASS               
LAPIS_LAZULI_ORE    
LAPIS_LAZULI_BLOCK  
SANDSTONE           
BED                 
COBWEB              
GRASS_TALL          
WOOL                
FLOWER_YELLOW       
FLOWER_CYAN         
MUSHROOM_BROWN      
MUSHROOM_RED        
GOLD_BLOCK          
IRON_BLOCK          
STONE_SLAB_DOUBLE   
STONE_SLAB          
BRICK_BLOCK         
TNT                 
BOOKSHELF           
MOSS_STONE          
OBSIDIAN            
TORCH               
FIRE                
STAIRS_WOOD         
CHEST               
DIAMOND_ORE         
DIAMOND_BLOCK       
CRAFTING_TABLE      
FARMLAND            
FURNACE_INACTIVE    
FURNACE_ACTIVE      
DOOR_WOOD           
LADDER              
STAIRS_COBBLESTONE  
DOOR_IRON           
REDSTONE_ORE        
SNOW                
ICE                 
SNOW_BLOCK          
CACTUS              
CLAY                
SUGAR_CANE          
FENCE               
GLOWSTONE_BLOCK     
BEDROCK_INVISIBLE   
STONE_BRICK         
GLASS_PANE          
MELON               
FENCE_GATE          
GLOWING_OBSIDIAN    
NETHER_REACTOR_CORE 

Prochaines étapes

Vous êtes maintenant prêt à créer vos propres scripts ! C’est à vous de décider à quel point vous les compliquez.