https://github.com/pticalin/simple-game-engine
A handcrafted game engine for point-and-click adventures, puzzle games, and narrative experiments. Written from scratch in Python with PyGame, YAML, and deep modularity in mind.
https://github.com/pticalin/simple-game-engine
2d-game adventure-game custom-engine dialogue-engine experimental-game-engine game-development game-engine interactive-fiction modular-system narrative-game open-source point-and-click-adventure-game point-and-click-game puzzle-game pygame python surreal-games yaml
Last synced: about 2 months ago
JSON representation
A handcrafted game engine for point-and-click adventures, puzzle games, and narrative experiments. Written from scratch in Python with PyGame, YAML, and deep modularity in mind.
- Host: GitHub
- URL: https://github.com/pticalin/simple-game-engine
- Owner: PtiCalin
- License: mit
- Created: 2025-06-24T21:49:41.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-24T22:33:32.000Z (12 months ago)
- Last Synced: 2025-06-24T23:19:41.147Z (12 months ago)
- Topics: 2d-game, adventure-game, custom-engine, dialogue-engine, experimental-game-engine, game-development, game-engine, interactive-fiction, modular-system, narrative-game, open-source, point-and-click-adventure-game, point-and-click-game, puzzle-game, pygame, python, surreal-games, yaml
- Language: Python
- Homepage:
- Size: 16.6 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: change-log.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# 🔧 simple-game-engine
> A modular point-and-click adventure engine written in Python.
Simple Game Engine is built to support surreal, story-rich games inspired by
Rusty Lake, A Little to the Left, Frog Detective, Tangle Tower, Outer Wilds and
more. It focuses on smooth interactions, seamless modularity and expansive
possibilities.
[](LICENSE)
[](.github/workflows/ci.yml)
[](#)
[](./.github/pull_request_template.md)
[](https://github.com/your-username/simple-game-engine/discussions)
---
## 🌟 Key Features
- Scene manager with interactive hotspots
- YAML-based item, character, and puzzle logic
- Inventory and contextual action systems
- Persistent ``GameState`` for flags and progress
- Modular dialogue engine with branching paths
- Timeline system for synced events and time loops
- Support for character traits, interaction effects, and narrative memory
## 🧠 Goals
- Total creative freedom
- Extensible for visual scripting or modding
- Engine + toolkit for building games that are weird, personal and beautiful
## 🗺️ Project Roadmap
The full development roadmap lives in [ROADMAP.md](ROADMAP.md).
---
## 🚀 Getting Started
Clone this repo and install dependencies:
```bash
git clone https://github.com/your-username/simple-game-engine.git
cd simple-game-engine
pip install -r requirements.txt
```
### 🛠 Run the Demo
```bash
python main.py # or your preferred dev command
```
### ⏱ Timeline Events
Scenes can schedule delayed actions:
```yaml
scene:
id: intro
features:
time_loop: true
events:
- trigger: delay
time: 30 # seconds
action: set_flag
flag: door_closed
```
### 🗺 World Manager
Worlds are described in YAML files that list regions and scenes. This new format
includes metadata like ``title`` and ``start_region``. Load a world with
``WorldManager``:
```yaml
world:
id: montreal
title: "Surreal Montreal"
start_region: mileend
regions:
- id: mileend
scenes: [ruelle_portail]
```
```python
from engine.world_manager import WorldManager
wm = WorldManager("game/worlds/montreal.yaml")
print(wm.current_scene())
```
### 🎨 Asset Manager
Use ``AssetManager`` to cache images and music referenced by scenes:
```python
from engine.asset_manager import AssetManager
assets = AssetManager()
scene = ... # a Scene object
assets.preload_scene(scene)
background = assets.get_image(scene.background)
```
---
## 🤝 Contributing
We welcome bug reports, feature ideas and pull requests!
- [🐛 Bug Reports](./.github/ISSUE_TEMPLATE/bug.yml)
- [🌟 Feature Requests](./.github/ISSUE_TEMPLATE/feature-request.yml)
- [📦 Pull Requests](./.github/pull_request_template.md)
See [CONTRIBUTING.md](CONTRIBUTING.md) for how to get started.
Join us in [💬 GitHub Discussions](https://github.com/your-username/simple-game-engine/discussions) to share ideas.
---
## 📜 License
Distributed under the [MIT License](LICENSE).
You are free to fork, remix, and share — just be kind.