It's Sean!

UK freelance journalist, author
and writer Sean McManus

Printed from © Sean McManus.
You are here: Home > Blog Home > Sean McManus's Writing blog

Sean's Tech and Writing Blog

Does the Mission Python game work on a Mac? (and other compatibility questions)

07 November 2018

The game featured in my latest book, Mission Python, is called Escape and sees you solving puzzles to escape a space station on Mars where the air is slowly leaking away. The book advertises the game as working on the Raspberry Pi 3 and Raspberry Pi 2, and on Windows PCs, running Python 3.6. On these platforms, I was able to test both the build of the game and the play-through of the game to completion. The game should also work wherever Pygame Zero runs, but I haven't been able to test it everywhere. I set a high standard for accuracy and testing in my books, and only felt able to actively endorse the platforms we had thoroughly tested.

Some readers have been in touch to ask about compatibility and pass on their advice for other readers. Here's a round-up of compatibility tips and tweaks.

Does Escape from Mission Python work on the Mac?

Yes! Othelo Vieira has kindly provided installation instructions for the software on his blog. David Weissman has also been in touch to confirm it's working "flawlessly" on his iMac. Many thanks to Othelo and David.

Does the Mission Python game Escape work with Python 2?

No, sorry. Pygame Zero is only available for Python 3. You can easily download and install Python 3. The instructions are in the book.

Does the Mission Python game Escape work with Python 3.7?

The book recommends Python 3.6 because at the time of writing, Pygame wasn't available for easy installation on Python 3.7. Charles G Smith Jr has been in touch to say he's got the game working on Python 3.7. He writes: "Good News. I was able to get your escape game up and running using version 3.7 of Python. Here is what I did to make your code work with the latest version. I added the import statement of import pgzrun at the top of the program, and I also added the statement pgzrun.go() at the bottom of your program." Many thanks to Charles.

If you're less experienced with Python and/or don't already have it installed, I still recommend using Python 3.6 as described in the book to avoid the need to add extra code into all your listings.

Does the Mission Python game Escape work on older Raspberry Pis?

It doesn't crash, but it runs too slow to enjoy. It does need a Raspberry Pi 2 or Raspberry Pi 3 really.

What screen resolution does the Escape game from Mission Python require?

The game window has a height of 800 pixels, and I have been running it on a screen with a resolution of 1152x864 or higher. However, I did a quick edit to adjust the window height to 700 pixels so it can fit on a screen with a resolution of 1024x768. You may still need to hide the taskbar. You can download the smaller version of Escape here. You will need to rename the extension from .txt to .py, or paste the code into your code editor.

The tallest room in the game is the third room you visit (West Corridor, room 37), so in this version I have taken the height down from 15 to 13 tiles, so it matches the next-largest room sizes. I have repositioned the toxic floor tiles within the new room to avoid them being too close to the bottom exit, which makes them unfairly hard to avoid. I have commented the lines that I changed in this program. Note that in the draw() function, the red box that is used to clear the game area must be resized to avoid overwriting the air and energy bars, and those bars must also be moved up in the AIR section of the program.

Thank you to Ian and Ben Brown for identifying this issue.

What about other compatibility questions?

If you have any concerns, here's a low-risk way to test it works. You can download the free PDF sampler, which includes the installation instructions for Windows and Raspberry Pi together with instructions to get the game working, and you can download the final game code too. You can then test that the game works on your computer before buying the book.

Thank you to everyone who has supported the book so far. I'm excited to see your reviews and customisations!

Permanent link for this post.


Three reasons to download this free PDF sampler of Mission Python

26 October 2018

You can now download a free 56 page sampler of my Python programming book, Mission Python. The book shows you how to build a space adventure game using Python and Pygame Zero.

Here are three reasons you should download this sampler now:

If you have any concerns about software compatibility, this is also a risk-free way to check the software and the final project will work on your set-up. The book provides instructions for the Raspberry Pi and Windows, and readers have been in touch to say they've got it working on a Mac. I'll share more tips on compatibility and getting everything working in my next blog post, but if you have any queries or concerns, feel free to leave a comment below and I'll do my best to help.

Find out more about Mission Python in the launch day blog post here. Discover places you can buy the book here.

Screenshot of the spacewalk simulator

The spacewalk simulator from Chapter 1 of Mission Python

Permanent link for this post.


Mission Python is out now!

16 October 2018

I am delighted to say that my latest book Mission Python has just been published. The book shows readers how to use Python and the Pygame Zero library to build a space adventure game. The game runs on a Raspberry Pi or Windows PC, using free software. We've provided all the images and sounds you need as a downloadable file.

Here's a short video showing the game in action (dramatic music added for the video):

There are several ways to enjoy the book. Some readers will want to play and solve the game first to avoid spoilers, and then use the book to understand how it works. (I have minimised spoilers where possible, but readers might notice some clues when they study the code). Other people might want to build the game, chapter by chapter, either by typing in the code or by using my example listings. At the end of the book, their finished game will be their reward. Still others might want to use the game as a starting point for their own customisations.

