werewolf-engine 0.1.0

A flexible, extensible Werewolf game engine for Python

WereWolf Engine

A flexible, extensible Werewolf (Mafia) game engine for Python.

Features

• 6 built‑in roles: Villager, Werewolf, Seer, Doctor, Witch, Hunter
• Plugin system for custom roles
• Full night/day cycle with priority and conflict resolution
• Voting system with majority & tie handling
• Event bus for UI integration
• Save/restore game state (to/from dict)
• 23+ tests covering all features

Installation

pip install werewolf-engine

Quick Example

from werewolf_engine import Game, GameConfig

config = GameConfig(role_counts={"villager": 3, "werewolf": 2, "seer": 1, "doctor": 1, "witch": 1, "hunter": 1})
game = Game(["Alice", "Bob", "Charlie", "Diana", "Eve", "Frank", "Grace", "Hank", "Ivy"], config)
game.start()

# Drive the game with your own UI (bot, web, CLI...)
while game.phase != Phase.END:
    if game.phase == Phase.NIGHT:
        actor = game.night_manager.current_actor
        if actor:
            targets = game.night_manager.get_available_targets(actor)
            # get user choice, then:
            game.night_action(actor.id, chosen_target.id)

Documentation

Full documentation is available in English and Persian:

• English Docs
• مستندات فارسی

Learn about roles, events, API reference, and how to contribute.

License

This project is licensed under the MIT License.