# xreveres/herozserver architecture

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

- Interactive diagram: https://gitdiagram.com/xreveres/herozserver
- Repository: https://github.com/xreveres/herozserver

## Overview

HeroZServer is a private PHP game server for HeroZ, backed by MariaDB. A client request enters the server dispatcher, which initializes runtime services, resolves the player session, invokes an action handler, and persists changed records. Handlers support character progression, quests and battles, inventory and rewards, guild activities, messaging, and leaderboards; the README also documents resource storage and daily-login bonuses. The graph uses sampled dispatcher and handler code plus SOURCE INDEX references; several feature implementations are represented at their existing request-directory path because they were not sampled.

Main entry points: [`server/src/Core.php`](https://github.com/xreveres/herozserver/blob/master/server/src/Core.php) (Request dispatcher), [`server/class/Player.php`](https://github.com/xreveres/herozserver/blob/master/server/class/Player.php) (Player state), [`server/src/Record.php`](https://github.com/xreveres/herozserver/blob/master/server/src/Record.php) (Record persistence), [`server/class/Fight.php`](https://github.com/xreveres/herozserver/blob/master/server/class/Fight.php) (Fight logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Request runtime"]
  node_request_entry["Request entry<br/>[request.php]"]
  node_core["Request dispatcher<br/>[Core.php]"]
  node_config["Configuration<br/>[Config.php]"]
  node_req["Response handling<br/>[Req.php]"]
  node_cache["Cache<br/>[Cache.php]"]
  node_action_handlers["Action handlers"]
end

subgraph group_player["Player progression"]
  node_player_model["Player state<br/>[Player.php]"]
  node_resource_storage["Energy and training storage"]
  node_inventory_bank["Inventory and bank<br/>[BankInventory.php]"]
  node_item_catalog["Item catalog<br/>[ItemsList.php]"]
  node_item_logic["Item utilities<br/>[Item.php]"]
end

subgraph group_gameplay["Battles and rewards"]
  node_quest_catalog["Quest catalog<br/>[QuestList.php]"]
  node_npc_catalog["NPC catalog<br/>[NPCList.php]"]
  node_fight["Fight logic<br/>[Fight.php]"]
  node_reward["Reward logic<br/>[Reward.php]"]
  node_slot_machine["Slot machine<br/>[SlotMachine.php]"]
end

subgraph group_community["Guilds and messaging"]
  node_guild_features["Guild activities<br/>[GuildsBattle.php]"]
  node_guild_leaderboard["Guild leaderboard"]
end

subgraph group_persistence["Persistence"]
  node_character_record["Character record<br/>[Character.php]"]
  node_messages["Message records<br/>[Messages.php]"]
  node_record["Record persistence<br/>[Record.php]"]
  node_database[("MariaDB")]
end

node_client(("Game client"))

node_client -.->|"sends request"| node_request_entry
node_request_entry -->|"starts runtime"| node_core
node_core -->|"initializes"| node_config
node_core -->|"initializes"| node_cache
node_core -->|"initializes"| node_database
node_core -->|"loads session"| node_player_model
node_core -->|"dispatches action"| node_action_handlers
node_core -->|"sets errors"| node_req
node_core -->|"ends request"| node_player_model
node_core -->|"saves records"| node_record
node_resource_storage -->|"updates resources"| node_player_model
node_resource_storage -->|"reads costs"| node_config
node_resource_storage -->|"sets response data"| node_req
node_player_model -->|"uses character"| node_character_record
node_player_model -->|"uses item utilities"| node_item_logic
node_item_logic -->|"uses item list"| node_item_catalog
node_player_model -->|"provides combatant"| node_fight
node_fight -->|"uses player state"| node_player_model
node_slot_machine -->|"creates reward"| node_reward
node_slot_machine -->|"reads reward settings"| node_config
node_guild_features -->|"uses battle logic"| node_fight
node_guild_features -->|"uses player logic"| node_player_model
node_guild_leaderboard -->|"reads settings"| node_config
node_guild_leaderboard -->|"sets response data"| node_req
node_character_record -->|"extends record"| node_record
node_inventory_bank -->|"extends record"| node_record
node_messages -->|"extends record"| node_record
node_record -->|"reads and writes"| node_database
node_quest_catalog -.->|"catalog association"| node_player_model
node_npc_catalog -.->|"combat association"| node_fight

click node_request_entry "https://github.com/xreveres/herozserver/blob/master/server/request.php"
click node_core "https://github.com/xreveres/herozserver/blob/master/server/src/Core.php"
click node_config "https://github.com/xreveres/herozserver/blob/master/server/src/Config.php"
click node_req "https://github.com/xreveres/herozserver/blob/master/server/src/Req.php"
click node_cache "https://github.com/xreveres/herozserver/blob/master/server/src/Cache.php"
click node_action_handlers "https://github.com/xreveres/herozserver/tree/master/server/request"
click node_player_model "https://github.com/xreveres/herozserver/blob/master/server/class/Player.php"
click node_character_record "https://github.com/xreveres/herozserver/blob/master/server/dbschema/Character.php"
click node_resource_storage "https://github.com/xreveres/herozserver/blob/master/server/request/useEnergyStorage.req.php"
click node_inventory_bank "https://github.com/xreveres/herozserver/blob/master/server/dbschema/BankInventory.php"
click node_item_catalog "https://github.com/xreveres/herozserver/blob/master/server/class/Utils/ItemsList.php"
click node_item_logic "https://github.com/xreveres/herozserver/blob/master/server/class/Utils/Item.php"
click node_quest_catalog "https://github.com/xreveres/herozserver/blob/master/server/class/Utils/QuestList.php"
click node_npc_catalog "https://github.com/xreveres/herozserver/blob/master/server/class/Utils/NPCList.php"
click node_fight "https://github.com/xreveres/herozserver/blob/master/server/class/Fight.php"
click node_reward "https://github.com/xreveres/herozserver/blob/master/server/class/Reward.php"
click node_slot_machine "https://github.com/xreveres/herozserver/blob/master/server/class/Bonus/SlotMachine.php"
click node_guild_features "https://github.com/xreveres/herozserver/blob/master/server/class/GuildsBattle.php"
click node_guild_leaderboard "https://github.com/xreveres/herozserver/blob/master/server/request/retrieveGuildLeaderboard.req.php"
click node_messages "https://github.com/xreveres/herozserver/blob/master/server/dbschema/Messages.php"
click node_record "https://github.com/xreveres/herozserver/blob/master/server/src/Record.php"

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_request_entry,node_core,node_config,node_req,node_cache,node_action_handlers,node_client toneBlue
class node_player_model,node_resource_storage,node_inventory_bank,node_item_catalog,node_item_logic toneAmber
class node_quest_catalog,node_npc_catalog,node_fight,node_reward,node_slot_machine toneMint
class node_guild_features,node_guild_leaderboard toneRose
class node_character_record,node_messages,node_record,node_database toneIndigo
```

## Components

### Request runtime

- [Request entry](https://github.com/xreveres/herozserver/blob/master/server/request.php): `server/request.php`
- [Request dispatcher](https://github.com/xreveres/herozserver/blob/master/server/src/Core.php): `server/src/Core.php`
- [Configuration](https://github.com/xreveres/herozserver/blob/master/server/src/Config.php): `server/src/Config.php`
- [Response handling](https://github.com/xreveres/herozserver/blob/master/server/src/Req.php): `server/src/Req.php`
- [Cache](https://github.com/xreveres/herozserver/blob/master/server/src/Cache.php): `server/src/Cache.php`
- [Action handlers](https://github.com/xreveres/herozserver/tree/master/server/request): `server/request`

### Player progression

- [Player state](https://github.com/xreveres/herozserver/blob/master/server/class/Player.php): `server/class/Player.php`
- [Energy and training storage](https://github.com/xreveres/herozserver/blob/master/server/request/useEnergyStorage.req.php): `server/request/useEnergyStorage.req.php`
- [Inventory and bank](https://github.com/xreveres/herozserver/blob/master/server/dbschema/BankInventory.php): `server/dbschema/BankInventory.php`
- [Item catalog](https://github.com/xreveres/herozserver/blob/master/server/class/Utils/ItemsList.php): `server/class/Utils/ItemsList.php`
- [Item utilities](https://github.com/xreveres/herozserver/blob/master/server/class/Utils/Item.php): `server/class/Utils/Item.php`

### Battles and rewards

- [Quest catalog](https://github.com/xreveres/herozserver/blob/master/server/class/Utils/QuestList.php): `server/class/Utils/QuestList.php`
- [NPC catalog](https://github.com/xreveres/herozserver/blob/master/server/class/Utils/NPCList.php): `server/class/Utils/NPCList.php`
- [Fight logic](https://github.com/xreveres/herozserver/blob/master/server/class/Fight.php): `server/class/Fight.php`
- [Reward logic](https://github.com/xreveres/herozserver/blob/master/server/class/Reward.php): `server/class/Reward.php`
- [Slot machine](https://github.com/xreveres/herozserver/blob/master/server/class/Bonus/SlotMachine.php): `server/class/Bonus/SlotMachine.php`

### Guilds and messaging

- [Guild activities](https://github.com/xreveres/herozserver/blob/master/server/class/GuildsBattle.php): `server/class/GuildsBattle.php`
- [Guild leaderboard](https://github.com/xreveres/herozserver/blob/master/server/request/retrieveGuildLeaderboard.req.php): `server/request/retrieveGuildLeaderboard.req.php`

### Persistence

- [Character record](https://github.com/xreveres/herozserver/blob/master/server/dbschema/Character.php): `server/dbschema/Character.php`
- [Message records](https://github.com/xreveres/herozserver/blob/master/server/dbschema/Messages.php): `server/dbschema/Messages.php`
- [Record persistence](https://github.com/xreveres/herozserver/blob/master/server/src/Record.php): `server/src/Record.php`
- **MariaDB**

### Other components

- **Game client**

## Connections

- Game client → Request entry: sends request
- Request entry → Request dispatcher: starts runtime (evidence: `server/request.php`)
- Request dispatcher → Configuration: initializes (evidence: `server/src/Core.php`)
- Request dispatcher → Cache: initializes (evidence: `server/src/Core.php`)
- Request dispatcher → MariaDB: initializes (evidence: `server/src/Core.php`)
- Request dispatcher → Player state: loads session (evidence: `server/src/Core.php`)
- Request dispatcher → Action handlers: dispatches action (evidence: `server/src/Core.php`)
- Request dispatcher → Response handling: sets errors (evidence: `server/src/Core.php`)
- Request dispatcher → Player state: ends request (evidence: `server/src/Core.php`)
- Request dispatcher → Record persistence: saves records (evidence: `server/src/Core.php`)
- Energy and training storage → Player state: updates resources (evidence: `server/request/useEnergyStorage.req.php`)
- Energy and training storage → Configuration: reads costs (evidence: `server/request/useEnergyStorage.req.php`)
- Energy and training storage → Response handling: sets response data (evidence: `server/request/useEnergyStorage.req.php`)
- Player state → Character record: uses character (evidence: `server/class/Player.php`)
- Player state → Item utilities: uses item utilities (evidence: `server/class/Player.php`)
- Item utilities → Item catalog: uses item list (evidence: `server/class/Utils/Item.php`)
- Player state → Fight logic: provides combatant (evidence: `server/class/Fight.php`)
- Fight logic → Player state: uses player state (evidence: `server/class/Fight.php`)
- Slot machine → Reward logic: creates reward (evidence: `server/class/Bonus/SlotMachine.php`)
- Slot machine → Configuration: reads reward settings (evidence: `server/class/Bonus/SlotMachine.php`)
- Guild activities → Fight logic: uses battle logic (evidence: `server/class/GuildsBattle.php`)
- Guild activities → Player state: uses player logic (evidence: `server/class/GuildsBattle.php`)
- Guild leaderboard → Configuration: reads settings (evidence: `server/request/retrieveGuildLeaderboard.req.php`)
- Guild leaderboard → Response handling: sets response data (evidence: `server/request/retrieveGuildLeaderboard.req.php`)
- Character record → Record persistence: extends record (evidence: `server/dbschema/Character.php`)
- Inventory and bank → Record persistence: extends record (evidence: `server/dbschema/BankInventory.php`)
- Message records → Record persistence: extends record (evidence: `server/dbschema/Messages.php`)
- Record persistence → MariaDB: reads and writes (evidence: `server/src/Record.php`)
- Quest catalog → Player state: catalog association
- NPC catalog → Fight logic: combat association
