pyglet-gamemaker 1.0.1

pyglet wrapper for making games.

📦 pyglet-gamemaker

ℹ️ Overview

pyglet-gamemaker is an extension of Pyglet that simplifies the process of making games! This project began when I became frustrated at the boilerplate I had to write all the time, and I wanted a cleaner system to quickly add features.

🌟 Features

• Hitboxes
  • Fully working convex polygon collision
  • Includes circles
• Spritesheets:
  • Automatically loaded
  • Labelable to allow for indexing by string
• Widgets:
  • Dynamic anchoring for changing size
  • Uses spritesheets instead of individual images
• Scenes:
  • Enabling and disabling handled automatically
  • Menus:
    • Easily create visuals + widgets
    • Widget positions relative to window size
• Main Window class handles switching of scenes

✍️ Authors

I'm Steven Robles and I am a high school student with a small? passion for making games.

🚀 Usage

A simple program to render an empty Menu with button detection:

>>> import pyglet_gamemaker as pgm
>>> from pyglet_gamemaker.types import Color
>>> 
>>> 
>>> class Menu(pgm.Menu):
>>>     # Create widgets here
>>>     def create_widgets(self): ...
>>>     # Code that runs when button is pressed down
>>>     def on_half_click(self, button): ...
>>>     # Code that runs when button is fully clicked and released
>>>     def on_full_click(self, button): ...
>>>     # Code that runs when scene is enabled
>>>     def enable(self): ...
>>>     # Code that runs when scene is disabled
>>>     def disable(self): ...
>>> 
>>> 
>>> scene = Menu('Test')
>>> game = pgm.Window((640, 480))
>>> game.add_scene('Test', scene)
>>> game.run()

Creating a spritesheet

>>> # Create a sprite sheet with image assets
>>> #   This image, found in /test, has 3 images (bottom to top):
>>> #   Unpressed, Hover, and Pressed
>>> self.sheet = pgm.sprite.SpriteSheet('test/Default Button.png', rows=3, cols=1)

The following should go in Menu.create_widgets():

• Creating text

>>> self.create_text(
>>>     'Text', 'Test',
>>>     ('center', 'center'), color=pgm.types.Color.BLACK
>>> )

• Creating a button

>>> self.create_button(
>>>     'Button', self.sheet, 0,
>>>     ('center', 'center'),
>>>     # Event handlers defined in empty Menu class above
>>>     on_half_click=self.on_half_click, on_full_click=self.on_full_click
>>> )

• Creating a text and button in one

>>> # A textbutton combines text and a button
>>> #   Hover enlarge makes text larger when hovering
>>> #   Works well with using larger hover sprite for button
>>> self.create_text_button(
>>>     'TextButton', 'Text',
>>>     self.sheet, 0,
>>>     ('center', 'center'), ('center', 'center'),
>>>     # Event handlers defined in empty Menu class above
>>>     on_half_click=self.on_half_click, on_full_click=self.on_full_click
>>> )

⬇️ Installation

Simple, understandable installation instructions!

pip install pyglet-gamemaker

Works in Python >=3.10

💭 Feedback and Contributing

To request features or report bugs, open an issue here.

Contact me directly