Clashmate: a tool for Clash of Clans leaders to manage, tracking, and evaluate clan members.
Clashmate is a CLI Python program using the Clash of Clans (mobile game) developer API. The program is designed to identify actively participating and frequently contributing players in your clan, in order to assist the clan leader in choosing who deserves which clan roles.
Developed by Jayden Houghton, 2023
- Retrieves the clan member list
- Retrieves player data for each member in the clan
- Accepts manual data inputs for more accurate data.
- Calculates a ranking score for each player depending on their stats and clan contribution
- Outputs the players and their score in order of highest to lowest
- Download the most recent release from this repository.
- This program uses the Python requests module and will require it to be installed.
- Open the files in a code editor such as VS Code (with a Python extension) or PyCharm.
- Remove "example_" from the name of the config and player_data files.
- Generate a CoC API token from the developer page: https://developer.clashofclans.com/#/register and copy to the config file.
- (optional) Run the program and choose option 2, then add any manual data to player_data.txt. The default values are 0. The program can be run without this data, however these stat fields will not be taken into account during calculation so the overall ratings will not be as accurate to the player's actual contribution.
- Run the program and choose option 1 for clan evaluation.
- Update the manual data over time.
- The clan tag is hardcoded in the program. This is to avoid repetitively inputting the same tag every time the program is run for the clan you manage.
- If your computer uses a dynamic ip address, you will need to create a new CoC API token and update the config file every time it changes. Alternately, switch to a static ip address.
The purpose of the rating is to give a rough idea of how much a player contributes to the clan. The equation is designed to mainly emphasise participation, however greater scores are given for higher level and higher skilled players as this benefits the clan.
A high level and well contributing player should have a score of around 100. There is no max value, as stats such as donations have no limit.
Example Player Stats: