| description | icon |
|---|---|
Frequently Asked Questions |
circle-info |
Yes, we always support Fair Play. ClashPerk collects all the data directly from Supercell API.
Make sure that ClashPerk has all the required permissions in your Discord. Run the /debug command to check missing permissions and other issues.
To prevent abuse, the bot verifies that you're a leader or co-leader of the clan. This ensures you're not tracking clans you don't own or adding the same clan to multiple servers.
Due to API limitations, the bot can't directly see who is online or recently active. Instead, we estimate a player's last-seen time based on the following activities. These give us a rough idea of when someone was last active in the clan.
- Player name changed
- Troops donated
- Trophies gained in the Legend league
- Versus trophies gained
- Switch clans (leave the current clan and join another)
- Multiplayer attacks won
- War preference changed
- Clan capital gold contributed or looted
- Clan games points scored
- Obstacle removed
- Resources (gold/elixir/dark) looted
- Super Troops boosted
- Goblin stars earned
- Attacked in war (CWL/Regular/Friendly)
- Artilleries, Monolith, Walls, Builder huts, Inferno towers, Mortars, Xbows, Spell towers, and Scattershots destroyed
Whenever the bot captures an activity (mentioned above), the player gets a +1 score. This score reflects the total number of activities the bot has seen for that player, helping us determine who are the most active or inactive members.
Clan Games points can't be directly pulled from the API. Instead, we track the Games Champion achievement. At the start of Clan Games, we capture each player's progress and then compare it every 10-15 minutes. The difference shows how many points they've earned during the event, and this updates the scoreboard.
Once a player hits 2 billion in looted Gold or Elixir, the API stops increasing the count. This is an API limitation that affects players who reach this cap.
Yes, your API token cannot be used to steal your account or gain access to any account-related data. It only verifies your identity with third-party services. The token resets periodically and becomes invalid after each use.
ClashPerk tracks game data using the official Clash of Clans API, which does not provide real-time events. The only way to observe changes is by polling the API at safe intervals.
Polling simply means checking the API from time to time to see what the current data looks like, instead of being notified instantly when something changes.
Why this can’t be real-time
- The official API has rate limits and no push/webhook system, so continuous tracking isn’t possible.
- ClashPerk tracks a large number of clans and players, and completing a full polling cycle takes time.
- Some in-game updates take time to appear in the API itself.
Examples
- Trophy changes: A player gains trophies from an attack and loses them in a defense before the next poll. Only the final value is visible, so the intermediate change isn’t recorded.
- War attacks: A war attack happens shortly after a poll and only appears on the next API check, making it seem delayed.
- Clan join/leave: A player leaves a clan and rejoins before the next poll. Since the state briefly changed and reverted, ClashPerk may never observe the leave.
These limitations apply to almost all tracked data. ClashPerk records snapshots based on what the API exposes, so short delays or missed short-lived changes are unavoidable.