BLAKBOX 2025.0.1

Reach Inside The Box...

---

BLAKBOX

What?

BLAKBOX is a game development framework designed to help developers create more with less hassle. It provides a structured foundation for handling scenes, objects, UI, input, and rendering, so you can focus on making games instead of reinventing the wheel.

Why?

• Save Time – No need to build a game structure from scratch.
• Better Organization – Scenes, assets, and objects are neatly managed.
• Pygame, but Better – All the flexibility of Pygame, with added convenience.

Content?

• Modularity – Manage your game with a clean and modular API.
• Scene & Object Management – Easily define and switch between game scenes.
• Custom UI System – Buttons, text fields, and interface-scripting made simple.
• Asset Loading – Load images and sprite sheets efficiently.
• Input Handling – Keyboard and mouse events with built-in support.
• Partitioning Systems – Efficient object management for game worlds of many sizes.

Download?

Install BLAKBOX via pip:

pip install BLAKBOX

Getting Started?

After youv'e installed blakbox go ahead and create a script named main.py somwhere and paste in this code:

import blakbox

class MyGame(blakbox.app.BOXapplication):
    def __init__(self) -> None:
        super().__init__(
            name = "My Game",           # initial window title
            window_size = [800, 600],   # the window itself
            display_size = [1600, 1200] # the surface "within" the window 
        )

    def configure(self):
        # add our scene
        self.main_menu = self.add_scene(MainMenu(self))  # this returns an integer ID, representing our scene
        
        # we can use that integer ID to select our current scene
        self.set_scene(self.main_menu)

    def cleanup(self): pass
    def handle_events(self): pass
    def handle_update(self): pass

if __name__ == "__main__":
    MyGame().run()

| NOTE: The methods configure(), cleanup(), handle_events() and handle_update() must be defined for any instance of BOXapplication.

Above is the minimal code needed to get BOXapplication up and running. From here you can explore the BOXscene and the other classes provided in blackbox.app.resource and blakbox.app.ui.

Check out the blakbox/examples directory to get a look at some "real world" use cases for the library, maybe even kickstart your next project.

Contributions?

Want to help improve BLAKBOX? Feel free to contribute by submitting issues, suggesting features, or making pull requests!

License

BLAKBOX is open-source under the MIT License.