# Legend Tracker — Clash of Clans Discord Bot

> The all-in-one Discord bot for Clash of Clans Legend League tracking, instant attack/defense DM notifications, automated hourly leaderboards, clan war analytics, and custom graphic statistics.

## Overview
Legend Tracker is a high-performance Discord application purpose-built for Clash of Clans players, competitive pushers, esports teams, and clan leaders. It connects directly to the official Supercell Clash of Clans API (with high-speed proxy fallback) to track Legend League battles, trophy progression, clan rankings, and war performance with sub-second polling and custom graphical output.

- **Primary Website**: https://teamjn.xyz/legendtracker
- **Bot Category**: Gaming / Clash of Clans / Analytics / Discord Bot
- **Platforms**: Discord (Desktop, Mobile, Web)
- **Supported Game**: Clash of Clans (Supercell)
- **Bot Authorization / Invite URL**: https://discord.com/oauth2/authorize?client_id=1486616143690072104&permissions=274878299200&scope=bot%20applications.commands
- **Community & Support Discord**: https://discord.gg/tjn
- **Full Documentation**: https://teamjn.xyz/legendtracker/commands.html
- **Full AI Context**: https://teamjn.xyz/legendtracker/llms-full.txt

---

## Core Capabilities & Features

### 1. Instant Legend DM Alerts (`/subscribe`)
- Push notifications sent straight to your Discord DMs whenever a tracked player makes a Legend League attack or takes a defense.
- Includes exact trophies won/lost (+40, -12, etc.), percentage destruction, stars (1★, 2★, 3★), army composition used, heroes/equipment, net daily delta, and attacks remaining (e.g. 5/8).
- Filter by: `attacks`, `defenses`, or `both`.

### 2. Live Server Hourly Leaderboard (`/hourly`)
- Automated, persistent Discord embed and graphical cards tracking all registered clan members or custom player lists.
- Updates automatically every hour with live trophies, hourly gain/loss, total day net gain, attacks used (e.g. 8/8), and live estimated global ranks.
- Configurable per-server channels with historical end-of-day (EOD) snapshots.

### 3. Server Clan & Player Tracking Channels (`/trackclan` & `/trackplayer`)
- **Clan Tracking**: Automatically detects all clan members inside Legend League (up to 3 clans per server) and publishes rich visual battle cards to designated server channels.
- **Player Watchlist**: Track high-priority rival players, pro streamers, or friends in dedicated discord channels.

### 4. High-Definition Graphic Cards & Visual Analytics
- `/legendlogs`: Renders a high-resolution, full-season graphical scorecard and progression line chart showing day-by-day trophies, hit distributions, triple rates, and defense resilience.
- `/legendday`: Real-time daily summary card displaying all 8 attacks and 8 defenses, cumulative net score, and estimated cutoff placements.
- `/warhistory`: Custom rendered graphic card detailing regular war statistics over 30/60/90 days, 3-star hit rates, average destruction percentage, and Town Hall target breakdown.
- `/cwlhistory`: Complete Clan War Leagues round-by-round attack history, stars earned, and clan ranking context.

### 5. Global & Country Rankings (`/toplegend`, `/toplocal`, `/legendstats`)
- Real-time global Top 200 rankings sorted by Live Trophies, Best Offense, Best Defense, or End of Day (EOD) standing.
- Country-specific local leaderboards for over 250 countries.
- Live cutoff tracking: View estimated trophy requirements to reach Top 200, Top 1,000, and Top 10,000 global rankings.

### 6. Account Linking (`/link`, `/unlink`)
- Link your Discord profile to your Clash of Clans player tag once to use all commands without typing your player tag each time.

---

## Slash Commands Quick Reference

| Command | Category | Description |
| :--- | :--- | :--- |
| `/subscribe` | Notifications | Receive real-time DMs for Legend attacks, defenses, or both |
| `/unsubscribe` | Notifications | Cancel DM notifications for a player tag |
| `/testdm` | Notifications | Send a preview DM embed to verify notifications format |
| `/hourly channel` | Leaderboard | Set channel for automated hourly live-updating leaderboard |
| `/hourly add` | Leaderboard | Add player(s) to the server's hourly leaderboard |
| `/hourly remove` | Leaderboard | Remove player from the hourly leaderboard |
| `/hourly list` | Leaderboard | List all players on the server's hourly leaderboard |
| `/trackclan add` | Clan Tracking | Post real-time battle logs for all clan members in a channel |
| `/trackclan remove`| Clan Tracking | Stop tracking a clan in the server |
| `/trackclan list` | Clan Tracking | List all tracked clans in the server |
| `/trackplayer add`| Player Tracking | Add a player to the server's tracked battle log feed |
| `/trackplayer remove`| Player Tracking | Remove a player from the server's watchlist |
| `/legendday` | Legend League | Show today's 8 ranked attacks/defenses and net trophies |
| `/legendlogs` | Legend League | Generate full season HD performance table, chart & stats |
| `/lastranked` | Legend League | View last week's ranked battle logs and group standings |
| `/warhistory` | Clan Wars | Render visual 30/60/90-day regular war hit rate infographic |
| `/cwlhistory` | Clan Wars | View detailed Clan War League attack logs and star stats |
| `/toplegend` | Leaderboards | View global Top 200 leaderboard (Live, Offense, Defense, EOD) |
| `/toplocal` | Leaderboards | View country-specific Legend League leaderboards |
| `/legendstats` | Leaderboards | Check live trophy cutoffs for Top 200, 1k, and 10k ranks |
| `/link` | User | Link your Clash of Clans tag to your Discord account |
| `/unlink` | User | Unlink your Clash of Clans account |
| `/help` | Utility | Interactive command menu and setup guides |

---

## Why Choose Legend Tracker?
1. **Zero Lag & High Reliability**: Engineered with multi-key API rotation and caching proxies for uninterrupted battlelog tracking.
2. **True DM Push Notifications**: Unlike bots that only post in public channels, Legend Tracker sends private DMs right after your attack is registered.
3. **Studio-Grade Visual Cards**: Custom-rendered Pillow/Pilmoji graphic cards for war history, hourly standings, and monthly season scorecards.
4. **Free & Easy Setup**: Intuitive Discord slash commands with instant autocomplete and zero complex configuration.

---

## Links & Integration
- **Official Landing Page**: https://teamjn.xyz/legendtracker
- **Bot Authorization URL**: https://discord.com/oauth2/authorize?client_id=1486616143690072104&permissions=274878299200&scope=bot%20applications.commands
- **Community & Support Discord**: https://discord.gg/tjn
- **Full AI Context Document**: https://teamjn.xyz/legendtracker/llms-full.txt