
Open-source tools for Clash of Clans players, clans, Discord communities, and developers.
Discord Server · Discord Bot · Android Beta · iOS Beta · Docs · API
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.
| 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 |
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.
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.
| 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. |
| 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. |
| 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. |
| Repository | Description |
|---|---|
| .github | Organization profile and shared GitHub configuration. |
| Gists | Random code snippets and experiments. |
| num2words | Utility for converting numbers into words. |
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
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
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:
- API docs
- ClashKing Docs
- ClashKingAPI
- ClashKingTracking
- ClashKingProxy
- DatabaseSchemas
- ClashTestingAPI
- clashy.go
- clashy.py
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.
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:
- Use creator code
ClashKingin the Supercell shop: Support Creator - Subscribe through our Discord community: Join Discord
- Support us on Patreon: patreon.com/clashking
Every bit of support helps keep ClashKing running, free, and actively maintained.
Join the ClashKing Discord for support, feedback, updates, development discussion, and community help.
- GitHub Organization: https://github.com/ClashKingInc
- Website: https://clashk.ing/
- Documentation: https://docs.clashk.ing/
- API Docs: https://api.clashk.ing/docs
- Android Beta: https://play.google.com/apps/testing/com.clashking.clashkingapp
- iOS Beta: https://testflight.apple.com/join/6Q8dfnMX
- Discord: https://discord.gg/clashking
- Bot: https://github.com/ClashKingInc/ClashKingBot
- Mobile App: https://github.com/ClashKingInc/ClashKingApp
- Dashboard: https://github.com/ClashKingInc/ClashKingDashboard
- API Repository: https://github.com/ClashKingInc/ClashKingAPI
- Tracking: https://github.com/ClashKingInc/ClashKingTracking
- Proxy: https://github.com/ClashKingInc/ClashKingProxy
- Docs Repository: https://github.com/ClashKingInc/ClashKingDocs
- Patreon: https://www.patreon.com/clashking
- Supercell Creator Code: https://link.clashofclans.com/en?action=SupportCreator&id=Clashking
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.
