docs: audit and fix standards docs inconsistencies (v1.2)
AssetFolderSpec.md:
- §8.1: Enemies_{Region} → Enemies (match AddressableRules.cs single group)
- §8.4: fix old menu paths (Tools/Verification → Addressables)
- §10.3: fix Skill SO path (Data/Player/Skills → Data/Progression/Skills)
- §10.4: Charm workflow — remove 'bypass editor tools' recommendation
- §3.2: add SPL_ prefix for SpellSO
- Bump to v1.2
AddressablesLabelSpec.md:
- §6 step 7: fix old Verification menu path
- §7.2/7.3/7.4: unify menu notation (→ to /) and fix old Tools/Verification paths
- Bump to v1.2
AddressKeys.cs:
- Remove duplicate <summary> XML doc comment in Labels class
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# 资源文件夹目录规划与管理规范
|
||||
|
||||
> **版本**:1.1
|
||||
> **版本**:1.2
|
||||
> **创建日期**:2026-05
|
||||
> **适用范围**:`Assets/` 目录下所有非代码资源(美术、数据、预制体、场景等)
|
||||
> **资源管理系统**:Unity Addressables(禁止使用 `Resources.Load`)
|
||||
@@ -274,6 +274,7 @@ Data/
|
||||
| `ENM_` | 敌人 | `ENM_E001_Stats.asset` |
|
||||
| `WPN_` | 武器 | `WPN_SkyBlade.asset` |
|
||||
| `SKL_` | 技能/法术 | `SKL_SoulBlade.asset` |
|
||||
| `SPL_` | 法术(Spell) | `SPL_Fireball.asset` |
|
||||
| `CHM_` | 护身符 | `CHM_GhostMantis.asset` |
|
||||
| `SHP_` | 商店 | `SHP_Inventory_Forest.asset` |
|
||||
| `MAP_` | 地图 | `MAP_RoomData_Forest_01.asset` |
|
||||
@@ -472,7 +473,7 @@ UI Toolkit/
|
||||
| `VFX_Common` | 通用高频特效(HitSpark、BloodSplat 等) | Local | 启动时预加载 |
|
||||
| `Collectibles` | 收集物 Prefab(Geo、Item、HPOrb) | Local | 启动时预加载 |
|
||||
| `Projectiles` | 抛射物 Prefab | Local | 启动时预加载 |
|
||||
| `Enemies_{Region}` | 该区域的敌人 Prefab | Local | 进入区域时加载 |
|
||||
| `Enemies` | 所有敌人 Prefab(`ENM_*`) | Local | 进入区域时加载 |
|
||||
| `Room_{Region}` | 该区域的关卡场景 + 区域专属资产 | Local | 进入区域时加载 |
|
||||
| `Boss_{Name}` | Boss 专属 Prefab + 场景 | Local | Boss 战开始前加载 |
|
||||
| `Audio_Music` | BGM 音频(FMOD bank 引用) | Remote(可选)| 按需流式加载 |
|
||||
@@ -538,11 +539,11 @@ Config/DifficultyEasy
|
||||
```
|
||||
1. 在 Project 中创建/导入资产
|
||||
2. 在 AddressKeys.cs 中添加对应 const 字符串
|
||||
3. 在 AddressableBatchTool(菜单 BaseGames → Tools → Addressable Batch Tool)中:
|
||||
3. 在 AddressableBatchTool(菜单 `BaseGames/Addressables/Addressable Batch Tool`)中:
|
||||
a. 切换到 "① 同步 AddressKeys" 标签
|
||||
b. 点击 "Scan" 找到未注册的 Key
|
||||
c. 选择目标 Group,点击 "Register" 完成注册
|
||||
4. 运行 AddressKeyValidator(菜单 BaseGames → Verification → Validate Address Keys)
|
||||
4. 运行 AddressKeyValidator(菜单 `BaseGames/Addressables/Validate Address Keys`)
|
||||
确认无 Missing / Mismatch 警告
|
||||
5. 提交 AddressKeys.cs 和 AddressableAssetSettings.asset 的修改
|
||||
```
|
||||
@@ -683,7 +684,7 @@ var (prefab, _) = await AssetLoader.LoadAsync<GameObject>(AddressKeys.PrefabPlay
|
||||
```
|
||||
1. 在 _Game/Art/Characters/Player/{FormID}/Animations/ 下创建技能动画片段(.anim)
|
||||
2. 在 Skill Editor(菜单 BaseGames/Data/Skill Editor)左栏 [New] 创建 SKL_{SkillID}_Data.asset
|
||||
- 路径:_Game/Data/Player/Skills/SKL_{SkillID}_Data.asset
|
||||
- 路径:`_Game/Data/Progression/Skills/SKL_{SkillID}_Data.asset`
|
||||
- 命名:SKL_{SkillID}(示例:SKL_DashSlash、SKL_SpiritWave)
|
||||
3. 使用 Skill HitBox Wizard(菜单 BaseGames/Create/Skill HitBox Prefab)生成
|
||||
_Game/Prefabs/Skills/SKL_{SkillID}_HitBox.prefab(支持多段伤害配置)
|
||||
@@ -693,10 +694,11 @@ var (prefab, _) = await AssetLoader.LoadAsync<GameObject>(AddressKeys.PrefabPlay
|
||||
|
||||
### 10.4 新增护身符(Charm)
|
||||
|
||||
> **推荐工具**:直接在 Project 窗口 Create → 对应 CharmSO,然后通过 CharmSOEditor(Custom Inspector)配置效果类型与参数。
|
||||
> **推荐工具**:`BaseGames → Data → Character Wizard`(切换到 Charm 标签)或直接在 Project 窗口 右键 → Create,使用 `CharmSOEditor`(Custom Inspector)配置,**必须确保路径为 `_Game/Data/Progression/Charms/`,命名为 `CHM_{Name}.asset`**;若护身符类型较多,建议在 §12 中增加专属 Charm Editor 入口以强制规范。
|
||||
|
||||
```
|
||||
1. 在 _Game/Data/Progression/Charms/ 下创建 CHM_{Name}.asset(CharmSO)
|
||||
1. 使用 Character Wizard(菜单 BaseGames/Data/Character Wizard → Charm 标签)创建 CHM_{Name}.asset
|
||||
- 路径:_Game/Data/Progression/Charms/CHM_{Name}.asset
|
||||
- 命名:CHM_{Name}(示例:CHM_SoulReaper、CHM_IronSkin)
|
||||
2. 在 Inspector 中通过 CharmSOEditor 下拉选择效果类型并配置参数
|
||||
3. 在 AddressKeys.cs 中添加 DataCharm{Name} 常量
|
||||
|
||||
Reference in New Issue
Block a user