# arios530/arios-530 architecture

> Architecture diagram of the GitHub repository arios530/arios-530, 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/arios530/arios-530
- Repository: https://github.com/arios530/arios-530

## Overview

Arios-530 is a Java MMORPG stack: a game client, game server, world-management server, and desktop content editor. Players use the client to connect to a game world; the server runs world and entity behavior, while the management server coordinates worlds, player sessions, and shared services. The editor provides a separate workflow for editing shop and NPC-drop data against the server store. The map emphasizes these distinct runtime and editing areas; several client and server subsystems are represented by enclosing directories because their implementation was not sampled.

Main entry points: [`Arios-Management-Server/src/org/arios/system/PunishmentStorage.java`](https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/system/PunishmentStorage.java) (Punishment service), [`Arios-Management-Server/src/org/arios/Main.java`](https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/Main.java) (Management runtime), [`Arios-Management-Server/src/org/arios/world/WorldDatabase.java`](https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/world/WorldDatabase.java) (World registry), [`Arios-Server/src/org/arios/game/world/GameWorld.java`](https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/world/GameWorld.java) (Game world)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Game client"]
  node_client_loader["Client loader<br/>[ClientLoader.java]"]
  node_client_runtime["Client runtime<br/>[client.java]"]
  node_client_render["Rendering core<br/>[Class44.java]"]
  node_client_text["Text handling<br/>[RSString.java]"]
  node_client_scripts["Client scripts<br/>[CS2Script.java]"]
end

subgraph group_game["Game server"]
  node_game_world["Game world<br/>[GameWorld.java]"]
  node_game_player["Player entity<br/>[Player.java]"]
  node_game_npc["NPC entity<br/>[NPC.java]"]
  node_game_combat["Combat system"]
  node_game_map["Region management<br/>[RegionManager.java]"]
  node_game_location["World locations<br/>[Location.java]"]
  node_plugins["Plugin system<br/>[PluginManager.java]"]
end

subgraph group_management["World management"]
  node_management_main["Management runtime<br/>[Main.java]"]
  node_packet_repository["World packets"]
  node_world_registry[("World registry<br/>[WorldDatabase.java]")]
  node_world_session["Player sessions<br/>[PlayerSession.java]"]
  node_punishments["Punishment service"]
end

subgraph group_editor["Content editor"]
  node_editor_shop["Shop editor<br/>[ShopManager.java]"]
  node_editor_drops["NPC drop editor"]
  node_editor_workspace["Editor workspace<br/>[WorkSpace.java]"]
end

subgraph group_storage["Data and storage"]
  node_sql[("SQL connections<br/>[SQLManager.java]")]
  node_editor_cache[("Cache files")]
  node_server_store[("Server store<br/>[ServerStore.java]")]
  node_server_cache[("Game cache")]
end

node_player(("Player"))

node_player -.->|"starts"| node_client_loader
node_client_loader -.->|"launches"| node_client_runtime
node_client_runtime -->|"uses"| node_client_render
node_client_runtime -->|"uses"| node_client_text
node_management_main -->|"initializes"| node_packet_repository
node_management_main -->|"initializes"| node_world_registry
node_management_main -->|"initializes"| node_world_session
node_management_main -->|"initializes"| node_sql
node_packet_repository -->|"checks bans"| node_punishments
node_punishments -->|"dispatches updates"| node_packet_repository
node_punishments -->|"looks up players"| node_world_registry
node_punishments -->|"loads player"| node_world_session
node_punishments -->|"queries"| node_sql
node_sql -->|"uses"| node_world_registry
node_world_registry -->|"tracks sessions"| node_world_session
node_game_world -->|"loads regions"| node_game_map
node_game_world -->|"initializes"| node_plugins
node_game_world -.->|"initializes"| node_server_cache
node_game_player -->|"updates scene"| node_game_map
node_game_map -->|"queries locations"| node_game_location
node_editor_shop -->|"reads and writes"| node_server_store
node_editor_drops -->|"reads and writes"| node_server_store
node_editor_shop -->|"uses"| node_editor_workspace
node_editor_drops -->|"uses"| node_editor_workspace
node_editor_cache -.->|"supports cache access"| node_server_store

