https://github.com/rrthomas/chambercourt
Simple 2D grid game framework based on PyGame
https://github.com/rrthomas/chambercourt
Last synced: 3 months ago
JSON representation
Simple 2D grid game framework based on PyGame
- Host: GitHub
- URL: https://github.com/rrthomas/chambercourt
- Owner: rrthomas
- License: gpl-3.0
- Created: 2025-01-01T16:17:42.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-29T20:34:54.000Z (about 1 year ago)
- Last Synced: 2025-06-29T20:09:39.048Z (11 months ago)
- Language: Python
- Size: 931 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# ChamberCourt
https://github.com/rrthomas/chambercourt
by Reuben Thomas
ChamberCourt is a framework for simple 2-D grid-based games, based on
[PyGame](https://pygame.org).
It is only intended for use by the author, mostly to resurrect a bunch of
old games he wrote a long time ago. I welcome help to make it more generally
useful: there is room for improvement in many areas. For example, it would
be nice if the games could run on the web (I have experimented with
[pygbag](https://github.com/pygame-web/pygbag/), but I didn’t get very far
yet), and some basic functionality would be nice such as a UI for rebinding
keys. However, I want to keep it as simple as possible!
The package is named after the central courtyard of my school, Winchester
College, because I wrote this package first while resurrecting a game,
[WinColl](https://github.com/rrthomas/wincoll), named after the school.
## Installation
Install with `pip`: `pip install chambercourt`.
## Creating games with ChamberCourt
The following documentation is available:
* [API documentation](https://rrthomas.github.io/chambercourt)
* [Cookbook](Cookbook.md)
* Demo game: a demonstration game is available, called `chambercourt`. You
can run it directly from a Git checkout with
`PYTHONPATH=. python -m chambercourt`.
## Creating and editing levels
Levels are created and edited in [Tiled](https://www.mapeditor.org/). All
in-game graphics and sounds are stored in the levels directory by
convention. A demonstration level is in `chambercourt/levels`.
Some notes about level design:
+ A set of levels is numbered according to the lexical order of their file
names.
+ Levels need exactly one start position, given by placing the hero.
## Copyright and Disclaimer
ChamberCourt is distributed under the GNU Public License version 3, or, at
your option, any later version. See the file COPYING.
THIS PROGRAM IS PROVIDED AS IS, WITH NO WARRANTY. USE IS AT THE USER'S RISK.
Except for the files mentioned below, the package is copyright Reuben
Thomas.
The font “Acorn Mode 1”, which is based on the design of Acorn computers’
system font, is by p1.mark and Reuben Thomas and licensed under CC BY-SA
3.0.