cerbottana is a Pokémon Showdown bot, originally developed for the room Italiano.
These instructions assume you are in the root directory of a cloned cerbottana repository. If you use Windows, it is strongly advised to work within the WSL.
If you are going to test your bot locally, you will also need an active instance of a Pokémon Showdown server.
This project uses uv to manage its dependencies, so you will need to install that as well.
Copy .env-example into .env and edit the file accordingly. Optional environment variables are commented out.
If you are running a local Pokémon Showdown instance, make sure it is active. Then, to start cerbottana, run:
uv run cerbottana
To stop the execution just raise a SIGINT (Ctrl + C) in the console.
Before submitting a pull request, please make sure that make passes without errors.
The bulk of cerbottana code is plugins (see plugins reference). Working on a simple plugin is a good first contribution.