click node_client_loader "https://github.com/arios530/arios-530/blob/main/Arios-Client/src/ClientLoader.java"
click node_client_runtime "https://github.com/arios530/arios-530/blob/main/Arios-Client/src/client.java"
click node_client_render "https://github.com/arios530/arios-530/blob/main/Arios-Client/src/Class44.java"
click node_client_text "https://github.com/arios530/arios-530/blob/main/Arios-Client/src/RSString.java"
click node_client_scripts "https://github.com/arios530/arios-530/blob/main/Arios-Client/src/CS2Script.java"
click node_game_world "https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/world/GameWorld.java"
click node_game_player "https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/node/entity/player/Player.java"
click node_game_npc "https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/node/entity/npc/NPC.java"
click node_game_combat "https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/node/entity/combat/CombatSwingHandler.java"
click node_game_map "https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/world/map/RegionManager.java"
click node_game_location "https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/world/map/Location.java"
click node_plugins "https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/plugin/PluginManager.java"
click node_management_main "https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/Main.java"
click node_packet_repository "https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/net/packet/WorldPacketRepository.java"
click node_world_registry "https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/world/WorldDatabase.java"
click node_world_session "https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/world/PlayerSession.java"
click node_punishments "https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/system/PunishmentStorage.java"
click node_sql "https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/system/mysql/SQLManager.java"
click node_editor_shop "https://github.com/arios530/arios-530/blob/main/Arios%20Editor/src/org/arioseditor/workspace/node/item/shop/ShopManager.java"
click node_editor_drops "https://github.com/arios530/arios-530/blob/main/Arios%20Editor/src/org/arioseditor/workspace/node/npc/NPCDropManager.java"
click node_editor_workspace "https://github.com/arios530/arios-530/blob/main/Arios%20Editor/src/org/arioseditor/workspace/WorkSpace.java"
click node_editor_cache "https://github.com/arios530/arios-530/blob/main/Arios%20Editor/src/org/arioseditor/cache/CacheFileManager.java"
click node_server_store "https://github.com/arios530/arios-530/blob/main/Arios%20Editor/src/org/arioseditor/cache/ServerStore.java"
click node_server_cache "https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/cache/CacheFileManager.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_client_loader,node_client_runtime,node_client_render,node_client_text,node_client_scripts toneBlue
class node_game_world,node_game_player,node_game_npc,node_game_combat,node_game_map,node_game_location,node_plugins toneAmber
class node_management_main,node_packet_repository,node_world_registry,node_world_session,node_punishments toneMint
class node_editor_shop,node_editor_drops,node_editor_workspace toneRose
class node_sql,node_editor_cache,node_server_store,node_server_cache,node_player toneIndigo
```

## Components

### Game client

- [Client loader](https://github.com/arios530/arios-530/blob/main/Arios-Client/src/ClientLoader.java): `Arios-Client/src/ClientLoader.java`
- [Client runtime](https://github.com/arios530/arios-530/blob/main/Arios-Client/src/client.java): `Arios-Client/src/client.java`
- [Rendering core](https://github.com/arios530/arios-530/blob/main/Arios-Client/src/Class44.java): `Arios-Client/src/Class44.java`
- [Text handling](https://github.com/arios530/arios-530/blob/main/Arios-Client/src/RSString.java): `Arios-Client/src/RSString.java`
- [Client scripts](https://github.com/arios530/arios-530/blob/main/Arios-Client/src/CS2Script.java): `Arios-Client/src/CS2Script.java`

### Game server

- [Game world](https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/world/GameWorld.java): `Arios-Server/src/org/arios/game/world/GameWorld.java`
- [Player entity](https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/node/entity/player/Player.java): `Arios-Server/src/org/arios/game/node/entity/player/Player.java`
- [NPC entity](https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/node/entity/npc/NPC.java): `Arios-Server/src/org/arios/game/node/entity/npc/NPC.java`
- [Combat system](https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/node/entity/combat/CombatSwingHandler.java): `Arios-Server/src/org/arios/game/node/entity/combat/CombatSwingHandler.java`
- [Region management](https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/world/map/RegionManager.java): `Arios-Server/src/org/arios/game/world/map/RegionManager.java`
- [World locations](https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/game/world/map/Location.java): `Arios-Server/src/org/arios/game/world/map/Location.java`
- [Plugin system](https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/plugin/PluginManager.java): `Arios-Server/src/org/arios/plugin/PluginManager.java`

### World management

- [Management runtime](https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/Main.java): `Arios-Management-Server/src/org/arios/Main.java`
- [World packets](https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/net/packet/WorldPacketRepository.java): `Arios-Management-Server/src/org/arios/net/packet/WorldPacketRepository.java`
- [World registry](https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/world/WorldDatabase.java): `Arios-Management-Server/src/org/arios/world/WorldDatabase.java`
- [Player sessions](https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/world/PlayerSession.java): `Arios-Management-Server/src/org/arios/world/PlayerSession.java`
- [Punishment service](https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/system/PunishmentStorage.java): `Arios-Management-Server/src/org/arios/system/PunishmentStorage.java`

### Content editor

- [Shop editor](https://github.com/arios530/arios-530/blob/main/Arios%20Editor/src/org/arioseditor/workspace/node/item/shop/ShopManager.java): `Arios Editor/src/org/arioseditor/workspace/node/item/shop/ShopManager.java`
- [NPC drop editor](https://github.com/arios530/arios-530/blob/main/Arios%20Editor/src/org/arioseditor/workspace/node/npc/NPCDropManager.java): `Arios Editor/src/org/arioseditor/workspace/node/npc/NPCDropManager.java`
- [Editor workspace](https://github.com/arios530/arios-530/blob/main/Arios%20Editor/src/org/arioseditor/workspace/WorkSpace.java): `Arios Editor/src/org/arioseditor/workspace/WorkSpace.java`

### Data and storage

- [SQL connections](https://github.com/arios530/arios-530/blob/main/Arios-Management-Server/src/org/arios/system/mysql/SQLManager.java): `Arios-Management-Server/src/org/arios/system/mysql/SQLManager.java`
- [Cache files](https://github.com/arios530/arios-530/blob/main/Arios%20Editor/src/org/arioseditor/cache/CacheFileManager.java): `Arios Editor/src/org/arioseditor/cache/CacheFileManager.java`
- [Server store](https://github.com/arios530/arios-530/blob/main/Arios%20Editor/src/org/arioseditor/cache/ServerStore.java): `Arios Editor/src/org/arioseditor/cache/ServerStore.java`
- [Game cache](https://github.com/arios530/arios-530/blob/main/Arios-Server/src/org/arios/cache/CacheFileManager.java): `Arios-Server/src/org/arios/cache/CacheFileManager.java`

### Other components

- **Player**

## Connections

- Player → Client loader: starts
- Client loader → Client runtime: launches
- Client runtime → Rendering core: uses (evidence: `Arios-Client/src/client.java`)
- Client runtime → Text handling: uses (evidence: `Arios-Client/src/client.java`)
- Management runtime → World packets: initializes (evidence: `Arios-Management-Server/src/org/arios/Main.java`)
- Management runtime → World registry: initializes (evidence: `Arios-Management-Server/src/org/arios/Main.java`)
- Management runtime → Player sessions: initializes (evidence: `Arios-Management-Server/src/org/arios/Main.java`)
- Management runtime → SQL connections: initializes (evidence: `Arios-Management-Server/src/org/arios/Main.java`)
- World packets → Punishment service: checks bans (evidence: `Arios-Management-Server/src/org/arios/net/packet/WorldPacketRepository.java`)
- Punishment service → World packets: dispatches updates (evidence: `Arios-Management-Server/src/org/arios/system/PunishmentStorage.java`)
- Punishment service → World registry: looks up players (evidence: `Arios-Management-Server/src/org/arios/system/PunishmentStorage.java`)
- Punishment service → Player sessions: loads player (evidence: `Arios-Management-Server/src/org/arios/system/PunishmentStorage.java`)
- Punishment service → SQL connections: queries (evidence: `Arios-Management-Server/src/org/arios/system/PunishmentStorage.java`)
- SQL connections → World registry: uses (evidence: `Arios-Management-Server/src/org/arios/system/mysql/SQLManager.java`)
- World registry → Player sessions: tracks sessions (evidence: `Arios-Management-Server/src/org/arios/world/WorldDatabase.java`)
- Game world → Region management: loads regions (evidence: `Arios-Server/src/org/arios/game/world/GameWorld.java`)
- Game world → Plugin system: initializes (evidence: `Arios-Server/src/org/arios/game/world/GameWorld.java`)
- Game world → Game cache: initializes
- Player entity → Region management: updates scene (evidence: `Arios-Server/src/org/arios/game/node/entity/player/Player.java`)
- Region management → World locations: queries locations (evidence: `Arios-Server/src/org/arios/game/world/map/RegionManager.java`)
- Shop editor → Server store: reads and writes (evidence: `Arios Editor/src/org/arioseditor/workspace/node/item/shop/ShopManager.java`)
- NPC drop editor → Server store: reads and writes (evidence: `Arios Editor/src/org/arioseditor/workspace/node/npc/NPCDropManager.java`)
- Shop editor → Editor workspace: uses (evidence: `Arios Editor/src/org/arioseditor/workspace/node/item/shop/ShopManager.java`)
- NPC drop editor → Editor workspace: uses (evidence: `Arios Editor/src/org/arioseditor/workspace/node/npc/NPCDropManager.java`)
- Cache files → Server store: supports cache access
