Code Connection for Minecraft
User Guide
Introduction
Thank you for installing Minecraft: Education Edition (M:EE) and Code Connection for Minecraft. We have
created this document to help guide you through your experience as well as answer any frequently asked
questions you might have.
Code Connection for Minecraft is an application that connects Minecraft: Education Edition to a third-party
coding experience. In-game, the Agent character acts as a sidekick for each player and carries out these
commands. For the purposes of this guide, we will be referencing the Scratch programming language and
the ScratchX website where players will build their code.
Installation
Code Connection for Minecraft can be installed on Windows 10 or MacOS devices. Below are the
installation instructions for each platform.
To install Code Connection for Minecraft on Windows 10:
1. Download the latest version of the application here: https://education.minecraft.net/companionapp-download/
2. Run CodeConnection_Setup.msi
3. If prompted, select “More Info” and “Run Anyway”
4. Install with default settings
Code Connection for Minecraft should place a Code Connection icon on your desktop. It will also appear in
your Start Menu as “Code Connection” under a folder titled “Minecraft Education Edition”.
To install Code Connection for Minecraft on MacOS:
1. Download the latest version of the application here: https://education.minecraft.net/companionapp-download/
2. Open CodeConnection_Setup.pkg
3. Select “Continue” and “Install” as you progress through the menus
When installation is complete, the application appears as “Code Connection” in your Applications folder.
Code Connection for Minecraft | User Guide
Getting Started
Now that you have installed Code Connection We need to connect the Minecraft: Education Edition client
to the ScratchX coding application. Code Connection acts as the bridge between these two applications.
Use the instructions below to connect the two pieces of software and place an Agent in the world.
1. Launch a browser window and enter the following URL: http://bit.ly/MEEScratch
2. When ScratchX launches you will likely get a warning shown below, select “I understand, continue”.
3. Launch Minecraft: Education Edition and start a world.
4. Launch Code Connection for Minecraft.
5. When you launch Code Connection, you will get a screen that asks you to copy a command into
Minecraft: Education Edition.
6. If the connection is successful, you will see Code Connection change to a message showing “You are
connected to (IP Address)” that shows ScratchX and Minecraft: Education Edition are now connected
to each other.
7. #6 will only be necessary the first time you launch Code Connection! For subsequent launching of
Code Connection, you can accomplish this by simply typing “/code” to launch via a slash command.
Code Connection for Minecraft | User Guide
8. Your Agent will also appear in your world with the username “(Username).Agent” as shown in the
image below.
Features
Okay, so you have Minecraft: Education Edition running a world of your choosing, you have Code
Connection for Minecraft working, and ScratchX is open and available. So now what do you do? There is a
ton of support for Scratch available through their website at https://scratch.mit.edu/help/. Here are some
basics that can get you started.
To execute single commands, you can click on the command of your choice. For example, to have your
Agent walk forward, simply click the top code block in the image below.
If you want to string commands together, place them in the Scratch window and lock them together. For
example, to have the Agent move forward three spaces and till soil for farming, you would execute the
following code.
Code Connection for Minecraft | User Guide
The Agent has one characteristic that is important to point out. The Agent carries its own inventory that can
be collected and used. To transfer items between a player’s inventory and the Agent’s inventory, right click
on the agent (similar to how you would operate a chest). For example, in this image we are giving the
Agent inventory to execute a series of commands for farming.
Once the Agent has the inventory you want, you can execute your code. Here is the Agent using the seeds
and water bucket in its inventory to execute a farming program.
Code Connection for Minecraft | User Guide