I've built in customisation opportunities that should enable every reader to do something unique with the game. Some readers might just want to put their friends' names into the game, and hack the text descriptions. Others will seize the opportunity to design their own room and put it into the game, add a new corridor, or even redesign the map entirely. For graphic artists who are looking for a portfolio project, there's the opportunity to reskin the whole game by replacing our graphics with new image files. More ambitious coders might want to take the engine for the game and replace the maps, descriptions, images and puzzles to create an entirely new game set in a new world. Most chapters include Training Missions, which are small exercises to test your knowledge, with answers at the end of the chapter.

My author copies of Mission Python are here!

When writing the book, I often thought of the kinds of things I enjoyed programming when I was at school. Back then, I was programming an Amstrad CPC computer and I learned a lot from studying listings in magazines and books. I would have loved a book like this to guide me through building a whole game. There are lots of great Python books out there, but the examples tend to be limited to a couple of pages to demonstrate a coding feature. Mission Python provides a single in-depth worked example that allows readers to really get their teeth into a substantial coding project. The program gradually builds, chapter by chapter, in digestible chunks, so readers see the game come together in a similar way to how I did when I first built it.

One of the rooms from the Escape game in Mission Python

The game featured in Mission Python is called Escape. Here is one of the rooms from the game.

You can see some more screenshots of the game in my previous blog post here.

The book is printed in full colour throughout, and produced to the high standards you would expect from the publisher NoStarch. Thanks to the team who worked on this title including the editors Liz Chadwick and Riley Hoffman, NoStarch CEO Bill Pollock, and Rafael Pimenta who did such a fabulous job of creating the game art. Tech editor Dan Aldred helped test the listings, and Daniel Pope created Pygame Zero which I'm using for images and sounds in this project.

I'll be sharing some more insights into the book and some extra resources for readers too over the coming weeks, so keep an eye on this blog or follow me on Twitter for updates. You can find links to order the book here, and more information on the book at its webpage here.

Permanent link for this post.


Mission Python: First screenshots from my new Python coding book

03 August 2018

I am so excited to share the news that my new book Mission Python is now at the printers, and will be available for you to read in September, published by No Starch Press. As you read the book, you'll learn how to build a game called Escape, using Python and Pygame Zero. You can use a Raspberry Pi 2 or 3, or a Windows PC to build and run the game.

In Escape, there is a breach in the wall of the space station, and comms are down. You must establish a safe air supply, and then message for help. As you go about your mission, you'll be challenged to think like an astronaut. You'll have to use the objects you find creatively to solve the game's puzzles.

You might want to play and solve the game first, then use the book to see how it works. Or might prefer to build the game first, then reward yourself with it when you finish making it. Or maybe you'll dive straight into the code listing, and use the book to see how you can customise it with your own maps and puzzles.

Here are some screenshots from the book, showing the fabulous game art created by Rafael Pimenta for this project. You'll be able to download all the art, sound and code files you need.

Screenshot from Mission Python

Chapter 1 uses a simple Spacewalk demo to show you how to draw images on the screen. Space images courtesy of NASA.

Screenshot from Mission Python

The starting room. That computer in the top left can give you a status update.

Screenshot from Mission Python

Dodge the drones. You only have a limited amount of energy.

Screenshot from Mission Python

To open that door you'll need the right access card.

I can't wait for you to see the final book. It's available for pre-order now from many shops, and I'll be happy to take any questions in the comments below. I'll be adding bonus resources to the Mission Python page on my website here. This is my first full-length Python book, but if you're looking for a primer on Python and Pygame Zero while you're waiting for Mission Python to come out, check out Raspberry Pi For Dummies 3rd Edition, which includes two chapters on Python.

Permanent link for this post.


Using the PiCube on Raspberry Pi

23 February 2018

I recently had a chance to play with the PiCube, a 3D grid of 64 LEDs that you can control using the Raspberry Pi's 40 GPIO pins. It's a clever design based on multiplexing that makes this possible, but the compromise is that you can't individually control each light. All the layers that are switched on show the same lights. It's of limited use for games, then, but could be great for creating visual effects. If you're building a large robot, you could make its pulsing "heart" using PiCube (although not in a heart shape). I'm reminded of KITT's voice box in Knight Rider.

In education, it provides a highly visual way to explore nested loops and nested lists. It's also a good way to drill your soldering skills, since it comes in kit form.

You can read my review of it in issue 67 of The MagPi, which has just been published. It's available for free download, but you can support the Raspberry Pi Foundation by buying it, on the high street or by subscription.

Here's a video showing the PiCube in action:

And here's the code I wrote for that demo. PiCube comes with some demo programs, but the pin numbers were arranged in a linear list in them. I found it easier to work my way around the grid when I created a nested list for the pins, which I've called GRID_3D here.

#! /usr/bin/python
import RPi.GPIO as GPIO
import time


LAYER = [40,38,36,32]

