# fishrpg/fishrpg-public architecture

> Architecture diagram of the GitHub repository fishrpg/fishrpg-public, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fishrpg/fishrpg-public
- Repository: https://github.com/fishrpg/fishrpg-public

## Overview

FishRPG is a collection of Minecraft RPG server plugins, rather than a complete standalone game service; the README notes that Redis, instancing, and other systems are not public. A visible player journey runs from lobby profile selection and instance handoff into the RPG server, where player state and equipment feed combat and spell actions. The repository also contains distinct farming, crafting, housing, quest, and resource-pack systems. Several links below are dashed because their implementation or wiring was not excerpted; the graph does not imply that the missing external services are present.

Main entry points: [`RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/PlayerManager.java`](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/PlayerManager.java) (Player lifecycle), [`RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/MCRPGLobby.java`](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/MCRPGLobby.java) (Lobby plugin), [`RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/spell/SpellManager.java`](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/spell/SpellManager.java) (Spell casting), [`RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/memory/PlayerMemory.java`](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/memory/PlayerMemory.java) (Player state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lobby["Lobby &amp; Entry"]
  node_lobby["Lobby plugin<br/>[MCRPGLobby.java]"]
  node_entrance["Entrance flow"]
  node_profile["Profile selection"]
  node_instance_select["Instance selection"]
  node_message["Server handoff"]
end

subgraph group_runtime["RPG Runtime"]
  node_core["RPG plugin<br/>[MinecraftRPG.java]"]
  node_api["Shared API<br/>[MRPGAPI.java]"]
  node_profile_data[("Profile data<br/>[Profile.java]")]
  node_user_data[("User data<br/>[User.java]")]
  node_player_state["Player state<br/>[PlayerMemory.java]"]
  node_player_manager["Player lifecycle<br/>[PlayerManager.java]"]
  node_stats["Player stats"]
end

subgraph group_gameplay["Gameplay Systems"]
  node_items["Game items<br/>[GameItem.java]"]
  node_item_manager["Item registry<br/>[ItemManager.java]"]
  node_attack["Combat<br/>[AttackManager.java]"]
  node_spells["Spell casting<br/>[SpellManager.java]"]
  node_crafting["Crafting"]
  node_farming["Farming"]
  node_housing["Player housing"]
end

subgraph group_content["Content &amp; Quests"]
  node_quests["Quest systems<br/>[FQSManager.java]"]
  node_mobs["RPG mobs"]
end

subgraph group_integration["Extensions"]
  node_autorpack["Resource pack plugin<br/>[AutoRP.java]"]
  node_pack_data[("Pack metadata")]
  node_fqm["FQM connector"]
  node_utils["Minecraft utilities<br/>[BoundingBox.java]"]
  node_instance["Instance plugin<br/>[RPGInstance.java]"]
end

node_player(("Player"))

node_player -.->|"joins"| node_lobby
node_lobby -.->|"ticks entrance"| node_entrance
node_entrance -->|"opens selection"| node_profile
node_entrance -->|"sends handoff"| node_message
node_lobby -.->|"uses selection"| node_instance_select
node_lobby -->|"attaches Redis"| node_api
node_player -.->|"enters gameplay"| node_core
node_core -.->|"manages players"| node_player_manager
node_player_manager -->|"clears memory"| node_player_state
node_player_manager -->|"flushes profile"| node_profile_data
node_player_manager -->|"flushes user"| node_user_data
node_player_manager -.->|"updates stats"| node_stats
node_player_state -->|"reads station levels"| node_profile_data
node_player_state -.->|"holds stat map"| node_stats
node_items -->|"applies design"| node_item_manager
node_player -.->|"casts spell"| node_spells
node_spells -->|"updates mana"| node_player_state
node_spells -->|"refreshes action bar"| node_player_manager
node_spells -->|"reads mana stats"| node_stats
node_spells -->|"resolves held item"| node_items
node_player -.->|"attacks"| node_attack
node_attack -->|"checks item type"| node_items
node_attack -.->|"calculates damage"| node_stats
node_player -.->|"uses recipes"| node_crafting
node_player -.->|"tends crops"| node_farming
node_player -.->|"uses housing"| node_housing
node_player -.->|"progresses quests"| node_quests
node_player -.->|"encounters mobs"| node_mobs
node_autorpack -->|"attaches Redis"| node_api
node_autorpack -->|"loads metadata"| node_pack_data
node_pack_data -.->|"models pack items"| node_items
node_player -.->|"emits game events"| node_fqm
node_lobby -.->|"routes to instance"| node_instance

click node_lobby "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/MCRPGLobby.java"
click node_entrance "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/entrance/EntranceManager.java"
click node_profile "https://github.com/fishrpg/fishrpg-public/tree/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/profileselection"
click node_instance_select "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/instanceselector/InstanceSelectorManager.java"
click node_message "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/bungee/MessageManager.java"
click node_core "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/MinecraftRPG.java"
click node_api "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-API/src/main/java/me/acraftingfish/mrpg/MRPGAPI.java"
click node_profile_data "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-API/src/main/java/me/acraftingfish/mrpg/fedis/profile/Profile.java"
click node_user_data "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-API/src/main/java/me/acraftingfish/mrpg/fedis/user/User.java"
click node_player_state "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/memory/PlayerMemory.java"
click node_player_manager "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/PlayerManager.java"
click node_stats "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/stats/PlayerStatsMap.java"
click node_items "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/item/xitem/GameItem.java"
click node_item_manager "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/item/ItemManager.java"
click node_attack "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/attack/AttackManager.java"
click node_spells "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/spell/SpellManager.java"
click node_crafting "https://github.com/fishrpg/fishrpg-public/tree/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/crafting"
click node_farming "https://github.com/fishrpg/fishrpg-public/tree/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/farming"
click node_housing "https://github.com/fishrpg/fishrpg-public/tree/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/housing"
click node_quests "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/quest/FQSManager.java"
click node_mobs "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/content/mobs/quest/ShipEngineerMob.java"
click node_autorpack "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-AutoRP/src/main/java/me/acraftingfish/autorp/AutoRP.java"
click node_pack_data "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-AutoRP/src/main/java/me/acraftingfish/autorp/betterpack/CustomInfoManager.java"
click node_fqm "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-FQM/src/main/java/me/acraftingfish/fqmconn/event/FQMEventManager.java"
click node_utils "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Utils/src/main/java/me/acraftingfish/fishmcutils/BoundingBox.java"
click node_instance "https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Instance/src/main/java/me/acraftingfish/rpginstance/RPGInstance.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_lobby,node_entrance,node_profile,node_instance_select,node_message toneBlue
class node_core,node_api,node_profile_data,node_user_data,node_player_state,node_player_manager,node_stats toneAmber
class node_items,node_item_manager,node_attack,node_spells,node_crafting,node_farming,node_housing toneMint
class node_quests,node_mobs toneRose
class node_autorpack,node_pack_data,node_fqm,node_utils,node_instance,node_player toneIndigo
```

## Components

### Lobby & Entry

- [Lobby plugin](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/MCRPGLobby.java): `RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/MCRPGLobby.java`
- [Entrance flow](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/entrance/EntranceManager.java): `RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/entrance/EntranceManager.java`
- [Profile selection](https://github.com/fishrpg/fishrpg-public/tree/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/profileselection): `RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/profileselection`
- [Instance selection](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/instanceselector/InstanceSelectorManager.java): `RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/instanceselector/InstanceSelectorManager.java`
- [Server handoff](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/bungee/MessageManager.java): `RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/bungee/MessageManager.java`

### RPG Runtime

- [RPG plugin](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/MinecraftRPG.java): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/MinecraftRPG.java`
- [Shared API](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-API/src/main/java/me/acraftingfish/mrpg/MRPGAPI.java): `RPG-API/src/main/java/me/acraftingfish/mrpg/MRPGAPI.java`
- [Profile data](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-API/src/main/java/me/acraftingfish/mrpg/fedis/profile/Profile.java): `RPG-API/src/main/java/me/acraftingfish/mrpg/fedis/profile/Profile.java`
- [User data](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-API/src/main/java/me/acraftingfish/mrpg/fedis/user/User.java): `RPG-API/src/main/java/me/acraftingfish/mrpg/fedis/user/User.java`
- [Player state](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/memory/PlayerMemory.java): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/memory/PlayerMemory.java`
- [Player lifecycle](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/PlayerManager.java): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/PlayerManager.java`
- [Player stats](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/stats/PlayerStatsMap.java): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/stats/PlayerStatsMap.java`

### Gameplay Systems

- [Game items](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/item/xitem/GameItem.java): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/item/xitem/GameItem.java`
- [Item registry](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/item/ItemManager.java): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/item/ItemManager.java`
- [Combat](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/attack/AttackManager.java): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/attack/AttackManager.java`
- [Spell casting](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/spell/SpellManager.java): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/spell/SpellManager.java`
- [Crafting](https://github.com/fishrpg/fishrpg-public/tree/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/crafting): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/crafting`
- [Farming](https://github.com/fishrpg/fishrpg-public/tree/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/farming): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/farming`
- [Player housing](https://github.com/fishrpg/fishrpg-public/tree/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/housing): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/housing`

### Content & Quests

- [Quest systems](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/quest/FQSManager.java): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/quest/FQSManager.java`
- [RPG mobs](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/content/mobs/quest/ShipEngineerMob.java): `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/content/mobs/quest/ShipEngineerMob.java`

### Extensions

- [Resource pack plugin](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-AutoRP/src/main/java/me/acraftingfish/autorp/AutoRP.java): `RPG-AutoRP/src/main/java/me/acraftingfish/autorp/AutoRP.java`
- [Pack metadata](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-AutoRP/src/main/java/me/acraftingfish/autorp/betterpack/CustomInfoManager.java): `RPG-AutoRP/src/main/java/me/acraftingfish/autorp/betterpack/CustomInfoManager.java`
- [FQM connector](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-FQM/src/main/java/me/acraftingfish/fqmconn/event/FQMEventManager.java): `RPG-FQM/src/main/java/me/acraftingfish/fqmconn/event/FQMEventManager.java`
- [Minecraft utilities](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Utils/src/main/java/me/acraftingfish/fishmcutils/BoundingBox.java): `RPG-Utils/src/main/java/me/acraftingfish/fishmcutils/BoundingBox.java`
- [Instance plugin](https://github.com/fishrpg/fishrpg-public/blob/main/RPG-Instance/src/main/java/me/acraftingfish/rpginstance/RPGInstance.java): `RPG-Instance/src/main/java/me/acraftingfish/rpginstance/RPGInstance.java`

### Other components

- **Player**

## Connections

- Player → Lobby plugin: joins
- Lobby plugin → Entrance flow: ticks entrance (evidence: `RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/entrance/EntranceManager.java`)
- Entrance flow → Profile selection: opens selection (evidence: `RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/entrance/EntranceManager.java`)
- Entrance flow → Server handoff: sends handoff (evidence: `RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/entrance/EntranceManager.java`)
- Lobby plugin → Instance selection: uses selection
- Lobby plugin → Shared API: attaches Redis (evidence: `RPG-Lobby/src/main/java/me/acraftingfish/mcrpglobby/MCRPGLobby.java`)
- Player → RPG plugin: enters gameplay
- RPG plugin → Player lifecycle: manages players
- Player lifecycle → Player state: clears memory (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/PlayerManager.java`)
- Player lifecycle → Profile data: flushes profile (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/PlayerManager.java`)
- Player lifecycle → User data: flushes user (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/PlayerManager.java`)
- Player lifecycle → Player stats: updates stats (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/PlayerManager.java`)
- Player state → Profile data: reads station levels (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/memory/PlayerMemory.java`)
- Player state → Player stats: holds stat map (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/player/memory/PlayerMemory.java`)
- Game items → Item registry: applies design (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/item/xitem/GameItem.java`)
- Player → Spell casting: casts spell
- Spell casting → Player state: updates mana (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/spell/SpellManager.java`)
- Spell casting → Player lifecycle: refreshes action bar (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/spell/SpellManager.java`)
- Spell casting → Player stats: reads mana stats (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/spell/SpellManager.java`)
- Spell casting → Game items: resolves held item (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/spell/SpellManager.java`)
- Player → Combat: attacks
- Combat → Game items: checks item type (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/attack/AttackManager.java`)
- Combat → Player stats: calculates damage (evidence: `RPG-Core/src/main/java/me/acraftingfish/minecraftrpg/common/attack/AttackManager.java`)
- Player → Crafting: uses recipes
- Player → Farming: tends crops
- Player → Player housing: uses housing
- Player → Quest systems: progresses quests
- Player → RPG mobs: encounters mobs
- Resource pack plugin → Shared API: attaches Redis (evidence: `RPG-AutoRP/src/main/java/me/acraftingfish/autorp/AutoRP.java`)
- Resource pack plugin → Pack metadata: loads metadata (evidence: `RPG-AutoRP/src/main/java/me/acraftingfish/autorp/AutoRP.java`)
- Pack metadata → Game items: models pack items
- Player → FQM connector: emits game events
- Lobby plugin → Instance plugin: routes to instance
