Skip to main content

Pygame Zero like API to teach 3d games programming based on Raylib

Project description


A simplified API for Raylib for use in education and to enable beginners to create 3d games.

Current state: working, but untested alpha, API may change.


Richlib is just a few classes that sit on top of Raylib Python CFFI. Once you have imported Richlib you automatically get all of raylib.static and raylib.pyray and you could just copy any Raylib Python example code you find. Then if you want to use Richlib's classes as well as Raylib you can.

The normal way of using Richlib is not to write your own main game loop. Instead, you set some variables to tell Richlib how you'd like your game to be:

from richlib import *


cube = Cube((0, 10, 0), (10, 20, 10), 'blue')

Then you define some specially named methods:

def draw():

def update():
    cube.x = cube.x + 1
    if cube.x > 100:
        cube.x = -100

Then you tell Richlib to run your methods in its game loop:


Differences from Pygame Zero

  1. We don't have a special mode in the Mu editor like Pygame Zero does, and therefore it is necessary to add an import line to the start of every program, and a run() line to the end.

  2. The underlying API, Raylib, is not object oriented like Pygame is. The stuff added by Richlib is object oriented but you might notice there is no proper equivalent of the screen object because Raylib doesn't have one.

  3. 3D games are inherently more complex than 2D, e.g. there is no equivalent of the camera object for the 2d programmer to worry about.

  4. To mitigate (3) as much as possible we do automate some stuff that you might expect to do manually in Pygame Zero.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for richlib, version 0.0.6
Filename, size File type Python version Upload date Hashes
Filename, size richlib-0.0.6-py3-none-any.whl (22.4 MB) File type Wheel Python version py3 Upload date Hashes View
Filename, size richlib-0.0.6.tar.gz (19.6 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page