# Legend Tracker — Clash of Clans Discord Bot

> The all-in-one Discord bot for Clash of Clans Ranked & Legend League tracking, instant attack/defense DM notifications, automated hourly leaderboards, Clan War & CWL analytics, base layout sharing, 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 Ranked League battles (Dragon, Electro, and Legend / D28–L36), Clan Wars, CWL, base layouts, and army sharing with real-time push alerts and custom graphical output.

- **Primary Website**: https://legendtracker.xyz
- **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/exXBvZWYhw
- **Full Documentation**: https://legendtracker.xyz/commands
- **Full AI Context**: https://legendtracker.xyz/llms-full.txt

---

## Core Capabilities & Features

### 1. Instant Ranked Battle DM Alerts (`/subscribe`)
- Push notifications sent straight to your Discord DMs whenever a tracked player makes a Ranked attack or takes a defense hit.
- Covers Dragon Leagues (D28–D30), Electro Leagues (E31–E33), and Legend Leagues (L34–L36).
- 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: `attack`, `defense`, or `both`.

### 2. Live Server Hourly Leaderboard (`/hourly`)
- Automated, persistent Discord embed tracking all registered clan members or custom player lists (up to 40 players per server).
- 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.
- Interactive player selector dropdowns to instantly view any member's detailed Legend Day poster.

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

### 4. Base Layout Sharing & Auto-Detection Channels (`/basepost`, `/setbasechannel`)
- **Base Layout Posts (`/basepost`)**: Share Town Hall base layouts (TH9 to TH17) with Town Hall badges, base type tags (War, Trophy, CWL, Farming), screenshot attachments, direct in-game copy links, and community voting reactions.
- **Base Auto-Detection (`/setbasechannel`)**: Configure server channels to automatically detect pasted Clash of Clans base links and images, transforming them into rich interactive base layout cards.

### 5. Army Compositions & Auto-Detection Channels (`/army`, `/setarmychannel`)
- **Army Composition Parser (`/army`)**: Parses Clash of Clans army share links to display complete troop counts, spells, heroes, and Hero Equipment (Spiky Ball, Giant Gauntlet, Fireball) with a 1-click in-game import button.
- **Army Channels (`/setarmychannel`)**: Automatically converts any army links pasted in designated channels into rich embed breakdowns.

### 6. High-Definition Graphic Cards & Visual Analytics
- `/legendlogs`: Renders a high-resolution, full-season graphical scorecard and 30-day 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.
- `/lastranked`: Generates Clash-style graphic cards showing weekly battle log grids and tournament group standings.
- `/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.

### 7. Global & Country Rankings (`/toplegend-players`, `/toplegend-clans`, `/legendstats`)
- Real-time global Top 200 rankings sorted by Live Trophies, Best Offense, Best Defense, or End of Day (EOD) 5:00 AM UTC 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.
- Historical season browsing: Browse Top 1,000 rankings for any past season (`/toplegend-season`).

### 8. Account Linking & Multi-Profile Tools (`/link`, `/sendlink`)
- Link your Discord profile to your Clash of Clans player tag (`/link`) to use all commands without typing your tag each time.
- Share clickable in-game profile links for up to 10 players or clans simultaneously (`/sendlink`).

---

## Slash Commands Quick Reference

| Command | Category | Description |
| :--- | :--- | :--- |
| `/subscribe` | Notifications | Receive real-time DMs for ranked 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 Feeds | Stream real-time ranked battles for all clan members into a channel |
| `/trackclan remove`| Clan Feeds | Stop tracking a clan in the server |
| `/trackclan list` | Clan Feeds | List all tracked clans in the server |
| `/trackplayer add`| Player Feeds | Add an individual player to a tracked channel battle feed |
| `/trackplayer remove`| Player Feeds | Stop tracking an individual player in a channel |
| `/trackplayer list`| Player Feeds | List all individual players tracked for the server |
| `/basepost` | Base Layouts | Post base layout card with in-game link, image, and voting |
| `/baseedit` | Base Layouts | Edit an existing base layout post |
| `/basevote` | Base Layouts | Set automatic voting reactions preference for /basepost |
| `/setbasechannel` | Base Layouts | Add channel for auto-converting base links into cards |
| `/army` | Army Sharing | Display army composition, troops, spells, equipment & copy link |
| `/setarmychannel` | Army Sharing | Add channel for auto-converting army links into embeds |
| `/legendday` | Ranked Stats | Show today's 8 ranked hits, stars, %, and net trophies |
| `/lastranked` | Ranked Stats | High-res Clash graphic card showing weekly battle grid |
| `/legendlogs` | Ranked Stats | Generate 30-day graphical scorecard and progression line chart |
| `/legendhistory` | Ranked Stats | Show past Legend season history, final ranks, and trophies |
| `/warhistory` | Clan Wars | Render visual 30/60/90-day regular war hit rate infographic |
| `/cwlhistory` | CWL | Show recent CWL round-by-round hits and star performance |
| `/sendlink` | Utilities | Share in-game profile links for up to 10 clans or players |
| `/toplegend-players`| Leaderboards | View global Top 200 players leaderboard (Live or EOD) |
| `/toplegend-clans` | Leaderboards | View global Top 200 clans leaderboard (Live or EOD) |
| `/toplegend-today` | Leaderboards | View today's highest offense and best defense players |
| `/toplegend-stats` | Leaderboards | View season Top 50 paginated statistics |
| `/toplegend-local` | Leaderboards | View country-specific ranked leaderboards |
| `/toplegend-season`| Leaderboards | Browse Top 1,000 players for any past season |
| `/legendstats` | Leaderboards | View live trophy cutoffs for Top 200, 1000, 10000 |
| `/link` | Account | Link your Clash of Clans tag to your Discord profile |
| `/unlink` | Account | Unlink your Clash of Clans account |
| `/help` | Utilities | Interactive command menu and setup guides |

---

## Why Choose Legend Tracker?
1. **Multi-League & War Coverage**: Tracks Dragon (D28–D30), Electro (E31–E33), and Legend (L34–L36) ranked tiers, plus regular Clan Wars and CWL.
2. **True DM Push Notifications**: Instant private DM alerts the moment your attack or defense is completed.
3. **Automated Server Channels**: Stream clan battles, individual player hits, and live hourly leaderboards without manual updates.
4. **Base & Army Automation**: Seamless auto-detection and 1-click in-game import links for base designs and army compositions.
5. **Studio-Grade Visual Cards**: Custom-rendered Pillow/Pilmoji graphic cards for war history, hourly standings, and monthly season scorecards.

---

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