{"id":31955932,"url":"https://github.com/radicazz/clashbot","last_synced_at":"2026-04-20T04:03:31.797Z","repository":{"id":286217047,"uuid":"960749958","full_name":"radicazz/clashbot","owner":"radicazz","description":"Clash of Clans Discord bot for tracking activity.","archived":false,"fork":false,"pushed_at":"2025-08-23T03:31:51.000Z","size":80,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-24T12:56:31.056Z","etag":null,"topics":["bot","clashofclans","coc","discord","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/radicazz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-05T01:49:23.000Z","updated_at":"2025-08-23T03:31:55.000Z","dependencies_parsed_at":"2025-08-05T20:22:19.494Z","dependency_job_id":"7aaa0c73-ecf9-4d55-856d-1838b34b43f4","html_url":"https://github.com/radicazz/clashbot","commit_stats":null,"previous_names":["vortexshrimp/skebenga","vortexshrimp/clashbot","radicazz/clashbot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/radicazz/clashbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radicazz%2Fclashbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radicazz%2Fclashbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radicazz%2Fclashbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radicazz%2Fclashbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/radicazz","download_url":"https://codeload.github.com/radicazz/clashbot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radicazz%2Fclashbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019157,"owners_count":26086682,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","clashofclans","coc","discord","python"],"created_at":"2025-10-14T14:43:11.875Z","updated_at":"2025-10-14T14:43:13.223Z","avatar_url":"https://github.com/radicazz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ClashBot\n\nA Discord bot for tracking Clash of Clans activity on a server.\n\n## Features\n\n- Tracks clan events such as member joins \u0026 leaves, description \u0026 badge changes and much more.\n- Tracks war events such as preparation starts, wins \u0026 losses and starts \u0026 ends.\n- Tracks clan member donations and their amounts.\n- Useful commands for getting info about other clans, players, and wars with `!clan`, `!player` \u0026 `!war`.\n- Moderation commands that require administrator, such as `!kick`, `!ban` and more.\n\n\u003e Note: This bot currently only supports one server at a time.\n\n## Requirements\n\n### APIs\n\nThis bot requires access to the Discord \u0026 Clash of Clans APIs, both of which require accounts.\n\n- Create a [Clash of Clans](https://developer.clashofclans.com/#/getting-started) developer account to access the API.\n- Create a bot from the [Discord Developer Portal](https://discord.com/developers) and add it to your server.\n\n### Environment\n\nThis project uses `poetry` to easily manage its dependencies and environment. It is recommended to install `pipx` for managing `poetry`.\n\n1. Install [python](https://www.python.org/downloads/). `version 3.13+`\n2. Install [pipx](https://pipx.pypa.io/latest/installation/).\n\n   - `$ python -m pip install --user pipx`\n   - `$ python -m pipx ensurepath`\n\n3. Install [poetry](https://python-poetry.org/) with `pipx`.\n\n   - `$ pipx install poetry`\n\n### Configuration\n\nSensitive data, such as API tokens and webhook urls, is stored in a `.env` file in the project's root directory.\n\n```dotenv\n# Standard Discord bot application token.\n# Find this in the Discord Developer portal after creating your bot.\nDISCORD_TOKEN = \"App token\"\n\n# For listening to clan events and posting them, this bot uses webhooks.\n# Create a text channel in your server, then go to 'integrations' and add a webhook.\n# If you want all the events in the same channel, use the same URL for each token.\nDISCORD_CLAN_WEBHOOK = \"Webhook URL\"\nDISCORD_WAR_WEBHOOK = \"Webhook URL\"\nDISCORD_DONATIONS_WEBHOOK = \"Webhook URL\"\nDISCORD_GENERAL_WEBHOOK = \"Webhook URL\"\n\n# Clash of Clans information.\n# You will need to create a fre account on their developer portal.\nCOC_EMAIL = \"Your email\"\nCOC_PASSWORD = \"Your password\"\n\n# The tag of the main clan that you wish to track.\nCOC_CLAN_TAG = \"Your tag\"\n```\n\n## Usage\n\n1. Setup your [API](#apis) accounts.\n2. Configure the [environment](#environment).\n3. Clone this repo through `git` or download it directly.\n   - `$ git clone https://github.com/radicazz/skebenga.git`\n4. Install the dependencies with `poetry`.\n   - `$ poetry install`\n5. [Configure](#configuration) the bot with a `.env` file.\n6. Run the bot.\n   - `$ poetry run python skebenga/main.py`\n\n\u003e On Windows you can use `$ .\\run.bat` to easily run the bot once dependencies have been installed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradicazz%2Fclashbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fradicazz%2Fclashbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradicazz%2Fclashbot/lists"}