freegames 2.5.3

Testimonials

“I love Free Python Games because the games are fun and they’re easy to understand and change. I like making my own games now.”

– Luke Martin, Student

“Free Python Games inspired and introduced a new hobby to our son. Thank you so much for exposing him to coding. He is having so much fun!”

– Mary Lai, Parent

“Free Python Games are great because they really engage students and let them learn at their own pace.”

– Rick Schertle, Teacher, Steindorf STEAM School

“Free Python Games combines play and learning in a flexible environment that reduces the stress of a difficult topic like programming.”

– Brett Bymaster, Youth Pastor, The River Church Community

“Free Python Games is great for students, is highly organized and flexible, and seeks to unleash inquiry and understanding.”

– Terri Furton, Principal, Downtown College Prep

Features

• Fun to play!

• Simple Python code

• Easy to install

• Designed for education

• Depends only on the Python Standard Library

• Used in hundreds of hours of classroom instruction

• Fully Documented

• 100% Test Coverage

• Developed on Python 3.10

• Tested on CPython 3.6, 3.7, 3.8, 3.9, 3.10

• Tested on Linux, Mac OS X, and Windows

• Tested using GitHub Actions

Quickstart

Installing Free Python Games is simple with pip:

$ python3 -m pip install freegames

Free Python Games supports a command-line interface (CLI). Help for the CLI is available using:

$ python3 -m freegames --help

The CLI supports three commands: list, copy, and show. For a list of all games run:

$ python3 -m freegames list

Any of the listed games may be played by executing the Python module from the command-line. To reference the Python module, combine “freegames” with the name of the game. For example, to play the “snake” game run:

$ python3 -m freegames.snake

Games can be modified by copying their source code. The copy command will create a Python file in your local directory which you can edit. For example, to copy and play the “snake” game run:

$ python3 -m freegames copy snake
$ python3 snake.py

Python includes a built-in text editor named IDLE which can also execute Python code. To launch the editor and make changes to the “snake” game run:

$ python3 -m idlelib.idle snake.py

You can also access documentation in the interpreter with Python’s built-in help function:

>>> import freegames
>>> help(freegames)

Free Python Games also provides an entry-point script for compatibility with pipx:

$ pipx install freegames
$ freegames play life

Free Games

Paint

Paint – draw lines and shapes on the screen. Click to mark the start of a shape and click again to mark its end. Different shapes and colors can be selected using the keyboard.

Snake

Snake – classic arcade game. Use the arrow keys to navigate and eat the green food. Each time the food is consumed, the snake grows one segment longer. Avoid eating yourself or going out of bounds!

Pacman

Pacman – classic arcade game. Use the arrow keys to navigate and eat all the white food. Watch out for red ghosts that roam the maze.

Cannon

Cannon – projectile motion. Click the screen to fire your cannnonball. The cannonball pops blue balloons in its path. Pop all the balloons before they can cross the screen.

Connect

Connect – Connect 4 game. Click a row to drop a disc. The first player to connect four discs vertically, horizontally, or diagonally wins!

Flappy

Flappy – Flappy-bird inspired game. Click the screen to flap your wings. Watch out for black ravens as you fly across the screen.

Memory

Memory – puzzle game of number pairs. Click a tile to reveal a number. Match two numbers and the tiles will disappear to reveal an image.

Pong

Pong – classic arcade game. Use the keyboard to move your paddle up and down. The first player to miss the ball loses.

Simon Says

Simon Says – classic memory puzzle game. Click the screen to start. Watch the pattern and then click the tiles in the same order. Each time you get the sequence right the pattern gets one step longer.

Tic Tac Toe

Tic Tac Toe – classic game. Click the screen to place an X or O. Connect three in a row and you win!

Tiles

Tiles – puzzle game of sliding numbers into place. Click a tile adjacent to the empty square to swap positions. Can you make the tiles count one to fifteen from left to right and bottom to top?

Tron

Tron – classic arcade game. Use the keyboard to change the direction of your Tron player. Avoid touching the line drawn by your opponent.

Life

Life – Conway’s Game of Life. The classic, zero-player, cellular automation created in 1970 by John Conway.

Maze

Maze – move from one side to another. Inspired by A Universe in One Line of Code with 10 PRINT. Tap the screen to trace a path from one side to another.

Fidget

Fidget – fidget spinner inspired animation. Click the screen to accelerate the fidget spinner.

Illusion

Illusion – an optical illusion.

Typing

Typing – practice typing while letters fall down the screen.

User Guide

For those wanting more details, this part of the documentation describes curriculum, API, and development.

• Talk: Give the Gift of Python

• Free Python Games Curriculum

• Free Python Games API Reference

• Free Python Games Development

References

• Free Python Games Documentation

• Free Python Games at PyPI

• Free Python Games at GitHub

• Free Python Games Issue Tracker

Free Python Games License

Copyright 2017-2023 Grant Jenks

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.