Tipping Pigs 3
==============

.. image:: https://img.shields.io/badge/python-3.9%2B-blue
   :alt: Python 3.9+

.. image:: https://img.shields.io/badge/license-MIT-green
   :alt: MIT License

A pygame-based serious game about resource management and ecological tipping points.
You play as the *Rahui* — the environmental manager of a Polynesian island — balancing
pig population, villager happiness, and ecosystem health before the island tips past
the point of no return.

.. image:: _static/tippingpigs.png
   :alt: Startscreen of Tipping Pigs
   :align: center

The start screen of Tipping Pigs. Game can be played in English and German.

.. toctree::
   :maxdepth: 2
   :caption: User Guide

   installation
   gameplay

.. toctree::
   :maxdepth: 4
   :caption: API Reference

   api/index

Overview
--------

The game models a fragile island ecosystem:

- **Pigs** breed naturally, eat vegetation, and cause tile degradation.
- **Villagers** chop forests, adding to environmental pressure.
- **Degradation** spreads via cascading effects and can trigger a permanent collapse.
- **Actions** — sending pigs away or calling an emergency feast — let you steer the
  system back from the edge.

The player has 90 seconds to score as many points as possible without collapsing
the ecosystem.

Authors
-------

- Malte Vogl
- Husain Quasim Ali Saif
- Jascha M. Schmitz

License
-------

MIT License — see :doc:`/api/index` or the ``LICENSE`` file in the repository.