feat: 初始化 UI 框架和资源设计文档

- 新增 TopBarHUD 场景 - 新增开始菜单场景 - 新增通用资源分析设计文档
2026-07-29 23:29:27 +08:00
parent 012aeb3aa0
commit 226d6992e9
3 changed files with 146 additions and 0 deletions
@@ -0,0 +1,117 @@
+# 通用资源分析
+
+根据展示方式，资源分为两大类：
+
+- **通用资源** → 顶部栏（TopBarHUD）常驻显示
+- **稀有资源** → 打开资源面板（ResourcePanel）查看
+
+---
+
+## 一、通用资源（顶部栏常驻显示）
+
+日常使用频繁、数值变化快的核心资源。
+
+| 资源 | 说明 | 用途 |
+|------|------|------|
+| 灵石 | 修仙界通用货币 | 交易、发俸禄、购买物资 |
+| 食物 | 弟子日常消耗 | 农场、种植、采购 |
+| 木材 | 基础建材 | 伐木场、探索 |
+| 石材 | 基础建材 | 采石场、探索 |
+
+---
+
+## 二、稀有资源（面板查看）
+
+无需常驻显示，打开面板浏览。
+
+| 分类 | 资源 | 说明 |
+|------|------|------|
+| 修炼 | 灵草、丹药、功法卷轴 | 炼丹、突破、学习 |
+| 锻造 | 凡矿、灵矿、兽皮/骨 | 打造法器、制甲制符 |
+| 特殊 | 声望、气运、功德 | 外交、事件、渡劫 |
+
+> **贡献度** 不属于全局资源，属于**弟子个人属性**，在弟子详情面板中查看。
+
+---
+
+## 三、资源分类
+
+### 1. 货币类（Currency）
+| 资源 | 说明 | 用途 |
+|------|------|------|
+| 灵石 | 修仙界通用货币 | 交易、发俸禄、购买物资 |
+
+### 2. 基础资源（Basic）
+| 资源 | 说明 | 来源 |
+|------|------|------|
+| 食物 | 弟子日常消耗 | 农场、种植、采购 |
+| 木材 | 基础建材 | 伐木场、探索 |
+| 石材 | 基础建材 | 采石场、探索 |
+| 水源 | 生活必需 | 灵泉、水渠 |
+
+### 3. 修炼资源（Cultivation）
+| 资源 | 说明 | 用途 |
+|------|------|------|
+| 灵气 | 环境灵气浓度 | 修炼速度加成 |
+| 灵草 | 低阶草药 | 炼丹材料 |
+| 丹药 | 成品丹药 | 突破、恢复、增益 |
+| 功法卷轴 | 修炼功法 | 弟子学习 |
+
+### 4. 锻造资源（Crafting）
+| 资源 | 说明 | 用途 |
+|------|------|------|
+| 凡矿 | 普通矿石 | 打造基础器具 |
+| 灵矿 | 蕴含灵力的矿石 | 炼制法器 |
+| 兽皮/骨 | 妖兽材料 | 制甲、制符 |
+
+### 5. 特殊资源（Special）
+| 资源 | 说明 | 用途 |
+|------|------|------|
+| 声望 | 宗门知名度 | 收徒吸引力、外交 |
+| 气运 | 宗门气运值 | 影响随机事件 |
+| 功德 | 天道功德 | 渡劫加成、天材地宝 |
+
+---
+
+## 四、资源属性设计
+
+每个资源实例应包含以下属性：
+- `id`: 唯一标识
+- `name`: 显示名称
+- `icon`: 图标路径
+- `max_stack`: 最大堆叠
+- `display_type`: 展示方式（`TOPBAR` / `PANEL`）
+- `category`: 所属分类
+- `rarity`: 稀有度（普通/稀有/传说）
+
+```gdscript
+enum DisplayType {
+    TOPBAR,  # 顶部栏常驻
+    PANEL    # 面板查看
+}
+
+enum ResourceCategory {
+    CURRENCY,      # 货币
+    BASIC,         # 基础
+    CULTIVATION,   # 修炼
+    CRAFTING,      # 锻造
+    SPECIAL        # 特殊
+}
+```
+
+---
+
+## 五、资源管理系统建议
+
+- 使用 `ResourceData` 资源文件（Scriptable Object 模式）定义每个资源
+- 使用 `ResourceManager` 单例统一管理增减
+- 支持 emit 信号，UI 自动响应数值变化
+
+---
+
+## 六、后续可扩展资源
+
+- 灵兽蛋 / 灵兽材料
+- 阵法材料（阵旗、符石）
+- 秘境钥匙 / 地图碎片
+- 宗门特产（专属资源）
@@ -0,0 +1,13 @@
+[gd_scene format=3 uid="uid://dl0tb68vsw3c6"]
+
+[node name="TopBarHud" type="Control" unique_id=1115394694]
+layout_mode = 3
+anchors_preset = 0
+
+[node name="HBoxContainer" type="HBoxContainer" parent="." unique_id=1608257100]
+layout_mode = 0
+offset_right = 40.0
+offset_bottom = 40.0
+
+[node name="Currency" type="Label" parent="HBoxContainer" unique_id=766096596]
+layout_mode = 2
@@ -0,0 +1,16 @@
+[gd_scene format=3 uid="uid://bkatopgh40fte"]
+
+[ext_resource type="PackedScene" uid="uid://dl0tb68vsw3c6" path="res://src/UI/HUD/TopBarHUD.tscn" id="1_jy7gm"]
+
+[node name="StartMenu" type="Control" unique_id=1272477823]
+layout_mode = 3
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+
+[node name="TopBarHud" parent="." unique_id=1115394694 instance=ExtResource("1_jy7gm")]
+custom_minimum_size = Vector2(100, 100)
+custom_maximum_size = Vector2(100, 100)
+layout_mode = 0