Skip to main content

A 2-D engine for Python and pygame

Project description

laylib package for pygame

.. image:: :target:

.. image:: :target:

.. image:: :target:

This package is made to fast prototype your multimedia applications like games on pygame. Write clean and pragmatic design. It lets you focus on the game engine itself, so you don't have to take care about several details like setting up the window, loading and checking data (images, sound, font, fx, music, resources names...). All you need to do is to put your resources into a specific data folder and use them in your game class 'MyEngine()'.

You don't need to reinvent the wheel, some repetitive parts of code (main loop, getting the delta time, closing the window, drawing text...) are already described and ready to use in the default engine.

Usage example :

  • Template main file

.. code-block:: python

from laylib import Environment
from engine import Engine
import sys

def main():
demo = Environment(800, 600, False, 'My game')
demo.load_complete(Engine(), 'data')

if __name__ == "__main__":
  • Template engine file

.. code-block:: python

import pygame as pg
from laylib import DefaultEngine

BLACK = (0, 0, 0)
FPS = 30.0

class Engine(DefaultEngine):
	""" Short summary.

	def __init__(self):

	def update(self):
		""" Code to update all classes : 
		the global behavior should be written here.

	def draw(self):
		""" Code to draw all classes

	# init engine or set up environement

	def setup(self):
		self.playing = True
		# rescale in laylib time unit to 100.0 as example
		self.time_unit = 100.0
		self.fps = FPS
		rest of init code


First, install the dependencies:

.. code-block:: bash

$ pip install -r requirements.txt

Then install laylib:

.. code-block:: bash

$ pip install laylib

Or alternatively, you can just copy the "laylib" folder into the same directory as the Python program that uses it.


For usage see examples provided with laylib. For more details, all other parts of documentation are described in the source file.

Release History

  • 1.1.9

    • removed ressources.bin parameter
  • 1.1.8

    • version 1.1.7 revision
    • add demo4, rain demo
    • add FPS control, now we can set fps with "self.fps" in the main engine to control frame rate.
  • 1.1.7

    • version 1.1.6 revision
    • update demo1
  • 1.1.6

    • class Music in add the function play() to control the music playlist and the volume
    • update demo1 to integrate music play() function.
    • all private methods prefixed with underscore
    • one common data folder for test and demo, to reduce size.
  • 1.1.5

    • in Resources manager: the sound format .ogg is moved to Music class and removed from Sound 'fx' class.
    • relative path to test_laylib changed
    • variable self.all_sprites = pg.sprite.Group() set directly in the DefaultEngine class.
    • add demo1 example to show how to manage resources with laylib
    • updating test_laylib for the 1.1.5 version
    • update documentation in the source files.
  • 1.1.4

    • Add Travis CI file
    • bug fix rotate function file
    • changed value 3.14 to math.pi deg2rad function
    • add complete test module
    • changed to README.rst
  • 1.1.3

    • Bug version package fix ( file).
  • 1.1.2

    • Removed functions: load_global()/destroy_global() from Resources class.
    • Bug version fix ( file).
  • 1.1.1

    • Now we can set the 'time_unit' to change the delta_time unit.
    • Minor bugs fix on
  • 0.1.0

    • The first proper release
  • 0.0.1

    • Work in progress


Amardjia Amine – Distributed under the MIT license.

Project details

Download files

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

Source Distribution

laylib-1.1.9.tar.gz (11.7 kB view hashes)

Uploaded source

Built Distribution

laylib-1.1.9-py3-none-any.whl (12.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page