开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

TeachPythonWithMinecraft

Teaching Python programming and concepts using the Python Minecraft API for the Raspberry Pi version of Minecraft.

Background

This is the repo for the Florin High School (Sacramento, CA) Python workshop at KPMG. In this workshop, you'll learn Python programming and programming concepts by writing methods to control in-game Minecraft activites, and then you will connect those actions to a Flask-based website to act as a controller. We distributed Rapsberry Pi to the students for them to take with them after the workshop. If you don't have a rapsberry pi, you can emulate one on any Mac, Windows or Linux computer by following the instructions in this link.

You'll learn:

• Basic version control with Github
• Python Virtual Environments
• Dependency Management
• Variables
• If Statements
• Loops
• Functions
• Backend Web Development concepts

All this culminating in a Flask-based Web controller for Minecraft Pi!

How to use this repo

1. Login to github with your account

2. Click the "Star" button in the upper right hand corner.

3. Click the "Fork" button

4. Wait while Github copies the repo to your account

5. Click the "Clone/Download" button and download the repo as a zip file to your machine

6. Unzip the repo. Open a command prompt and CD to the location you extracted the repo to.

7. Type virtualenv venv and hit enter.

8. Wait while the virtual environment is activated. Then, type source venv/bin/activate and hit enter.

9. You should see (venv) on the left side of your command prompt. Type pip3 install -r requirements.txt and hit enter

10. You are ready to start learning Python with Minecraft! Bonus: You finished your first lesson on version control, virtual environments, and dependency management! Good Job!

11. Follow the lessons in the Lessons Folder.

Useful Information

Create a script

Once the Pi has loaded and you are at the desktop screen, click on Menu then Programming and choose Python IDE3

Click file and select click script. To save, go to file then click save as.

We need to add an import for our script that will allow us to control Minecraft, type this code into the first line of your script

from mcpi.minecraft import Minecraft 

mc = Minecraft.create()

This import will need to be entered for every script you create

You can move to a new line in a script by pressing enter

A script can be run by pressing f5 or going to the run option on the top menu bar

Load Minecraft

Go to menu, go to games and click Minecraft. Bring this window alongside your Python script window so it is easier to use. You can move between the game and scripts by pressing the tab button.

In Minecraft click 'Create new world'. When this loads it will look something like the image below. Everyone’s will look different when it first loads.

Moving around the game

To move around the game, you can use the arrow keys and use the space button to jump.

Hints

Look out for Pete the pig. For some questions he'll give hints on how to do them.

What if something goes wrong ?

If you get an error saying 'Syntax error' double check you have typed everything correctly and try running your script again.

Targeted Curriculum

Key Stage 2

• Design, write and debug programs that accomplish specific goals, including controlling or simulating physical systems; solve problems by decomposing them into smaller parts.

• Use sequence, selection, and repetition in programs; work with variables and various forms of input and output.

Key Stage 3

• Use 2 or more programming languages, at least one of which is textual, to solve a variety of computational problems; make appropriate use of data structures, design and develop modular programs that use procedures or functions.

Useful Block ID's

Block	ID	Picture	Block	ID	Picture
Air	0		Wood Planks	5
Stone	1		Bedrock	7
Grass	2		Sand	12
Dirt	3		Gravel	13
Cobblestone	4		Glass	20
Leaves	18		Lava	11
Water	9

Credits

• Github user jeremycook94 for creating most of the lesson plans.
• EV Computing for the readme image.
• The Raspberry Pi Foundation for their work on Rapsberry Pi, and the Raspbian image that contains the Python and Minecraft distributions used in this workshop.
• KPMG cowowrkers Matt Kwong, Andrew Suarez-Lopez, and Frank Wright