PoliBox - Political Sandbox Simulation

A text-based political simulation game where you can manage your own nation through policy decisions and strategic governance.

Features

• Manage various aspects of governance including economy, social welfare, and infrastructure
• Track key metrics like GDP, life expectancy, and citizen happiness
• Make policy decisions that affect your nation's development
• Deal with random events and crises

Project Structure

polibox/
├── src/polibox/         # Main package directory
│   ├── __init__.py     # Package initialization
│   ├── main.py         # Game entry point
│   ├── events.py       # Event handling system
│   └── nation.py       # Nation management logic
├── tests/              # Test files
│   └── __init__.py     # Test package initialization
├── scripts/            # Utility scripts
├── requirements.txt    # Project dependencies
├── LICENSE            # MIT License
└── README.md          # This file

Installation

1. Clone the repository:

git clone https://github.com/yourusername/polibox.git
cd polibox

2. Create a virtual environment (recommended):

python -m venv venv
source venv/bin/activate  # On Unix/macOS
# or
.\venv\Scripts\activate  # On Windows

3. Install dependencies:

pip install -r requirements.txt

Running the Game

Start the game by running:

python -m src.polibox.main

How to Play

• You start as the leader of a new nation
• Each turn represents a quarter (3 months)
• Make decisions about policies and resource allocation
• Monitor your nation's progress through various metrics
• React to events and manage crises
• Try to maintain balance between economic growth and citizen welfare

Development

Running Tests

pytest tests/

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests
5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Authors

• Your Name - Initial work

Acknowledgments

• Thanks to all contributors
• Inspired by various political simulation games