New Crowdin translations

af-ZA/meta.yml

@@ -0,0 +1,37 @@
+---
+title: Getting Started with Minecraft Pi
+hero_image: images/banner.png
+description: Get your first taste of programming the world of Minecraft
+original_url: https://raspberrypi.org/learning/getting-started-with-minecraft-pi
+theme: yellow
+duration: 2
+listed: true
+ingredient: false
+copyedit: true
+curriculum: 2, design-0, programming-2, phys-comp-0, manufacture-0, community-0
+interests: games
+technologies: python
+site_areas: projects
+hardware: ''
+software: python
+version: 3
+last_tested: 2017-01-01
+steps:
+  - 
+    title: Introduction
+  - 
+    title: What you will need
+  - 
+    title: Getting Started with Minecraft Pi
+  - 
+    title: Run Minecraft
+  - 
+    title: Use the Python programming interface
+  - 
+    title: Dropping blocks as you walk
+  - 
+    title: Playing with TNT blocks
+  - 
+    title: Fun with flowing lava.
+  - 
+    title: What next?

af-ZA/step_1.md

@@ -0,0 +1,19 @@
+## What you will make
+
+In this resource you will explore the virtual world of Minecraft Pi, the special edition of Minecraft made for Raspberry Pi.
+
+You will learn how to control the player, manually build with blocks and use the Python interface to manipulate the world around you.
+
+## What you will learn
+
+By following this resource with your Raspberry Pi you will learn:
+
+- How to access Minecraft Pi and create a new world
+- How to use the Python programming environment IDLE to connect to Minecraft Pi
+- How to use the Minecraft Python API to post text to the chat window, find the player's coordinates, teleport and build structures
+- How to use variables to store IDs for different types of blocks
+- Experimenting with placing different types of blocks with special attributes
+
+This resource covers elements from the following strands of the [Raspberry Pi Digital Making Curriculum](https://www.raspberrypi.org/curriculum/):
+
+- [Use basic programming constructs to create simple programs](https://www.raspberrypi.org/curriculum/programming/creator)

af-ZA/step_2.md

@@ -0,0 +1,54 @@
+## What you will need
+
+### Software
+
+#### Software installation
+
+Minecraft has been installed by default in Raspbian since September 2014.
+
+![Minecraft Pi desktop icon](images/minecraft-pi-shortcut.png)
+
+If you're using an older version of Raspbian, open a terminal window and type the following commands (you must be online):
+
+```bash
+sudo apt-get update
+sudo apt-get install minecraft-pi
+```
+
+Once that finishes, Minecraft Pi and the Python library should be installed.
+
+#### Test Minecraft
+
+To run Minecraft double click the desktop icon or enter `minecraft-pi` in the terminal.
+
+![](images/mcpi-start.png)
+
+When Minecraft Pi has loaded, click on **Start Game**, followed by **Create new**. You'll notice that the containing window is offset slightly. This means to drag the window around you have to grab the title bar behind the Minecraft window.
+
+![](images/mcpi-game.png)
+
+You are now in a game of Minecraft!
+
+#### Test Python
+
+With Minecraft running, and the world created, bring your focus away from the game by pressing the `Tab` key, which will free your mouse. Open Python 3 (IDLE) on the Desktop and move the windows so they're side-by-side.
+
+You can either type commands directly in to the Python window or create a file so you can save your code and run it again another time.
+
+If you want create a file go to `File > New window` and `File > Save`. You'll probably want to save this in your home folder or a new project folder.
+
+Start by importing the Minecraft library, creating a connection to the game and testing it by posting the message "Hello world" to the screen:
+
+```python
+from mcpi import minecraft
+
+mc = minecraft.Minecraft.create()
+
+mc.postToChat("Hello world")
+```
+
+If you're entering commands directly in to the Python window, just hit `Enter` after each line. If it's a file, save with `Ctrl + S` and run with `F5`. When your code runs, you should see your message on screen in the game.
+
+![](images/mcpi-idle.png)
+
+If you see "Hello world" in the Minecraft window, you're good to proceed to the next step.

af-ZA/step_3.md

@@ -0,0 +1,5 @@
+## Getting Started with Minecraft Pi
+
+Minecraft is a popular sandbox open-world building game. A free version of Minecraft is available for the Raspberry Pi; it also comes with a programming interface. This means you can write commands and scripts in Python code to build things in the game automatically. It's a great way to learn Python!
+
+![Minecraft Pi banner](images/minecraft-pi-banner.png)

af-ZA/step_4.md

@@ -0,0 +1,35 @@
+## Run Minecraft
+
+To run Minecraft Pi, open it from the desktop menu or type `minecraft-pi` in the terminal.
+
+![](images/menu.png)
+
+When Minecraft Pi has loaded, click on **Start Game**, followed by **Create new**. You'll notice that the containing window is offset slightly. This means to drag the window around you have to grab the title bar behind the Minecraft window.
+
+![](images/mcpi-game.png)
+
+You are now in a game of Minecraft! Go walk around, hack things, and build things!
+
+Use the mouse to look around and use the following keys on the keyboard:
+
+|     Key      |        Action        |
+|:------------:|:--------------------:|
+|      W       |       Forward        |
+|      A       |         Left         |
+|      S       |       Backward       |
+|      D       |        Right         |
+|      E       |      Inventory       |
+|    Space     |         Jump         |
+| Double Space |      Fly / Fall      |
+|     Esc      |  Pause / Game menu   |
+|     Tab      | Release mouse cursor |
+
+You can select an item from the quick draw panel with the mouse's scroll wheel (or use the numbers on your keyboard), or press `E` and select something from the inventory.
+
+![](images/mcpi-inventory.png)
+
+You can also double tap the space bar to fly into the air. You'll stop flying when you release the space bar, and if you double tap it again you'll fall back to the ground.
+
+![](images/mcpi-flying.png)
+
+With the sword in your hand, you can click on blocks in front of you to remove them (or to dig). With a block in your hand, you can use right click to place that block in front of you, or left click to remove a block.

af-ZA/step_5.md

@@ -0,0 +1,162 @@
+## Use the Python programming interface
+
+With Minecraft running, and the world created, bring your focus away from the game by pressing the `Tab` key, which will free your mouse. Open Python 3 from the application menu and move the windows so they're side-by-side.
+
+You can either type commands directly into the Python window or create a file so you can save your code and run it again another time.
+
+If you want create a file, go to `File > New window` and `File > Save`. You'll probably want to save this in your home folder or a new project folder.
+
+Start by importing the Minecraft library, creating a connection to the game and testing it by posting the message "Hello world" to the screen:
+
+```python
+from mcpi.minecraft import Minecraft
+
+mc = Minecraft.create()
+
+mc.postToChat("Hello world")
+```
+
+If you're entering commands directly into the Python window, just hit `Enter` after each line. If it's a file, save with `Ctrl + S` and run with `F5`. When your code runs, you should see your message on screen in the game.
+
+![](images/helloworld.gif)
+
+### Find your location
+
+To find your location, type:
+
+```python
+pos = mc.player.getPos()
+```
+
+`pos` now contains your location; access each part of the set of coordinates with `pos.x`, `pos.y` and `pos.z`.
+
+Alternatively, a nice way to get the coordinates into separate variables is to use Python's unpacking technique:
+
+```python
+x, y, z = mc.player.getPos()
+```
+
+Now `x`, `y`, and `z` contain each part of your position coordinates. `x` and `z` are the walking directions (forward/back and left/right) and `y` is up/down.
+
+Note that `getPos()` returns the location of the player at the time, and if you move position you have to call the function again or use the stored location.
+
+### Teleport
+
+As well as finding out your current location you can specify a particular location to teleport to.
+
+```python
+x, y, z = mc.player.getPos()
+mc.player.setPos(x, y+100, z)
+```
+
+This will transport your player to 100 spaces in the air. This will mean you'll teleport to the middle of the sky and fall straight back down to where you started.
+
+Try teleporting to somewhere else!
+
+### Set block
+
+You can place a single block at a given set of coordinates with `mc.setBlock()`:
+
+```python
+x, y, z = mc.player.getPos()
+mc.setBlock(x+1, y, z, 1)
+```
+
+Now a stone block should appear beside where you're standing. If it's not immediately in front of you it may be beside or behind you. Return to the Minecraft window and use the mouse to spin around on the spot until you see a grey block directly in front of you.
+
+![](images/mcpi-setblock.png)
+
+The arguments passed to `set block` are `x`, `y`, `z` and `id`. The `(x, y, z)` refers to the position in the world (we specified one block away from where the player is standing with `x + 1`) and the `id` refers to the type of block we'd like to place. `1` is stone.
+
+Other blocks you can try:
+
+    Air:   0
+    Grass: 2
+    Dirt:  3
+
+
+Now with the block in sight, try changing it to something else:
+
+```python
+mc.setBlock(x+1, y, z, 2)
+```
+
+You should see the grey stone block change in front of your eyes!
+
+![](images/mcpi-setblock2.png)
+
+#### Block constants
+
+You can use a inbuilt block constants to set your blocks, if you know their names. You'll need another `import` line first though.
+
+```python
+from mcpi import block
+```
+
+Now you can write the following to place a block:
+
+```python
+mc.setBlock(x+3, y, z, block.STONE.id)
+```
+
+Block ids are pretty easy to guess, just use ALL CAPS, but here are a few examples to get you used to the way they are named.
+
+    WOOD_PLANKS
+    WATER_STATIONARY
+    GOLD_ORE
+    GOLD_BLOCK
+    DIAMOND_BLOCK
+    NETHER_REACTOR_CORE
+
+
+### Block as variable
+
+If you know the id of a block it can be useful to set it as a variable. You can use the name or the integer id.
+
+```python
+dirt = 3
+mc.setBlock(x, y, z, dirt)
+```
+
+or
+
+```python
+dirt = block.DIRT.id
+mc.setBlock(x, y, z, dirt)
+```
+
+### Special blocks
+
+There are some blocks which have extra properties, such as Wool which has an extra setting you can specify the colour. To set this use the optional fourth parameter in `setBlock`:
+
+```python
+wool = 35
+mc.setBlock(x, y, z, wool, 1)
+```
+
+Here the fourth parameter `1` sets the wool colour to orange. Without the fourth parameter it is set to the default (`0`) which is white. Some more colours are:
+
+    2: Magenta
+    3: Light Blue
+    4: Yellow
+
+
+Try some more numbers and watch the block change!
+
+Other blocks which have extra properties are wood (`17`): oak, spruce, birch, etc; tall grass (`31`): shrub, grass, fern; torch (`50`): pointing east, west, north, south; and more. See the [API reference](http://www.stuffaboutcode.com/p/minecraft-api-reference.html) for full details.
+
+### Set multiple blocks
+
+As well as setting a single block with `setBlock` you can fill in a volume of space in one go with `setBlocks`:
+
+```python
+stone = 1
+x, y, z = mc.player.getPos()
+mc.setBlocks(x+1, y+1, z+1, x+11, y+11, z+11, stone)
+```
+
+This will fill in a 10 x 10 x 10 cube of solid stone.
+
+![](images/mcpi-setblocks.png)
+
+You can create bigger volumes with the `setBlocks` function but it may take longer to generate!