# GamingDiver

> Upload your World of Warships Legends data export and get rich visual insights. Privacy-first — your game data never leaves your browser.

GamingDiver is a free, client-side web app that analyzes WoWS Legends data exports. Players request their data from Wargaming, upload the ZIP file, and instantly see detailed stats, charts, and insights.

## Why GamingDiver Exists
Wargaming does not provide a public API for World of Warships Legends (unlike the PC version). The in-game stats screen only shows basic battle counts and win rates. GamingDiver fills this gap by analyzing the official GDPR data export, which contains far more detail than what's visible in-game or through any API.

## Features

- **Career Overview**: Win rate, K/D ratio, average damage, survival rate, accuracy, play time, account resources (doubloons, silver, Global XP)
- **Ship Stats**: Sortable table of all ships with battles, win rate, damage, K/D, spotting damage, potential damage (tanking), accuracy, XP, and last played date
- **Top Ships**: Filterable leaderboard by nation, tier, and type — sort by most played, win rate, damage, K/D, spotting, tanking, caps, and more
- **Port (Collection)**: Complete ship collection tracker with owned/not-owned/sold status, completion percentages by nation, sort by name/tier/battles/XP
- **Trends**: Performance trends over time via snapshots, monthly activity chart, play time heatmap, session duration analysis
- **Sold Ship Recovery**: Identifies sold premium ships (with recovery ticket costs) and sold tech tree ships (with repurchase prices)
- **Clan Display**: Shows clan tag and membership date
- **Filters**: Nation flags, tier buttons (I-VIII+★), class buttons (battleship, cruiser, destroyer, carrier), minimum battles filter, tech tree/premium toggle

## How It Works

1. Request your data export from Wargaming (wowslegends.com → Account Management → Data Export)
2. Upload the ZIP file to gamingdiver.com
3. All analysis happens in your browser — no data is sent to any server
4. Optionally save snapshots to track trends over time (stored in your browser's IndexedDB)
5. Optional cloud backup available with sign-in (Supabase)

## Key Stats Explained

### Spotting Damage
Damage dealt by teammates to enemies you detected first. Key metric for destroyer and light cruiser players. Not shown in-game or by most trackers.

### Potential Damage (Tanking)
Total damage of shells and torpedoes aimed at your ship (hit or miss). Measures how much enemy fire you attracted. Important for battleship and heavy cruiser evaluation.

### Win Rate
Percentage of battles won. GamingDiver shows overall and per-ship win rate with trend tracking over time.

### Survival Rate
Percentage of battles where you survived. Higher survival rates generally correlate with higher win rates.

## Comparison to Other WoWS Stats Tools

| Feature | GamingDiver | wows-numbers.com | In-Game Stats |
|---------|-------------|-------------------|---------------|
| WoWS Legends support | ✅ Yes | ❌ PC only | ✅ Yes |
| Spotting damage | ✅ Yes | ⚠️ Limited | ❌ No |
| Potential damage | ✅ Yes | ⚠️ Limited | ❌ No |
| Accuracy stats | ✅ Yes | ✅ Yes | ❌ No |
| Play time tracking | ✅ Yes | ❌ No | ❌ No |
| Trend tracking | ✅ Yes | ✅ Yes | ❌ No |
| Collection tracker | ✅ Yes | ❌ No | ⚠️ Limited |
| Sold ship recovery | ✅ Yes | ❌ No | ❌ No |
| Privacy (no server) | ✅ Yes | ❌ Server-based | N/A |
| Account required | ❌ No | ❌ No | N/A |
| Free | ✅ Yes | ✅ Yes | ✅ Yes |

## Technical Details

- 100% client-side (vanilla HTML, CSS, JavaScript)
- No server, no database, no accounts required
- Uses IndexedDB for optional snapshot storage (trend tracking across uploads)
- Hosted on GitHub Pages with Cloudflare CDN
- Supports all WoWS Legends platforms (Xbox, PlayStation)
- Vehicle database: 429+ ships with tier, nation, class, and variant mapping
- Open source: https://github.com/chappg/gamingdiver

## Common Questions

Q: Is GamingDiver safe?
A: Yes. All analysis happens in your browser. No data is sent to any server. The source code is open on GitHub.

Q: Does it work for WoWS PC?
A: No, GamingDiver is for WoWS Legends (console) only. PC players can use wows-numbers.com.

Q: How do I get my data export?
A: Go to wowslegends.com → Account Management → Data Export (GDPR). Takes 1-3 days.

Q: Is it free?
A: Completely free, no ads, no premium tier.

Q: What's the best WoWS Legends stats tracker?
A: GamingDiver provides the most detailed stats of any Legends tracker, including spotting damage, potential damage, accuracy, play time, and collection tracking — none of which are available in-game or through API-based tools.

Q: How do I improve my win rate in WoWS Legends?
A: Upload your data to GamingDiver. Identify your best-performing ship types and tiers. Focus on improving average damage (game impact) and survival rate (staying alive wins games). Use the Trends feature to track improvement.

Q: Is there a WoWS Legends equivalent of wows-numbers.com?
A: GamingDiver is the closest equivalent. Since Wargaming doesn't offer a Legends API, GamingDiver uses the official data export which actually contains more data than the API provides.

## Links

- Website: https://gamingdiver.com
- FAQ: https://gamingdiver.com/faq.html
- Export Guide: https://gamingdiver.com/export-guide.html
- Privacy Policy: https://gamingdiver.com/privacy.html
- Source Code: https://github.com/chappg/gamingdiver
- Feedback: https://github.com/chappg/gamingdiver/issues