GRID_3D = [[7, 11, 35, 37],
     [12, 13, 31, 33],
     [15, 16, 23, 29],
     [18, 19, 21, 22]

def enable_layer(layer):
    GPIO.output(LAYER[layer], True)

def disable_layer(layer):
    GPIO.output(LAYER[layer], False)

def light_on(y, x, z):
    GPIO.output(GRID_3D[x][z], True)    

def light_off(y, x, z):
    GPIO.output(GRID_3D[x][z], False)

def reset():
    for x in range(4):
        for z in range(4):
            GPIO.output(GRID_3D[x][z], False)
def resetlayer():
    for i in range(0,4):

for pin in LAYER:
    GPIO.setup(pin, GPIO.OUT)

for x in range(4):
    for z in range(4):
        GPIO.setup(GRID_3D[x][z], GPIO.OUT)

# Display each light in turn
for y in range(4):
    for x in range(4):
        for z in range(4):
            light_on(y, x, z)
            light_off(y, x, z)

#Turn on all the lights
for y in range(4):
for x in range(4):
    for z in range(4):
        light_on(y, x, z)

PiCube is available now from SB Components.

Permanent link for this post.


Cool Scratch Projects gets a cool 5* review!

04 February 2018

My book Cool Scratch Projects In Easy Steps has received a fantastic 5* review in the latest issue of The MagPi magazine!

The reviewer writes: “Here’s a book that lives up to its title -- these are some cool scratch projects... If you got a Pi and a book for Christmas, this will make a great follow-on. Recommended.”

The reviewer loved that some of the games are programmed in 3D, and that each book comes with its own pair of 3D glasses and has an easy first project so you can get stuck in straight away.

You can read the review for yourself below and in issue 66 of The MagPi, available to download for free from The MagPi website. Alternatively, why not support the Raspberry Pi Foundation by subscribing to the print edition, or picking a copy up from your local newsagent or bookstore?

Review from The MagPi of Cool Scratch Projects in Easy Steps

Cool Scratch Projects in Easy Steps is out now. Find out more and download a free PDF sampler here, which includes the Magic Mirror project mentioned in the review. You can also watch a video previewing all the projects below.

Many thanks to The MagPi for the review!

Permanent link for this post.


Brighton Science Festival: Join a Coder Academy this February

29 January 2018

Book cover: Coder Academy I’ve been invited to the Brighton Science Festival on Monday 12 February, where I’ll be hosting a number of Coder Academy workshops. They are practical coding sessions for 7-10 year olds, tying in with my latest book (also called Coder Academy) which is published by Brighton-based publisher Ivy Kids.

You don’t need any previous experience of coding, just an interest and desire to know more. We’ll be learning snippets of the Scratch programming language and using them to experiment with digital art. The ticket includes a copy of the Coder Academy book, and I’ll be very happy to sign copies on the day!

Interested in coming along? Places are limited so register as soon as you can. And why not set yourself up with an account on the Scratch website before you come? It means you’ll be able to save your projects to share or work on later.

You can see the full programme for Brighton Science Festival here (10-18 February 2018, Brighton, various venues). Thank you to the organisers and the team at Ivy Kids for making this happen. I'm looking forward to seeing what the participants create!

Permanent link for this post.


Dip into the blog archive

June 2005 | July 2005 | August 2005 | September 2005 | October 2005 | November 2005 | December 2005 | January 2006 | February 2006 | March 2006 | April 2006 | May 2006 | June 2006 | July 2006 | August 2006 | September 2006 | October 2006 | November 2006 | December 2006 | January 2007 | February 2007 | March 2007 | April 2007 | May 2007 | June 2007 | July 2007 | August 2007 | September 2007 | October 2007 | November 2007 | December 2007 | January 2008 | February 2008 | March 2008 | April 2008 | May 2008 | June 2008 | July 2008 | August 2008 | September 2008 | October 2008 | November 2008 | December 2008 | January 2009 | February 2009 | March 2009 | April 2009 | May 2009 | June 2009 | July 2009 | August 2009 | September 2009 | October 2009 | November 2009 | December 2009 | January 2010 | February 2010 | March 2010 | April 2010 | May 2010 | June 2010 | August 2010 | September 2010 | October 2010 | November 2010 | December 2010 | March 2011 | April 2011 | May 2011 | June 2011 | July 2011 | August 2011 | September 2011 | October 2011 | November 2011 | December 2011 | January 2012 | February 2012 | March 2012 | June 2012 | July 2012 | August 2012 | September 2012 | October 2012 | December 2012 | January 2013 | February 2013 | March 2013 | April 2013 | June 2013 | July 2013 | August 2013 | September 2013 | October 2013 | November 2013 | December 2013 | January 2014 | February 2014 | March 2014 | April 2014 | May 2014 | June 2014 | July 2014 | August 2014 | September 2014 | October 2014 | November 2014 | December 2014 | January 2015 | February 2015 | March 2015 | April 2015 | May 2015 | June 2015 | September 2015 | October 2015 | December 2015 | January 2016 | February 2016 | March 2016 | May 2016 | July 2016 | August 2016 | September 2016 | October 2016 | November 2016 | December 2016 | January 2017 | April 2017 | July 2017 | August 2017 | October 2017 | November 2017 | January 2018 | February 2018 | August 2018 | October 2018 | November 2018 | Top of this page | RSS