L'API Minecraft pour Raspberry Pi

.create(address = "localhost", port = 4711)

Crée une connexion à Minecraft (adresse, port) => un objet Minecraft

# utilise les adresse et port par défaut
mc = minecraft.Minecraft.create()

# spécifie une adresse IP et un port
mc = minecraft.Minecraft.create("192.168.1.1", 4711)

# l'objet mc créé sera utilisé dans les exemples de code ci-dessous

.getBlock(x,y,z)

Récupère l'identifiant d'un bloc (coordonnées x, y et z) => id:int

# récupère le type de bloc en position 0,0,0
blockType = mc.getBlock(0,0,0)

.getBlocks(x0,y0,z0,x1,y1,z1)

Récupère un « cuboïde » (parallélépipède rectangle) de blocs (x0,y0,z0,x1,y1,z1) => [id:int]

# récupère les identifiants des blocs d'un cuboïde
blocks = mc.getBlocks(-1,-1,-1,1,1,1)
for block in blocks:
    print block

.getBlockWithData(x,y,z)

Récupère un objet et ses données (x,y,z) => Block

# récupère l'objet block du bloc se trouvant aux coordonnées 0,0,0
blockObj = mc.getBlockWithData(0,0,0)

.setBlock(x,y,z)

Place un bloc de type id aux coordonnées x, y, z : (x,y,z,id,[data])

# place un bloc d'un type particulier aux coordonnées x, y et z
mc.setBlock(0,0,0,block.DIRT.id)

# place un bloc d'un type et d'un "sous-type" particuliers
mc.setblock(0,0,0,block.WOOD.id, 1)

.setBlocks(x0,y0,z0,x1,y1,z1,blockType, blockData)

Remplit un « cuboïde » (parallélépipède) de blocs

# place plusieurs blocs d'un seul coup et remplit tout l'espace 
# entre deux ensembles de coordonnées x, y et z
mc.setBlocks(-1, -1, -1, 1, 1, 1, block.STONE.id)

.getHeight(x,z)

Récupère l'altitude de coordonnées horizontales (x,z) => int

# détermine la coordonnée verticale y du point de coordonnées
# horizontales x, z représentant le bloc (autre que de l'air) 
# le plus élevé
y = mc.getHeight(0,0)

.getPlayerEntityIds()

Récupère l'identifiant d'entité des joueurs connectés au jeu => [id:int]

# Récupère l'identifiant des joueurs connectés au jeu
entityIds = mc.getPlayerEntityIds()
for entityId in entityIds:
    print entityId

.getPlayerEntityId(playerName)

Récupère l'identifiant d'entité d'un joueur nommé => [id:int]

# Récupère l'identifiant d'entité du joueur appelé 'martinohanlon'
entityId = mc.getPlayerEntityId("martinohanlon")
print entityId

.saveCheckpoint()

Sauvegarde un point de contrôle qui peut être utilisé pour restaurer un état du jeu

mc.saveCheckpoint()

.restoreCheckpoint()

Restaure l'état du jeu au moment de la sauvegarde d'un point de contrôle

mc.restoreCheckpoint()

.postToChat(message)

Poste un message dans la fenêtre de message du jeu

# Écrit 'Hello Minecraft World' dans la fenêtre de message
mc.postToChat("Hello Minecraft World")

.setting(setting, status)

Configure un monde (setting, status). Clefs : world_immutable, nametags_visible

# passe le réglage world_immutable (monde non modifiable) à Vrai
mc.setting("world_immutable", True)

# passe le réglage nametags_visible (étiquettes de noms visibles) à Faux
mc.setting("nametags_visible", False)

.getPos()

Récupère la position du joueur dans le monde sous la forme d'un Vec3 de nombres en virgule flottante (nombres décimaux). Si le joueur est au milieu d'un bloc, renvoie la coordonnée x.5.

# Récupère la position du joueur sous la forme de nombres en virgule flottante
playerPos = mc.player.getPos()

.setPos(x,y,z)

Déplace un joueur à la position désignée par les coordonnées passées en paramètres ([x,y,z])

# Place le joueur à la position désignée (nombres en virgule flottante)
mc.player.setPos(0.0,0.0,0.0)

.getTilePos()

Récupère la position de la « tuile » sur laquelle se trouve le joueur

# Récupère la position de la tuile où se trouve le joueur
playerTile = mc.player.getTilePos()

.setTilePos(x,y,z)

Déplace le joueur à la position dans le monde de la tuile en passant des coordonnées ([x,y,z])

# Fixe la position de la tuile sur laquelle se trouve le joueur
mc.player.setTilePos(0,0,0)

.setting(setting, status)

Configure un joueur (setting, status). Clefs : autojump

# Passe le réglage autojump à Vrai
mc.player.setting("autojump", True)

.getRotation()

Récupère l'angle de rotation dans le plan horizontal (0 à 360°) du joueur => [angle:float]

# Récupère l'angle de rotation du joueur (azimutal)
angle = mc.player.getRotation()
print angle

.getPitch()

Récupère l'angle dans le plan vertical (-90 à 90°) du joueur => [pitch:float]

# Récupère l'angle vertical (inclinaison ou angle de cabrage)
pitch = mc.player.getPitch()
print pitch

.getDirection()

Récupère le vecteur unitaire des x, y, z de la direction (cap) du joueur => [Vec3]

