PyGaSe
Python Game Server
A package for Python 3.6+ that contains a game-ready client-server architecture and UDP-based network protocol.
It deals with problems such as package loss or network congestion so you don't have to. Instead it gives you a high-level API to easily connect clients and backends that share a synchronized game state and exchange events. The async framework for this one is curio, which I highly recommend.
PyGaSe is built to be easy to use, lightweight, fast, scalable and reliable. You can build a fast-paced real-time online game with this. You can also build a large-scale MMO with thousands of clients if you like.
I'm actively developing PyGaSe in the context of several Indie game projects and I'm happy to share it.
BREAKING CHANGE: Version 0.2.0 is basically a new API and updating from 0.1.9 or lower will break you code. It is also much more stable, flexible and powerful, so make sure to use 0.2.0 or higher.
Installation
pip install pygase
or better yet poetry add pygase. Seriously, use poetry, it's a revelation.
Usage
API Reference & Tutorials
For API documentation and a Getting Started section go here.
Example
This example game implements an online game of tag, in which players can move around, while one of them is the chaser who has to catch another player. A player who has been catched becomes the next chaser and can catch other players after a 5s protection countdown.
Run server.py first, then run client.py in additional terminal sessions to add players.
Only use the same player name once.
Debugging & Logging
You can use the standard logging module. On level INFO you will get logging output for events such as
startups, shutdowns, new connections or disconnects. On DEBUG level you get detailed output right down to the level
of sending, receiving and handling single network packages.
Debug logs are also a good way to understand the inner workings of PyGaSe.
Changes
0.3.0
- sticking to SemVer from here on out
- logging added using the standard
loggingmodule - improve event handler arguments
Backendclass added to reduce server-side boilerplate- various bugfixes
0.2.0
- complete overhaul of pygase 0.1.x with breaking API changes