pykrieg 0.3.0

A Pythonic wargame engine for Guy Debord's Le Jeu de la Guerre

Pykrieg

A Pythonic wargame engine for Guy Debord's Le Jeu de la Guerre (A Game of War).

About

Pykrieg is a Python library that implements the complex rules of Guy Debord's strategic tabletop game, providing a clean, extensible API for developers to build custom interfaces, AI opponents, and analysis tools. The project is inspired by the successful python-chess library and follows similar design principles.

Installation

pip install pykrieg

For console interface with mouse support:

pip install pykrieg[console]

Features

• Complete Game Engine: Full implementation of Debord's strategic game rules
• Format Support: KFEN format for saving/sharing games
• Console Interface: Interactive terminal-based gameplay
• Protocol Support: UCI-like protocol for engine-frontend communication (v0.3.0)

Quick Start

Console Interface (Casual Players)

Launch the interactive console game:

python -m pykrieg.console

Play using simple commands:

• move 5,10 6,10 - Move a unit
• attack 5,12 - Attack a target
• pass - Skip attack phase
• end - End turn
• help - Show all commands

Python API (Developers)

from pykrieg import Board

# Create a board
board = Board()

# Add units
board.create_and_place_unit(5, 10, 'INFANTRY', 'NORTH')

# Move a unit
board.make_turn_move(5, 10, 6, 10)

# Attack
board.switch_to_battle_phase()
result = board.make_turn_attack(1, 12)

# End turn
board.end_turn()

Donations

If you like the project and want to support future development, consider donating!

License

This project is licensed under the GNU General Public License v3.0 - see LICENSE for details.

The GPL v3 license ensures that:

• The software remains free for all users
• Commercial use is permitted, including selling the software or offering it as a service
• Derivative works must be shared under the same license (copyleft)
• Users have the freedom to study, modify, and distribute the software