Skip to content
@ClashKingInc

ClashKing

A clash of clans project aiming to expand what is possible thru teamwork, hardwork, & awesome ideas

ClashKing

Open Source Free to use Major rewrite Patreon

Open-source tools for Clash of Clans players, clans, Discord communities, and developers.

Discord Server · Discord Bot · Android Beta · iOS Beta · Docs · API

An illustration showing clash characters partying


Project Status

ClashKing is currently in the middle of a major rewrite.

Large parts of the ecosystem are being rebuilt, modernized, and cleaned up across the bot, mobile app, dashboard, backend services, tracking infrastructure, Clash of Clans API tooling, and shared libraries.

During this transition, some repositories may move quickly, some features may be unstable or temporarily unavailable, APIs may change, and documentation may temporarily lag behind the latest work.

The goal is to make ClashKing faster, cleaner, easier to maintain, and better prepared for the future.

Thanks for sticking with us while we build the next generation of ClashKing.

Start Here

If you want to... Go here
Add ClashKing to your Discord server ClashKingBot
Download ClashKing on Android Google Play beta
Join the iOS beta TestFlight
Use ClashKing on mobile ClashKingApp
Configure ClashKing for your server ClashKingDashboard
Read the documentation ClashKing Docs
Explore the public API API docs
Explore the backend API repository ClashKingAPI
Work with tracking/backend infrastructure ClashKingTracking
Use Clash of Clans API wrappers clashy.go or clashy.py
Join the community Discord

What Is ClashKing?

ClashKing is an ecosystem of tools built around Clash of Clans.

It helps players, clan leaders, Discord communities, and developers manage clan activity, track player progress, follow wars and CWL, organize rosters, view statistics, automate server workflows, and build with Clash of Clans data.

The ecosystem includes a Discord bot, mobile app, dashboard, backend API, tracking services, API proxy, shared assets, database schemas, testing tools, and Clash of Clans API libraries.

The Team Behind ClashKing

ClashKing is built and maintained by a small team of developers, contributors, and community members who care about Clash of Clans tooling.

We work on ClashKing as a side project alongside our full-time jobs. The project exists because we enjoy building useful tools for players, clans, and communities.

The ecosystem is developed across multiple areas: Discord bot features, mobile app development, dashboard work, backend services, tracking infrastructure, API tooling, design, documentation, testing, and community support.

Because ClashKing is large and currently being rewritten, the team focuses on long-term maintainability, practical features, reliable data, and tools that are useful for real clans and communities.

Community feedback plays a big role in shaping ClashKing. Bug reports, feature ideas, testing, documentation improvements, and contributions all help move the project forward.

Main Projects

Repository Description
ClashKingBot Open-source Clash of Clans Discord bot for clan management, player lookup, war tools, stats, reminders, and server automation.
ClashKingApp Mobile companion app for ClashKing and Clash of Clans.
ClashKingDashboard Dashboard used to configure and manage ClashKing.
ClashKingAPI Backend API powering ClashKing services.
ClashKingDocs Documentation for ClashKing features, commands, and workflows.

Backend, Infrastructure, and Data

Repository Description
ClashKingTracking Backend infrastructure for ClashKing tracking systems.
ClashKingProxy High-performance proxy for the Clash of Clans API.
DatabaseSchemas Database schemas and migrations used across ClashKing services.
ClashTestingAPI Mock Clash of Clans API requests for testing.

Libraries and Developer Tools

Repository Description
clashy.go Go wrapper for the Clash of Clans API.
clashy.py Python Clash of Clans API wrapper, forked from coc.py.
ClashKingAssets Clash of Clans assets and extractor tooling.
ClahKingDesignSystem ClashKing design system resources.

Supporting Repositories

Repository Description
.github Organization profile and shared GitHub configuration.
Gists Random code snippets and experiments.
num2words Utility for converting numbers into words.

For Players

ClashKing helps players:

  • Track Clash of Clans accounts
  • View player and clan statistics
  • Follow wars and CWL
  • Bookmark players and clans
  • Access ClashKing-linked data through Discord and mobile
  • Keep clan and account information organized

For Clan Leaders and Communities

ClashKing helps clans, families, and Discord communities:

  • Manage members
  • Track wars, CWL, and clan activity
  • Organize rosters
  • Share clan information in Discord
  • Automate common server workflows
  • Improve visibility across multiple clans or community servers

For Developers

Developers can use the ClashKing ecosystem to explore how Clash of Clans data is collected, processed, displayed, proxied, tested, and exposed through apps, bots, APIs, and shared libraries.

Useful repositories and resources for developers:

Contributing

Contributions are welcome.

Depending on the repository, you can help by:

  • Fixing bugs
  • Improving documentation
  • Reporting issues
  • Suggesting features
  • Testing changes
  • Improving UI and UX
  • Working on backend, bot, dashboard, mobile, infrastructure, or library code

Before contributing, please check the README and contribution notes of the specific repository you want to work on.

We know that contributing can currently be difficult. Some parts of the ecosystem depend on several services, shared data, and production-only infrastructure. Because of financial constraints, we currently operate with a production-focused setup rather than a full set of sandbox environments.

As part of the rewrite, we plan to work on better contributor-friendly development environments, including sandbox setups where possible. The goal is to make it easier for contributors to test changes, understand the system, and help more concretely without needing direct access to production services.

Because ClashKing is currently being rewritten, it is a good idea to open an issue or join the Discord before starting large changes.

Support ClashKing

ClashKing is entirely free to use.

There are no ads, no paid features, and no premium-only tools. We want the bot, mobile app, API, and community tools to stay available to everyone.

If you want to support the project and help us pay for infrastructure, you can:

Every bit of support helps keep ClashKing running, free, and actively maintained.

Community

Join the ClashKing Discord for support, feedback, updates, development discussion, and community help.

Join the ClashKing Discord

Links

Disclaimer

ClashKing is an independent open-source project and is not affiliated with, endorsed, sponsored, or specifically approved by Supercell.

Clash of Clans and related assets are trademarks and copyrights of Supercell.


Built by the ClashKing team for the Clash of Clans community.

Pinned Loading

  1. ClashKingBot ClashKingBot Public

    An Open Source Clash Of Clans Discord Bot aiming to cover all possible features & do the heavy lifting so others don’t have to.

    Python 70 25

Repositories

Showing 10 of 15 repositories

Top languages

Loading…

Most used topics

Loading…