SectSimulator/doc/design/通用资源分析.md

通用资源分析

根据展示方式，资源分为两大类：

• 通用资源 → 顶部栏（TopBarHUD）常驻显示
• 稀有资源 → 打开资源面板（ResourcePanel）查看

---

一、通用资源（顶部栏常驻显示）

日常使用频繁、数值变化快的核心资源。

资源	说明	用途
灵石	修仙界通用货币	交易、发俸禄、购买物资
食物	弟子日常消耗	农场、种植、采购
木材	基础建材	伐木场、探索
石材	基础建材	采石场、探索

---

二、稀有资源（面板查看）

无需常驻显示，打开面板浏览。

分类	资源	说明
修炼	灵草、丹药、功法卷轴	炼丹、突破、学习
锻造	凡矿、灵矿、兽皮/骨	打造法器、制甲制符
特殊	声望、气运、功德	外交、事件、渡劫

贡献度 不属于全局资源，属于弟子个人属性，在弟子详情面板中查看。

---

三、资源分类

1. 货币类（Currency）

资源	说明	用途
灵石	修仙界通用货币	交易、发俸禄、购买物资

2. 基础资源（Basic）

资源	说明	来源
食物	弟子日常消耗	农场、种植、采购
木材	基础建材	伐木场、探索
石材	基础建材	采石场、探索
水源	生活必需	灵泉、水渠

3. 修炼资源（Cultivation）

资源	说明	用途
灵气	环境灵气浓度	修炼速度加成
灵草	低阶草药	炼丹材料
丹药	成品丹药	突破、恢复、增益
功法卷轴	修炼功法	弟子学习

4. 锻造资源（Crafting）

资源	说明	用途
凡矿	普通矿石	打造基础器具
灵矿	蕴含灵力的矿石	炼制法器
兽皮/骨	妖兽材料	制甲、制符

5. 特殊资源（Special）

资源	说明	用途
声望	宗门知名度	收徒吸引力、外交
气运	宗门气运值	影响随机事件
功德	天道功德	渡劫加成、天材地宝

---

四、资源属性设计

每个资源实例应包含以下属性：

• id: 唯一标识
• name: 显示名称
• icon: 图标路径
• max_stack: 最大堆叠
• display_type: 展示方式（TOPBAR / PANEL）
• category: 所属分类
• rarity: 稀有度（普通/稀有/传说）

enum DisplayType {
	TOPBAR,  # 顶部栏常驻
	PANEL    # 面板查看
}

enum ResourceCategory {
	CURRENCY,      # 货币
	BASIC,         # 基础
	CULTIVATION,   # 修炼
	CRAFTING,      # 锻造
	SPECIAL        # 特殊
}

---

五、资源管理系统建议

• 使用 ResourceData 资源文件（Scriptable Object 模式）定义每个资源
• 使用 ResourceManager 单例统一管理增减
• 支持 emit 信号，UI 自动响应数值变化

---

六、后续可扩展资源

• 灵兽蛋 / 灵兽材料
• 阵法材料（阵旗、符石）
• 秘境钥匙 / 地图碎片
• 宗门特产（专属资源）