# ctnstudio/stoneadventure architecture

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

- Interactive diagram: https://gitdiagram.com/ctnstudio/stoneadventure
- Repository: https://github.com/ctnstudio/stoneadventure

## Overview

This is a Minecraft Bedrock add-on combining stone-themed crafting progression with an adventure layer. Players gather stone resources or defeat stone creatures, craft progressively stronger tools and armor, and explore structures and biomes for loot and boss challenges. The behavior pack supplies gameplay data and scripts; the resource pack supplies presentation assets. The graph includes documented capabilities and sampled script relationships; many JSON data assets were not inspected, so their internal wiring is shown only where the README supports it.

Main entry points: [`磐石之旅BP/scripts/quests/quests_core.js`](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/quests/quests_core.js) (Quest Progress), [`磐石之旅BP/items`](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/items) (Items And Blocks), [`磐石之旅BP/scripts/forge/forge_core.js`](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/forge/forge_core.js) (Forge Mechanics), [`磐石之旅BP/scripts`](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts) (Gameplay Scripts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_progression["Crafting Progression"]
  node_item_block_data["Items And Blocks"]
  node_crafting_recipes["Crafting Recipes"]
  node_work_tables["Stone Worktables"]
  node_forge["Forge Mechanics<br/>[forge_core.js]"]
  node_forge_util["Forge Utilities<br/>[forge_utils.js]"]
  node_forge_effects["Combat Effects<br/>[weapon_effects.js]"]
end

subgraph group_world["World And Encounters"]
  node_biomes["Stone Biomes"]
  node_structures["World Structures"]
  node_spawns["Creature Spawns"]
  node_creatures["Stone Creatures"]
  node_loot["Loot Tables"]
  node_boss_summon["Boss Summoning"]
end

subgraph group_player["Player Systems"]
  node_quests["Quest Progress<br/>[quests_core.js]"]
  node_quest_ui["Quest Menus<br/>[quests_ui.js]"]
  node_weekly["Weekly Quests<br/>[weekly_routine.js]"]
  node_shop["Stone Coin Shop<br/>[shop.js]"]
  node_stone_points["Stone Points<br/>[stone_point.js]"]
  node_stone_heart["Stone Heart"]
end

subgraph group_runtime["Behavior Runtime"]
  node_gameplay_scripts["Gameplay Scripts"]
end

subgraph group_presentation["Resource Presentation"]
  node_resource_assets["Models And Textures"]
end

node_player_actor(("Player"))
node_bedrock(("Bedrock Engine"))

node_player_actor -->|"plays in"| node_bedrock
node_bedrock -.->|"loads content"| node_item_block_data
node_player_actor -->|"gathers resources"| node_item_block_data
node_item_block_data -->|"used in crafting"| node_crafting_recipes
node_player_actor -->|"crafts gear"| node_crafting_recipes
node_crafting_recipes -->|"uses stations"| node_work_tables
node_player_actor -.->|"uses forge"| node_forge
node_forge -->|"uses helpers"| node_forge_util
node_forge -.->|"applies upgrades"| node_forge_effects
node_forge_effects -.->|"uses helpers"| node_forge_util
node_bedrock -->|"generates terrain"| node_biomes
node_biomes -.->|"places features"| node_structures
node_bedrock -->|"spawns creatures"| node_spawns
node_spawns -.->|"selects entities"| node_creatures
node_player_actor -->|"fights"| node_creatures
node_creatures -->|"drops loot"| node_loot
node_player_actor -->|"explores"| node_structures
node_structures -->|"contains rewards"| node_loot
node_player_actor -.->|"summons boss"| node_boss_summon
node_player_actor -->|"advances tasks"| node_quests
node_quests -->|"provides quest data"| node_quest_ui
node_player_actor -->|"opens menus"| node_quest_ui
node_quests -->|"checks progress"| node_weekly
node_player_actor -->|"trades items"| node_shop
node_shop -->|"reads and spends"| node_stone_points
node_shop -->|"grants items"| node_quests
node_player_actor -.->|"uses heart system"| node_stone_heart
node_gameplay_scripts -->|"subscribes events"| node_bedrock
node_gameplay_scripts -->|"loads module"| node_quests
node_gameplay_scripts -->|"initializes forge"| node_forge
node_item_block_data -.->|"uses visuals"| node_resource_assets

click node_item_block_data "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/items"
click node_crafting_recipes "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/recipes"
click node_work_tables "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/blocks"
click node_forge "https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/forge/forge_core.js"
click node_forge_util "https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/forge/forge_utils.js"
click node_forge_effects "https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/forge/weapon_effects.js"
click node_biomes "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/biomes"
click node_structures "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/features"
click node_spawns "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/spawn_rules"
click node_creatures "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/entities"
click node_loot "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/loot_tables"
click node_boss_summon "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/summon_boss"
click node_quests "https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/quests/quests_core.js"
click node_quest_ui "https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/quests/quests_ui.js"
click node_weekly "https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/quests/weekly_routine.js"
click node_shop "https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/shop/shop.js"
click node_stone_points "https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/stone_point.js"
click node_stone_heart "https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/stone_heart/stone_heart_core.js"
click node_gameplay_scripts "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts"
click node_resource_assets "https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85RP/textures"

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_item_block_data,node_crafting_recipes,node_work_tables,node_forge,node_forge_util,node_forge_effects toneBlue
class node_biomes,node_structures,node_spawns,node_creatures,node_loot,node_boss_summon toneAmber
class node_quests,node_quest_ui,node_weekly,node_shop,node_stone_points,node_stone_heart toneMint
class node_gameplay_scripts toneRose
class node_resource_assets,node_player_actor,node_bedrock toneIndigo
```

## Components

### Crafting Progression

- [Items And Blocks](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/items): `磐石之旅BP/items`
- [Crafting Recipes](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/recipes): `磐石之旅BP/recipes`
- [Stone Worktables](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/blocks): `磐石之旅BP/blocks`
- [Forge Mechanics](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/forge/forge_core.js): `磐石之旅BP/scripts/forge/forge_core.js`
- [Forge Utilities](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/forge/forge_utils.js): `磐石之旅BP/scripts/forge/forge_utils.js`
- [Combat Effects](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/forge/weapon_effects.js): `磐石之旅BP/scripts/forge/weapon_effects.js`

### World And Encounters

- [Stone Biomes](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/biomes): `磐石之旅BP/biomes`
- [World Structures](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/features): `磐石之旅BP/features`
- [Creature Spawns](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/spawn_rules): `磐石之旅BP/spawn_rules`
- [Stone Creatures](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/entities): `磐石之旅BP/entities`
- [Loot Tables](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/loot_tables): `磐石之旅BP/loot_tables`
- [Boss Summoning](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/summon_boss): `磐石之旅BP/scripts/summon_boss`

### Player Systems

- [Quest Progress](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/quests/quests_core.js): `磐石之旅BP/scripts/quests/quests_core.js`
- [Quest Menus](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/quests/quests_ui.js): `磐石之旅BP/scripts/quests/quests_ui.js`
- [Weekly Quests](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/quests/weekly_routine.js): `磐石之旅BP/scripts/quests/weekly_routine.js`
- [Stone Coin Shop](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/shop/shop.js): `磐石之旅BP/scripts/shop/shop.js`
- [Stone Points](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/stone_point.js): `磐石之旅BP/scripts/stone_point.js`
- [Stone Heart](https://github.com/ctnstudio/stoneadventure/blob/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts/stone_heart/stone_heart_core.js): `磐石之旅BP/scripts/stone_heart/stone_heart_core.js`

### Behavior Runtime

- [Gameplay Scripts](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85BP/scripts): `磐石之旅BP/scripts`

### Resource Presentation

- [Models And Textures](https://github.com/ctnstudio/stoneadventure/tree/master/%E7%A3%90%E7%9F%B3%E4%B9%8B%E6%97%85RP/textures): `磐石之旅RP/textures`

### Other components

- **Player**
- **Bedrock Engine**

## Connections

- Player → Bedrock Engine: plays in (evidence: `README.md`)
- Bedrock Engine → Items And Blocks: loads content
- Player → Items And Blocks: gathers resources (evidence: `README.md`)
- Items And Blocks → Crafting Recipes: used in crafting (evidence: `README.md`)
- Player → Crafting Recipes: crafts gear (evidence: `README.md`)
- Crafting Recipes → Stone Worktables: uses stations (evidence: `README.md`)
- Player → Forge Mechanics: uses forge
- Forge Mechanics → Forge Utilities: uses helpers (evidence: `磐石之旅BP/scripts/forge/forge_core.js`)
- Forge Mechanics → Combat Effects: applies upgrades
- Combat Effects → Forge Utilities: uses helpers (evidence: `磐石之旅BP/scripts/forge/weapon_effects.js`)
- Bedrock Engine → Stone Biomes: generates terrain (evidence: `README.md`)
- Stone Biomes → World Structures: places features
- Bedrock Engine → Creature Spawns: spawns creatures (evidence: `README.md`)
- Creature Spawns → Stone Creatures: selects entities
- Player → Stone Creatures: fights (evidence: `README.md`)
- Stone Creatures → Loot Tables: drops loot (evidence: `README.md`)
- Player → World Structures: explores (evidence: `README.md`)
- World Structures → Loot Tables: contains rewards (evidence: `README.md`)
- Player → Boss Summoning: summons boss
- Player → Quest Progress: advances tasks (evidence: `磐石之旅BP/scripts/quests/quests_core.js`)
- Quest Progress → Quest Menus: provides quest data (evidence: `磐石之旅BP/scripts/quests/quests_ui.js`)
- Player → Quest Menus: opens menus (evidence: `磐石之旅BP/scripts/quests/quests_ui.js`)
- Quest Progress → Weekly Quests: checks progress (evidence: `磐石之旅BP/scripts/quests/quests_core.js`)
- Player → Stone Coin Shop: trades items (evidence: `磐石之旅BP/scripts/shop/shop.js`)
- Stone Coin Shop → Stone Points: reads and spends (evidence: `磐石之旅BP/scripts/shop/shop.js`)
- Stone Coin Shop → Quest Progress: grants items (evidence: `磐石之旅BP/scripts/shop/shop.js`)
- Player → Stone Heart: uses heart system
- Gameplay Scripts → Bedrock Engine: subscribes events (evidence: `磐石之旅BP/scripts/index.js`)
- Gameplay Scripts → Quest Progress: loads module (evidence: `磐石之旅BP/scripts/index.js`)
- Gameplay Scripts → Forge Mechanics: initializes forge (evidence: `磐石之旅BP/scripts/index.js`)
- Items And Blocks → Models And Textures: uses visuals
