Logs

A detailed explanation of all Logs

Logs are automatic messages posted by ClashPerk.

You can enable them per clan. You can send each log to its own channel or thread.

Set up logs

Run /setup clan-logs clan: #CLAN_TAG channel: #channel

Logs are not truly real-time. ClashPerk polls the official API, so short delays can happen.

How does ClashPerk track game data?

---

Clan Logs

Clan Achievements Log

Posts when the clan reaches a milestone.

• Clan level up, War League promotion/demotion, Capital League promotion/demotion, Capital Hall level up.

Donation Log

Tracks troop donations.

Instant

Posts whenever someone donates or receives troops.

Daily

Weekly

Monthly

Clan Games Embed Log

Posts a Clan Games leaderboard message. It updates itself throughout the event.

• Shows points, average, and tier progress.

Last Seen Embed Log

Posts one message and keeps it updated. Updates run approximately every 30 minutes.

• Shows estimated activity / last-seen status.

• Uses signals like donations, trophy changes, clan games, capital activity, etc.

See How does last seen work?.

Legend Attacks Daily Summary Log

Posts a daily legend league recap.

• Shows offense gained, defense lost, and final placement.

Data can be off when offense and defense happen between two API polls.

---

Capital Logs

Clan Capital Weekly Summary Log

Posts after the raid weekend ends.

• Shows total raid loot and capital gold contribution.

• Includes a graphic similar to the in-game summary.

Capital Gold Contribution Log

Posts each time a member contributes capital gold.

Capital Gold Raid Log

Posts each time a member completes a capital raid attack.

---

War Logs

War Attack Log

Posts a message for every attack made during a Clan War.

CWL Attack Log

Posts a message for every attack made during CWL.

War Embed Log

Posts one embed per war and updates it during the war.

• Shows recent attacks, war state, war size, and key stats.

• Includes a Town Hall breakdown.

War Missed Attacks Log

Posts a list of players who missed attacks.

• Splits players by 1 missed vs 2 missed.

CWL Embed Log

Posts one embed per CWL round and updates it.

CWL Missed Attacks Log

Posts a list of players who missed their CWL attacks.

CWL Lineup Change Log

Logs lineup changes as they happen.

• Shows who was added and who was removed.

CWL Monthly Summary Log

Posts a graphic summarizing the CWL season placements.

---

Player Logs

Member Join/Leave Log

Tracks members joining and leaving your clan.

• On join: Town Hall, trophies, hero levels, war stars, rushed %, join source, member count, time.

• On leave: Town Hall, trophies, donations at leave, and join source (if known).

Role Change Log

Tracks in-game promotions and demotions.

• Shows who changed role, the old/new role, and when.

Name Change Log

Posts when a member changes their in-game name.

Town Hall Upgrade Log

Posts when a member upgrades their Town Hall.

• Also shows the % of troop upgrades remaining.

• Optional: ping a role via ping_role.

War Preference Log

Posts when a member changes war preference.

• Shows opt-in vs opt-out.

Ranked Battle League Change Log

Posts when a member's Builder Base league changes.

• Shows the old and new league.