# ryuusei-yumekuma025/pokemon-star-nexus architecture

> Architecture diagram of the GitHub repository ryuusei-yumekuma025/pokemon-star-nexus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ryuusei-yumekuma025/pokemon-star-nexus
- Repository: https://github.com/ryuusei-yumekuma025/pokemon-star-nexus

## Overview

This Java codebase models a Pokémon-style game domain: master data defines Pokémon, moves, trainers, and Star Partners; registries expose that data; battle entities represent units and field conditions; and profiles hold owned partners and team presets. The visible runtime flow is master-data bootstrap into loaders and registries, followed by domain lookups and profile construction. No README or application/API entry point was provided, so user-facing initiation and several unsampled subsystem relationships remain unspecified.

Main entry points: [`src/main/java/com/gameplay/masterdata/data/master/MasterDataBootstrap.java`](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/MasterDataBootstrap.java) (Data Bootstrap), [`src/main/java/com/gameplay/profile/PlayProfile.java`](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/profile/PlayProfile.java) (Play Profile), [`src/main/java/com/gameplay/masterdata/template/move/starnexus/StarNexusMove.java`](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/move/starnexus/StarNexusMove.java) (Star Nexus Moves), [`src/main/java/com/gameplay/masterdata/data/master/registry/pokemon/PokemonRegistry.java`](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/registry/pokemon/PokemonRegistry.java) (Pokémon Registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_masterdata["Master Data"]
  node_bootstrap["Data Bootstrap"]
  node_loaders["Data Loaders"]
  node_pokemon["Pokémon Catalog"]
  node_pokemonform["Pokémon Forms<br/>[PokemonForm.java]"]
  node_pokemonregistry["Pokémon Registry"]
  node_trainer["Trainer Catalog"]
  node_traineridentity["Trainer Identity"]
  node_trainerregistry["Trainer Registry"]
  node_partner["Star Partner Catalog<br/>[StarPartner.java]"]
  node_partnerregistry["Partner Registry"]
end

subgraph group_moves["Move Catalog"]
  node_moves["Move Definitions<br/>[Move.java]"]
  node_battlemove["Battle Moves<br/>[BattleMove.java]"]
  node_pokemonmove["Pokémon Moves<br/>[PokemonMove.java]"]
  node_starnexus["Star Nexus Moves<br/>[StarNexusMove.java]"]
  node_moveregistry["Pokémon Move Registry"]
end

subgraph group_battle["Battle Domain"]
  node_battlepokemon["Battle Pokémon<br/>[BattlePokemon.java]"]
  node_statstages["Stat Stage Tracker"]
  node_battlefields["Battle Fields"]
end

subgraph group_profile["Player Profile"]
  node_profile["Play Profile<br/>[PlayProfile.java]"]
  node_ownedpartner["Owned Partner"]
  node_partnerstorage[("Partner Storage")]
  node_teamstorage[("Team Presets")]
end

node_gameuser(("Game User"))

node_bootstrap -->|"invokes"| node_loaders
node_bootstrap -->|"initializes"| node_pokemonregistry
node_bootstrap -->|"initializes"| node_trainerregistry
node_bootstrap -->|"initializes"| node_moveregistry
node_pokemon -->|"contains"| node_pokemonform
node_pokemonregistry -->|"indexes"| node_pokemon
node_pokemonregistry -->|"indexes"| node_pokemonform
node_traineridentity -.->|"contains"| node_trainer
node_trainerregistry -->|"indexes"| node_traineridentity
node_trainerregistry -->|"indexes"| node_trainer
node_partnerregistry -->|"indexes"| node_partner
node_battlemove -->|"extends"| node_moves
node_pokemonmove -.->|"extends"| node_battlemove
node_starnexus -->|"extends"| node_moves
node_starnexus -->|"looks up"| node_moveregistry
node_starnexus -->|"looks up"| node_partnerregistry
node_battlepokemon -->|"uses"| node_pokemonform
node_battlepokemon -->|"uses"| node_statstages
node_profile -->|"holds"| node_ownedpartner
node_profile -->|"owns"| node_partnerstorage
node_profile -->|"owns"| node_teamstorage
node_partnerstorage -->|"creates"| node_ownedpartner
node_partnerstorage -->|"unites"| node_partner
node_gameuser -.->|"uses"| node_profile

click node_bootstrap "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/MasterDataBootstrap.java"
click node_loaders "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/tree/master/src/main/java/com/gameplay/masterdata/data/master/loader"
click node_pokemon "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/pokemon/PokemonSpecies.java"
click node_pokemonform "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/pokemon/form/PokemonForm.java"
click node_pokemonregistry "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/registry/pokemon/PokemonRegistry.java"
click node_trainer "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/trainer/TrainerAlternate.java"
click node_traineridentity "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/trainer/TrainerIdentity.java"
click node_trainerregistry "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/registry/trainer/TrainerRegistry.java"
click node_partner "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/starpartner/StarPartner.java"
click node_partnerregistry "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/registry/starpartner/StarPartnerRegistry.java"
click node_moves "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/move/Move.java"
click node_battlemove "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/move/battle/BattleMove.java"
click node_pokemonmove "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/move/battle/pokemon/PokemonMove.java"
click node_starnexus "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/move/starnexus/StarNexusMove.java"
click node_moveregistry "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/registry/move/battle/PokemonMoveRegistry.java"
click node_battlepokemon "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/battle/entity/unit/BattlePokemon.java"
click node_statstages "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/battle/entity/unit/pokemon/StatStageTracker.java"
click node_battlefields "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/tree/master/src/main/java/com/gameplay/battle/entity/field"
click node_profile "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/profile/PlayProfile.java"
click node_ownedpartner "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/profile/entity/starpartner/OwnedStarPartner.java"
click node_partnerstorage "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/profile/entity/starpartner/OwnedStarPartnerStorage.java"
click node_teamstorage "https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/profile/entity/team/TeamPresetStorage.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_bootstrap,node_loaders,node_pokemon,node_pokemonform,node_pokemonregistry,node_trainer,node_traineridentity,node_trainerregistry,node_partner,node_partnerregistry,node_gameuser toneBlue
class node_moves,node_battlemove,node_pokemonmove,node_starnexus,node_moveregistry toneAmber
class node_battlepokemon,node_statstages,node_battlefields toneMint
class node_profile,node_ownedpartner,node_partnerstorage,node_teamstorage toneRose
```

## Components

### Master Data

- [Data Bootstrap](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/MasterDataBootstrap.java): `src/main/java/com/gameplay/masterdata/data/master/MasterDataBootstrap.java`
- [Data Loaders](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/tree/master/src/main/java/com/gameplay/masterdata/data/master/loader): `src/main/java/com/gameplay/masterdata/data/master/loader`
- [Pokémon Catalog](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/pokemon/PokemonSpecies.java): `src/main/java/com/gameplay/masterdata/template/pokemon/PokemonSpecies.java`
- [Pokémon Forms](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/pokemon/form/PokemonForm.java): `src/main/java/com/gameplay/masterdata/template/pokemon/form/PokemonForm.java`
- [Pokémon Registry](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/registry/pokemon/PokemonRegistry.java): `src/main/java/com/gameplay/masterdata/data/master/registry/pokemon/PokemonRegistry.java`
- [Trainer Catalog](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/trainer/TrainerAlternate.java): `src/main/java/com/gameplay/masterdata/template/trainer/TrainerAlternate.java`
- [Trainer Identity](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/trainer/TrainerIdentity.java): `src/main/java/com/gameplay/masterdata/template/trainer/TrainerIdentity.java`
- [Trainer Registry](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/registry/trainer/TrainerRegistry.java): `src/main/java/com/gameplay/masterdata/data/master/registry/trainer/TrainerRegistry.java`
- [Star Partner Catalog](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/starpartner/StarPartner.java): `src/main/java/com/gameplay/masterdata/template/starpartner/StarPartner.java`
- [Partner Registry](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/registry/starpartner/StarPartnerRegistry.java): `src/main/java/com/gameplay/masterdata/data/master/registry/starpartner/StarPartnerRegistry.java`

### Move Catalog

- [Move Definitions](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/move/Move.java): `src/main/java/com/gameplay/masterdata/template/move/Move.java`
- [Battle Moves](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/move/battle/BattleMove.java): `src/main/java/com/gameplay/masterdata/template/move/battle/BattleMove.java`
- [Pokémon Moves](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/move/battle/pokemon/PokemonMove.java): `src/main/java/com/gameplay/masterdata/template/move/battle/pokemon/PokemonMove.java`
- [Star Nexus Moves](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/template/move/starnexus/StarNexusMove.java): `src/main/java/com/gameplay/masterdata/template/move/starnexus/StarNexusMove.java`
- [Pokémon Move Registry](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/masterdata/data/master/registry/move/battle/PokemonMoveRegistry.java): `src/main/java/com/gameplay/masterdata/data/master/registry/move/battle/PokemonMoveRegistry.java`

### Battle Domain

- [Battle Pokémon](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/battle/entity/unit/BattlePokemon.java): `src/main/java/com/gameplay/battle/entity/unit/BattlePokemon.java`
- [Stat Stage Tracker](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/battle/entity/unit/pokemon/StatStageTracker.java): `src/main/java/com/gameplay/battle/entity/unit/pokemon/StatStageTracker.java`
- [Battle Fields](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/tree/master/src/main/java/com/gameplay/battle/entity/field): `src/main/java/com/gameplay/battle/entity/field`

### Player Profile

- [Play Profile](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/profile/PlayProfile.java): `src/main/java/com/gameplay/profile/PlayProfile.java`
- [Owned Partner](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/profile/entity/starpartner/OwnedStarPartner.java): `src/main/java/com/gameplay/profile/entity/starpartner/OwnedStarPartner.java`
- [Partner Storage](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/profile/entity/starpartner/OwnedStarPartnerStorage.java): `src/main/java/com/gameplay/profile/entity/starpartner/OwnedStarPartnerStorage.java`
- [Team Presets](https://github.com/ryuusei-yumekuma025/pokemon-star-nexus/blob/master/src/main/java/com/gameplay/profile/entity/team/TeamPresetStorage.java): `src/main/java/com/gameplay/profile/entity/team/TeamPresetStorage.java`

### Other components

- **Game User**

## Connections

- Data Bootstrap → Data Loaders: invokes (evidence: `src/main/java/com/gameplay/masterdata/data/master/MasterDataBootstrap.java`)
- Data Bootstrap → Pokémon Registry: initializes (evidence: `src/main/java/com/gameplay/masterdata/data/master/MasterDataBootstrap.java`)
- Data Bootstrap → Trainer Registry: initializes (evidence: `src/main/java/com/gameplay/masterdata/data/master/MasterDataBootstrap.java`)
- Data Bootstrap → Pokémon Move Registry: initializes (evidence: `src/main/java/com/gameplay/masterdata/data/master/MasterDataBootstrap.java`)
- Pokémon Catalog → Pokémon Forms: contains (evidence: `src/main/java/com/gameplay/masterdata/template/pokemon/PokemonSpecies.java`)
- Pokémon Registry → Pokémon Catalog: indexes (evidence: `src/main/java/com/gameplay/masterdata/data/master/registry/pokemon/PokemonRegistry.java`)
- Pokémon Registry → Pokémon Forms: indexes (evidence: `src/main/java/com/gameplay/masterdata/data/master/registry/pokemon/PokemonRegistry.java`)
- Trainer Identity → Trainer Catalog: contains (evidence: `src/main/java/com/gameplay/masterdata/template/trainer/TrainerIdentity.java`)
- Trainer Registry → Trainer Identity: indexes (evidence: `src/main/java/com/gameplay/masterdata/data/master/registry/trainer/TrainerRegistry.java`)
- Trainer Registry → Trainer Catalog: indexes (evidence: `src/main/java/com/gameplay/masterdata/data/master/registry/trainer/TrainerRegistry.java`)
- Partner Registry → Star Partner Catalog: indexes (evidence: `src/main/java/com/gameplay/masterdata/data/master/registry/starpartner/StarPartnerRegistry.java`)
- Battle Moves → Move Definitions: extends (evidence: `src/main/java/com/gameplay/masterdata/template/move/battle/BattleMove.java`)
- Pokémon Moves → Battle Moves: extends (evidence: `src/main/java/com/gameplay/masterdata/template/move/battle/pokemon/PokemonMove.java`)
- Star Nexus Moves → Move Definitions: extends (evidence: `src/main/java/com/gameplay/masterdata/template/move/starnexus/StarNexusMove.java`)
- Star Nexus Moves → Pokémon Move Registry: looks up (evidence: `src/main/java/com/gameplay/masterdata/template/move/starnexus/StarNexusMove.java`)
- Star Nexus Moves → Partner Registry: looks up (evidence: `src/main/java/com/gameplay/masterdata/template/move/starnexus/StarNexusMove.java`)
- Battle Pokémon → Pokémon Forms: uses (evidence: `src/main/java/com/gameplay/battle/entity/unit/BattlePokemon.java`)
- Battle Pokémon → Stat Stage Tracker: uses (evidence: `src/main/java/com/gameplay/battle/entity/unit/BattlePokemon.java`)
- Play Profile → Owned Partner: holds (evidence: `src/main/java/com/gameplay/profile/PlayProfile.java`)
- Play Profile → Partner Storage: owns (evidence: `src/main/java/com/gameplay/profile/PlayProfile.java`)
- Play Profile → Team Presets: owns (evidence: `src/main/java/com/gameplay/profile/PlayProfile.java`)
- Partner Storage → Owned Partner: creates (evidence: `src/main/java/com/gameplay/profile/entity/starpartner/OwnedStarPartnerStorage.java`)
- Partner Storage → Star Partner Catalog: unites (evidence: `src/main/java/com/gameplay/profile/entity/starpartner/OwnedStarPartnerStorage.java`)
- Game User → Play Profile: uses
