# hienkhang2004-coder/skybreak-roblox-rpg architecture

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

- Interactive diagram: https://gitdiagram.com/hienkhang2004-coder/skybreak-roblox-rpg
- Repository: https://github.com/hienkhang2004-coder/skybreak-roblox-rpg

## Overview

SKYBREAK is a Roblox 3D celestial action RPG. The player enters through the client experience, interacts with screens and controls, and plays through server-authoritative combat, quests, travel, and world events; persistent player state and Roblox services support that experience. The README identifies the three canonical code areas and major gameplay, UI, world, 3D, flight, and audio capabilities. Runtime source excerpts were not provided, so specific call-level wiring is not asserted; edges below reflect documented subsystem relationships.

Main entry points: [`04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/ServerBootstrap.server.lua`](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/ServerBootstrap.server.lua) (Server Bootstrap), [`04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/WorldService.lua`](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/WorldService.lua) (World and Travel), [`04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/ReplicatedStorage/DelegatedV5Renderer.lua`](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/ReplicatedStorage/DelegatedV5Renderer.lua) (3D Rendering), [`04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/PlayerDataService.lua`](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/PlayerDataService.lua) (Player Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["Server Gameplay"]
  node_server_entry["Server Bootstrap"]
  node_combat["Combat Systems"]
  node_skills["Skill Mechanics"]
  node_quests["Quest Service<br/>[QuestService.lua]"]
  node_inventory["Inventory and Crafting"]
  node_social["Social Economy"]
  node_events["Live World Events"]
  node_player_data["Player Data"]
end

subgraph group_client["Client Experience"]
  node_client_entry["Client Bootstrap<br/>[Main.client.lua]"]
  node_ui["Screens and HUD"]
  node_ui_controls["UI Controllers"]
  node_flight_audio["Flight and Audio"]
end

subgraph group_world3d["World and 3D"]
  node_world_service["World and Travel<br/>[WorldService.lua]"]
  node_environment["Realm Environment"]
  node_rendering["3D Rendering"]
  node_combat_vfx["Combat VFX"]
end

subgraph group_shared["Shared Systems"]
  node_shared_config["Shared Configuration<br/>[WorldConfig.lua]"]
end

node_player(("Player"))
node_datastore[("Roblox DataStore")]
node_roblox{{"Roblox Platform"}}

node_player -->|"starts play"| node_client_entry
node_client_entry -.->|"presents screens"| node_ui
node_ui -.->|"supports actions"| node_ui_controls
node_ui_controls -.->|"requests gameplay"| node_server_entry
node_server_entry -.->|"runs combat"| node_combat
node_server_entry -.->|"handles skills"| node_skills
node_server_entry -.->|"handles quests"| node_quests
node_server_entry -.->|"handles items"| node_inventory
node_server_entry -.->|"handles economy"| node_social
node_server_entry -.->|"runs events"| node_events
node_server_entry -.->|"manages travel"| node_world_service
node_world_service -.->|"configures realms"| node_environment
node_rendering -.->|"renders effects"| node_combat_vfx
node_player -.->|"uses controls"| node_flight_audio
node_shared_config -.->|"configures worlds"| node_world_service
node_server_entry -.->|"manages persistence"| node_player_data
node_player_data -.->|"persists state"| node_datastore
node_server_entry -.->|"runs on platform"| node_roblox
node_rendering -.->|"uses 3D APIs"| node_roblox

click node_client_entry "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/02_HangMuc2_UI_Shop_Config/StarterPlayer/StarterPlayerScripts/SkybreakClient/Main.client.lua"
click node_ui "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/tree/main/04_Roblox/02_HangMuc2_UI_Shop_Config/StarterPlayer/StarterPlayerScripts/SkybreakClient/UI/Screens"
click node_ui_controls "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/tree/main/04_Roblox/02_HangMuc2_UI_Shop_Config/StarterPlayer/StarterPlayerScripts/SkybreakClient/UI/Controllers"
click node_server_entry "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/ServerBootstrap.server.lua"
click node_combat "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakCombatExpansion.lua"
click node_skills "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakSkillMechanicsService.lua"
click node_quests "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/SkybreakServer/QuestService.lua"
click node_inventory "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/SkybreakServer/InventoryService.lua"
click node_social "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakSocialEconomyService.lua"
click node_events "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakWorldEventsService.lua"
click node_world_service "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/WorldService.lua"
click node_environment "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/EnvironmentService.lua"
click node_rendering "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/ReplicatedStorage/DelegatedV5Renderer.lua"
click node_combat_vfx "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/StarterPlayer/StarterPlayerScripts/SkybreakClient/SkybreakSkillVFXEngine.lua"
click node_flight_audio "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/StarterPlayer/StarterPlayerScripts/SkybreakFlightAndCamera.client.lua"
click node_shared_config "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/02_HangMuc2_UI_Shop_Config/ReplicatedStorage/SkybreakShared/Config/WorldConfig.lua"
click node_player_data "https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/PlayerDataService.lua"

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_server_entry,node_combat,node_skills,node_quests,node_inventory,node_social,node_events,node_player_data toneBlue
class node_client_entry,node_ui,node_ui_controls,node_flight_audio,node_datastore toneAmber
class node_world_service,node_environment,node_rendering,node_combat_vfx toneMint
class node_shared_config toneRose
class node_player,node_roblox toneIndigo
```

## Components

### Server Gameplay

- [Server Bootstrap](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/ServerBootstrap.server.lua): `04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/ServerBootstrap.server.lua`
- [Combat Systems](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakCombatExpansion.lua): `04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakCombatExpansion.lua`
- [Skill Mechanics](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakSkillMechanicsService.lua): `04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakSkillMechanicsService.lua`
- [Quest Service](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/SkybreakServer/QuestService.lua): `04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/SkybreakServer/QuestService.lua`
- [Inventory and Crafting](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/SkybreakServer/InventoryService.lua): `04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/SkybreakServer/InventoryService.lua`
- [Social Economy](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakSocialEconomyService.lua): `04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakSocialEconomyService.lua`
- [Live World Events](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakWorldEventsService.lua): `04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/SkybreakWorldEventsService.lua`
- [Player Data](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/PlayerDataService.lua): `04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/PlayerDataService.lua`

### Client Experience

- [Client Bootstrap](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/02_HangMuc2_UI_Shop_Config/StarterPlayer/StarterPlayerScripts/SkybreakClient/Main.client.lua): `04_Roblox/02_HangMuc2_UI_Shop_Config/StarterPlayer/StarterPlayerScripts/SkybreakClient/Main.client.lua`
- [Screens and HUD](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/tree/main/04_Roblox/02_HangMuc2_UI_Shop_Config/StarterPlayer/StarterPlayerScripts/SkybreakClient/UI/Screens): `04_Roblox/02_HangMuc2_UI_Shop_Config/StarterPlayer/StarterPlayerScripts/SkybreakClient/UI/Screens`
- [UI Controllers](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/tree/main/04_Roblox/02_HangMuc2_UI_Shop_Config/StarterPlayer/StarterPlayerScripts/SkybreakClient/UI/Controllers): `04_Roblox/02_HangMuc2_UI_Shop_Config/StarterPlayer/StarterPlayerScripts/SkybreakClient/UI/Controllers`
- [Flight and Audio](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/StarterPlayer/StarterPlayerScripts/SkybreakFlightAndCamera.client.lua): `04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/StarterPlayer/StarterPlayerScripts/SkybreakFlightAndCamera.client.lua`

### World and 3D

- [World and Travel](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/WorldService.lua): `04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/WorldService.lua`
- [Realm Environment](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/EnvironmentService.lua): `04_Roblox/01_HangMuc1_Server_Combat_World/ServerScriptService/Services/EnvironmentService.lua`
- [3D Rendering](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/ReplicatedStorage/DelegatedV5Renderer.lua): `04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/ReplicatedStorage/DelegatedV5Renderer.lua`
- [Combat VFX](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/StarterPlayer/StarterPlayerScripts/SkybreakClient/SkybreakSkillVFXEngine.lua): `04_Roblox/03_HangMuc3_3D_VuKhi_Giap_VFX/StarterPlayer/StarterPlayerScripts/SkybreakClient/SkybreakSkillVFXEngine.lua`

### Shared Systems

- [Shared Configuration](https://github.com/hienkhang2004-coder/skybreak-roblox-rpg/blob/main/04_Roblox/02_HangMuc2_UI_Shop_Config/ReplicatedStorage/SkybreakShared/Config/WorldConfig.lua): `04_Roblox/02_HangMuc2_UI_Shop_Config/ReplicatedStorage/SkybreakShared/Config/WorldConfig.lua`

### Other components

- **Player**
- **Roblox DataStore**
- **Roblox Platform**

## Connections

- Player → Client Bootstrap: starts play (evidence: `README.md`)
- Client Bootstrap → Screens and HUD: presents screens
- Screens and HUD → UI Controllers: supports actions
- UI Controllers → Server Bootstrap: requests gameplay
- Server Bootstrap → Combat Systems: runs combat
- Server Bootstrap → Skill Mechanics: handles skills
- Server Bootstrap → Quest Service: handles quests
- Server Bootstrap → Inventory and Crafting: handles items
- Server Bootstrap → Social Economy: handles economy
- Server Bootstrap → Live World Events: runs events
- Server Bootstrap → World and Travel: manages travel
- World and Travel → Realm Environment: configures realms
- 3D Rendering → Combat VFX: renders effects
- Player → Flight and Audio: uses controls
- Shared Configuration → World and Travel: configures worlds
- Server Bootstrap → Player Data: manages persistence
- Player Data → Roblox DataStore: persists state
- Server Bootstrap → Roblox Platform: runs on platform (evidence: `README.md`)
- 3D Rendering → Roblox Platform: uses 3D APIs (evidence: `README.md`)
