Gamelib is a pure-Python single-file library/framework for writing simple games.

Last update: Dec 22, 2022

Related tags

Overview

Gamelib

Gamelib is a pure-Python single-file library/framework for writing simple games. It is intended for educational purposes (e.g. to be used in basic programming courses).

Here is a "hello world" example:

import gamelib

def main():
    gamelib.resize(300, 300)

    gamelib.draw_begin()
    gamelib.draw_text('Hello world!', 150, 150)
    gamelib.draw_end()

    # wait until the user presses any key
    gamelib.wait(gamelib.EventType.KeyPress)

gamelib.init(main)

And this example shows a rectangle moving around the screen:

import gamelib

def main():
    gamelib.resize(300, 300)

    x, y = 150, 80
    dx, dy = 5, 5

    while gamelib.loop(fps=30):
        for event in gamelib.get_events():
            if event.type == gamelib.EventType.KeyPress and event.key == 'q':
                return

        gamelib.draw_begin()
        gamelib.draw_rectangle(x-10, y-10, x+10, y+10, fill='red')
        gamelib.draw_end()

        x += dx
        y += dy
        if x > 300 or x < 0:
            dx *= -1
        if y > 300 or y < 0:
            dy *= -1

gamelib.init(main)

Goals

Easy to learn: Writing a simple game should be almost as easy as writing console programs. It should not require knowledge about inheritance, components, double-buffering, color channels, blitting or actors.
Simple, basic API: Support drawing stuff and maybe playing sounds, nothing more.
Portable Support Windows / Mac OS / Linux desktop.
Easy to install: See relevant XKCD. gamelib.py should not depend on anything that's not available in a fresh Python installation. That rules out pip.

Installation

Just download gamelib.py and place it alongside your project :)

Documentation

First, look into the provided examples!

Gamelib library reference: https://dessaya.github.io/python-gamelib/

To generate the HTML documentation:

$ pip3 install pdoc3
$ bash docs/generate.sh

Run the examples

$ python3 example-01-hello-world.py

Limitations

Very limited drawing API (based on Tkinter Canvas).
- Don't expect to be able to draw thousands of elements at 60 FPS.
- The only image formats that are supported accross all platforms are GIF and PPM/PGM/PBM.
Very limited sound API (just a single function: play_sound(), based on playsound).
- The only sound format supported accross all platforms is probably WAV.
Very limited GUI API (just two functions: say() and input()).
Supports only a single window.
No joystick support.

You might also like...

Python Interactive Mini Games

Python Interactive Mini Games Mini projects from Coursera's An Introduction to I

1 Jan 16, 2022

Find live blooket games easy with python.

Blooket-pin-finder Find live blooket games easy with python. info when you start you will see what looks like error DON'T STOP those are just the thre

1 Mar 7, 2022

AI plays games with python

AI-plays-games- To use it, you first need to create an img file and save the pic

7 Oct 16, 2022

Python game engine for 2D multiplayer online games.

LAN-Caster The goal of LAN-Caster is to provide an easy-to-use code base (game engine) for developing 2D multiplayer online games. LAN-Caster original

1 Feb 11, 2022

AI Games and its programming solution with Python.

Problem: Save the princess: Problem defination on Hackerrank: https://www.hackerrank.com/challenges/saveprincess About problem: Princess Peach is trap

1 Feb 19, 2022

A pure python implementation of a solver for the popular game wordle.

1 Oct 6, 2022

A pure-Python Wordle and Absurdle solver

Pyrdle A pure-Python Wordle and Absurdle solver Find the originals here: Wordle Absurdle Basic solving: Wordle To solve today's Wordle, simply run: ./

3 Feb 9, 2022

A comprehensive, feature-rich, open source, and portable, collection of Solitaire games.

PySol Fan Club edition This is an open source and portable (Windows, Linux and Mac OS X) collection of Card Solitaire/Patience games written in Python

368 Dec 28, 2022

To solve games using AI, we will introduce the concept of a game tree followed by minimax algorithm.

7 Oct 13, 2022

Comments

Deprecated reference to mouse buttons

Dunno if this counts as an issue, but looking through the doc, I realized that it refers to the left, middle and right click buttons of the mouse as 0, 1 and 2 respectively.

https://github.com/dessaya/python-gamelib/blob/9cb0d87ef88712091560deb5d74295ae78461fb0/gamelib.py#L649

It may be because they updated it, but Tkinter actually refers to these buttons as 1, 2 or 3 respectively. This could lead to confusion.

Already confirmed this is the case testing it on my own project.

opened by NLGS2907 0
Infinite looping print

https://github.com/dessaya/python-gamelib/blob/52f168a6b9fc0b3b83d33a2a40201c023ff18ff2/gamelib.py#L103

I'm guessing it was for test use only. Would be nice to remove it.

opened by mjsantoni 0