# récupère la direction du joueur
direction = mc.player.getDirection()
print direction

.getPos(entityId)

Récupère la position d'une entité dans le monde, sous la forme d'un Vec3 de nombres en virgule flottante (nombres décimaux). Si une entité est au milieu d'un bloc, renvoie une valeur du type x.5.

# Récupère la position d'une entité (nombres en virgule flottante)
entityPos = mc.entity.getPos(entityId)

.setPos(entityId,x,y,z)

Déplace une entité à une position dans le monde, en passant les coordonnées de cette position

# place les joueurs aux positions désignées par les coordonnées 
# (nombres en virgule flottante)
mc.player.setPos(entityId,0.0,0.0,0.0)

.getTilePos(entityId)

Récupère la position de la « tuile » sur laquelle se trouve l'entité

# récupère la position de la tuile où se trouve l'entité
entityTile = mc.entity.getTilePos(entityId)

.setTilePos(entityId, x,y,z)

Déplace l'entité à une position de tuile dans le monde en passant des coordonnées ([x,y,z])

# fixe la position de la tuile sur laquelle se trouve l'entité
mc.player.setTilePos(entityId,0,0,0)

.getRotation(entityId)

Récupère l'angle de rotation dans le plan horizontal (0 à 360°) de l'entité => [angle:float]

# récupère l'angle de rotation de l'entité
angle = mc.entity.getRotation(entityId)
print angle

.getPitch(entityId)

Récupère l'angle dans le plan vertical (-90 à 90°) d'une entité => [pitch:float]

# Récupère l'angle vertical (angle de cabrage) de l'entité
pitch = mc.entity.getPitch(entityId)
print pitch

.getDirection(entityId)

Récupère le vecteur unitaire des x, y, z de la direction (cap) du joueur => [Vec3]

# récupère la direction d'une entité
direction = mc.entity.getDirection(entityId)
print direction

.setNormal(entityId)

Configure la caméra en mode Minecraft normal (vision du joueur) ([entityId])

# Configure la caméra en mode normal pour un joueur
mc.camera.setNormal(entityId)

.setFixed()

Configure la caméra en mode vue fixe

# Configure la caméra en mode vue fixe 
mc.camera.setFixed()

.setFollow(entityId)

Configure la caméra en mode suivi d'une entité ([entityId])

# configure la caméra pour suivre un joueur spécifique
mc.camera.setFollow(entityId)

.setPos(x,y,z)

Configure la position de l'entité caméra (x,y,z)

# place la caméra à une position spécifique de coordonnées x, y, z
mc.camera.setPos(0,0,0)

.pollBlockHits()

Frappes de blocs (déclenchées uniquement par l'épée) => [BlockEvent]

# récupère les frappes de bloc qui ont eu lieu depuis la dernière
# fois que la fonction a été exécutée
blockEvents = mc.events.pollBlockHits()
for blockEvent in blockEvents:
    print blockEvent

.clearAll()

Efface tous les événements anciens

# efface les événements anciens
mc.events.clearAll()

.id

L'identifiant (id) du type d'un bloc.

.data

Les données (sous-types ou propriétés supplémentaires) de certains types de blocs.

VIII-B-1. Couleurs des blocs de type WOOL (laine)▲

VIII-B-2. Essences de bois des blocs de type WOOD▲

VIII-B-3. WOOD_PLANKS (Planches), non disponibles sur le Pi▲

VIII-B-4. SAPLING (pousses d'arbres)▲

VIII-B-5. GRASS_TALL (herbes hautes)▲

VIII-B-6. TORCH (torche)▲

VIII-B-7. STONE_BRICK (pierres taillées)▲

VIII-B-8. STONE_SLAB / STONE_SLAB_DOUBLE (dalles, doubles dalles)▲

VIII-B-9. SNOW_BLOCK (bloc de neige)▲

VIII-B-10. TNT▲

VIII-B-11. LEAVES (feuillage)▲

VIII-B-12. SANDSTONE (grès)▲

VIII-B-13. STAIRS_[COBBLESTONE, WOOD] (matériaux d'escalier)▲

VIII-B-14. LADDERS, CHESTS, FURNACES, FENCE_GATE (échelles, coffres, fourneaux, portillon)▲

VIII-B-15. [WATER, LAVA]_STATIONARY (eau ou lave stationnaire)▲

VIII-B-16. NETHER_REACTOR_CORE (cœur du réacteur du Nether)▲

.type

Type d'événement de bloc. Il n'y a qu'un seul type d'événement défini pour l'instant : BlockEvent.HIT

blockEventType = blockEvent.type

IX-A-1. Types d'événements ▲

.pos

La position du bloc où l'événement a eu lieu, c'est-à-dire le bloc qui a été frappé. .pos renvoie un objet Vec3 de coordonnées x, y et z.

blockEventPos = BlockEvent.pos

.face

La face du bloc où l'événement a eu lieu.

blockEventFace = BlockEvent.face

.entityId

Identifiant d'entité du joueur à l'origine de l'événement de bloc, autrement dit le joueur qui a frappé le bloc.

blockEventPlayer - BlockEvent.entityId

.x

Position selon l'axe des x

xPos = position.x

.y

Position selon l'axe des y

yPos = position.y

.z

Position selon l'axe des z

zPos = position.y