How huydamm/pokemonvgc-calculator works
Pokémon Damage Calculator supports manual Gen 9 OU, VGC, and Champions matchup analysis, plus a Showdown live-battle overlay. The main workflow is to import a team or choose Pokémon, resolve a format and opponent set, edit battle conditions, then calculate and inspect move damage and bulk. The service layer wraps shared dex data, format/set lookup, and the damage engine. The README documents major capabilities not fully visible in the excerpts; live-overlay internals are only partly sampled, so its deeper runtime links are limited.
Main entry points: App.tsx App orchestration · content.ts Overlay controller · sets.ts Opponent sets · results.ts Move results
Components 25
Calculator app
- App entry
src/main.tsx - App orchestration
src/App.tsx
Matchup services
- Team parsing
src/services/team.ts - Format discovery
src/services/formats.ts - Opponent sets
src/services/sets.ts - Shared dex
src/services/data.ts - Battle conditions
src/services/conditions.ts - Damage engine
src/services/calc.ts - Champions rules
src/services/champions-mechanics.ts - Move results
src/services/results.ts - Saved teams
src/services/team-box.ts - Cloud teams
src/services/cloud-box.ts - Account service
src/services/account.ts
Calculator views
- Matchup views
src/components/Results.tsx - Opponent editor
src/components/OpponentEditor.tsx - Field editor
src/components/ConditionsPanel.tsx - Bulk heatmap
src/components/Heatmap.tsx - Team box view
src/components/TeamBox.tsx
Live overlay
- Board reader
extension/inject.ts - Overlay controller
extension/content.ts - Overlay panel
extension/panel.ts
Other components
- Player
- Showdown battle
- Usage data
- Format data
Connections 36
- Player → App entry: opens
- App entry → App orchestration: renders
src/main.tsx - App orchestration → Team parsing: parses teams
src/App.tsx - App orchestration → Format discovery: resolves format
src/App.tsx - App orchestration → Opponent sets: loads opponent
src/App.tsx - App orchestration → Opponent editor: renders editor
src/App.tsx - App orchestration → Matchup views: renders results
src/App.tsx - App orchestration → Field editor: renders field
src/App.tsx - App orchestration → Team box view: renders team
src/App.tsx - Team parsing → Shared dex: reads dex
src/services/team.ts - Opponent sets → Shared dex: reads dex
src/services/sets.ts - Opponent sets → Format discovery: uses format
src/services/sets.ts - Format discovery → Format data: probes sources
src/services/formats.ts - Opponent sets → Usage data: fetches usage
src/services/sets.ts - Field editor → Battle conditions: edits conditions
src/components/ConditionsPanel.tsx - Matchup views → Move results: shows results
src/components/Results.tsx - Move results → Damage engine: runs damage
src/services/results.ts - Move results → Team parsing: builds Pokémon
src/services/results.ts - Move results → Battle conditions: uses conditions
src/services/results.ts - Damage engine → Shared dex: uses generation
src/services/calc.ts - Damage engine → Champions rules: applies rules
src/services/calc.ts - Matchup views → Bulk heatmap: offers heatmap
src/components/Results.tsx - Bulk heatmap → Damage engine: calculates bulk
src/components/Heatmap.tsx - Bulk heatmap → Battle conditions: uses conditions
src/components/Heatmap.tsx - Team box view → Saved teams: loads and saves
src/components/TeamBox.tsx - Team box view → Team parsing: parses roster
src/components/TeamBox.tsx - Team box view → Format discovery: uses format
src/components/TeamBox.tsx - Showdown battle → Board reader: provides board
- Board reader → Overlay controller: sends snapshots
extension/content.ts - Overlay controller → Format discovery: resolves live format
extension/content.ts - Overlay controller → Overlay panel: renders board
extension/content.ts - Overlay controller → Move results: computes damage
- Overlay controller → Opponent sets: infers opponent
extension/content.ts - Overlay controller → Battle conditions: reads battle state
- Player → Cloud teams: syncs teams
- Account service → Cloud teams: supports account