VGC-Analytics Dashboard

A zero-dependency local web application that automates 100% of post-tournament VGC metadata statistics from Limitless. It fetches standings, parses rosters, uploads team pastes, generates Top 8 graphics, analyzes metagame usage, compares tournament shifts, and tracks seasonal trends.

---

Key Features

• Zero-Dependency: Run immediately without installing any external libraries (pip install). Built entirely using Python's standard library.
• All-in-One Local Web GUI: Run all scripts, check output console logs in real-time, and manage generated reports from a premium dark-mode dashboard.
• Usage Statistics: Fetch and compile usage percentages of Pokémon, items, moves, abilities, tera types, and teammate frequency.
• Meta & Season Analyzer: Compare shifts between two tournaments or track long-term metagame trends across multiple tournaments (with support for mid-season format rule changes).
• Top 8 Graphics: Automatically generates ranking graphics for the Top 8 standings paired with auto-generated Showdown PokePastes.
• Cross-Platform Compatibility: Native UTF-8 support for macOS, Linux, and Windows consoles.

---

Getting Started

1. Requirements

• Python 3.x installed.

2. Run the Dashboard

Open your terminal in the project directory and run:

python3 src/app.py

The application will launch a local server at http://127.0.0.1:5000 and automatically open your default web browser.

---

File Structure

• src/: Core Python modules and web interface templates.
  • app.py: Simple HTTP web server router and server-sent event logger.
  • fetch_usage.py: Usage statistic analyzer.
  • compare_usage.py: Week-to-week metagame shift analyzer.
  • compare_season.py: Multi-tournament season trend analyzer.
  • generate_top8.py: Top 8 paste and graphic generator.
  • templates/: Dashboard Web UI templates.
• data/: Standard mapping dictionaries to normalize Pokémon/item names.
• results/: Output directories for generated HTML reports, JSON structures, and graphics.

---

Changelog

v2.0.3-beta (2026-09-13)

• Added: Full support for Pokémon Champions Regulation M-C, including Mega Z forms (Absol Mega Z, Garchomp Mega Z, Lucario Mega Z) and Baxcalibur Mega mapping, Mega Z item detection (Absolite Z, Garchompite Z, Lucarionite Z), and M-C format string parsing.

v2.0.2-beta (2026-07-03)

• Fixed: Solved Windows console UnicodeEncodeError when streaming Vietnamese stdout logs in the Web UI.

v2.0.1-beta (2026-07-02)

• Added: Introduced the Season Trend Analyzer (compare_season.py) and integrated it into the web sidebar.
• Added: Interactive timeline charts, matrix heatmaps, format shift comparison tables (Winners & Losers), and inline expandable item bar charts for each Pokémon.

v2.0.0-beta (2026-06-26)

• Added: Initial Release of the Local Web App Dashboard (src/app.py & src/templates/index.html).
• Changed: Transposed Top 12 summary table format to rows (Pokémon) and columns (metrics) for optimized horizontal layout.

v1.2.0 (2026-06-18)

• Added: Metagame comparison script (compare_usage.py).

v1.1.0 (2026-06-18)

• Added: Tournament usage script (fetch_usage.py) with support for private tournament keys.

v1.0.0 (2026-06-04)

• Added: Original CLI Top 8 standings and graphic generator.

---

Credits

• Built using public APIs of Limitless TCG.
• Ranking graphics powered by João Costa's VGC Standings Generator API.