clangen

On AI & LLMs

[!WARNING]

Issues and Pull Requests created with AI based tools are going to be closed without further comment.

Repeat offenders will be blocked from this project until further notice.

Discord Server || Official website || Itch.io Page

Description

Fan-edit of the warrior cat clangen game built using Python and Pygame.

Credits

Original creator: just-some-cat.tumblr.com

Fan-edit creator: SableSteel, and many others

Downloads

Stable

Stable versions can be downloaded directly from the official ClanGen website

Development

Note: Development versions are automatic snapshots of current development efforts. They are _not_ stable, can crash and even corrupt your save files. Additionally, we do not provide tech support for development versions.

Download at your own risk here: ClanGen development download

Running from source

[!WARNING]

Running the game via poetry is no longer supported. Please use uv instead.

ClanGen uses uv to manage virtual environments. Therefore it is required to install the dependencies and run the game from source without manual tweaking.

Installing python

[!NOTE]

You no longer need to install Python on your system. uv will automatically install the correct version for you.

Installing uv

Follow the instructions for installing uv from the official website: https://docs.astral.sh/uv/getting-started/installation/

Linux, macOS, WSL

Open a terminal and paste this:

curl -LsSf https://astral.sh/uv/install.sh | sh

Then restart your terminal and check if uv is installed by running uv --version

Windows (Powershell)

Open a PowerShell window (Windows key and then enter PowerShell) and paste this:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Then restart your terminal and check if uv is installed by running uv --version

Running the game via the helper scripts

Linux, macOS

Double click the run.sh script or open it in the terminal via ./run.sh with the current working directory set to the game's root directory.

Windows

Double click the run.bat script.

Running the game via Visual Studio Code

[!NOTE]

uv automatically creates the .venv folder in the root directory of the game, unlike poetry.

First, you need to let uv install the dependencies. To do so, run the following command in the terminal:

uv sync

After that, ensure that you have the Python extension installed in Visual Studio Code. You can install it from the Extensions tab on the left sidebar. (or click here)

Then, open the Command Palette (Ctrl+Shift+P) and search for Python: Select Interpreter. Select the virtual environment created by uv (it should mention a .venv somewhere).

Finally, open the main.py file and click the play button in the top right corner to run the game.

Bug Reporting

We have migrated to GitHub Issues for bug reporting and tracking. We no longer review bug reports from the retired Google Form.

Contributing

If you'd like to contribute to Clangen, please read our Contributing guide.

ClanGenOfficial/clangen: Warrior Cats fan game