open-mafia-engine 0.5.0b1

Open Mafia Engine - a framework for mafia/werewolf games.

Open Mafia Engine

The Open Mafia Engine is a flexible, open-source game engine for Mafia-like games.

See the Wikipedia article for information on what Mafia/Werewolf is.

The Open Mafia Engine actually allows a much broader type of game to be played, with custom roles and very intricate "setups". Most of these custom roles come from either "real-life" games or online forums such as MafiaScum and Bay12Games Mafia Subforum.

Features

• Event-based architecture, which allows for very complex interactions.
• Many built-in abilities, victory conditions, etc. (This is a lie, but we're working on it!)
• Games are defined declaratively or using an parametrized GameBuilder.
• Open source & extensible, with a plugin system in the works.

Installing

Install the latest stable version via pip:

pip install open_mafia_engine

See the dev docs to install for local development (using Poetry).

Getting started

This example starts a 5-player "test" mafia game (1 mafioso vs 4 townies):

import open_mafia_engine.api as mafia

builder = mafia.GameBuilder.load("test")
players = ['Alice', 'Bob', 'Charlie', 'Dave', 'Eddie']
game = builder.build(players)

Actually running commands in the engine is pretty complicated for now. We're working to improve the experience.

See playground.py in the repository for an example game.