From 41e73da6317af34147550628f2a28c6578b98027 Mon Sep 17 00:00:00 2001 From: ud18010 Date: Thu, 30 Jul 2026 15:16:25 +0800 Subject: [PATCH] docs: document actor behavior config locations --- .../ActorBehavior/BehaviorConfigCatalogTests.cs | 2 +- .../plans/2026-07-30-actor-behavior-system.md | 16 ++++++++-------- .../2026-07-30-actor-behavior-system-design.md | 14 +++++++++++++- 3 files changed, 22 insertions(+), 10 deletions(-) diff --git a/Server/Framework.Shared.Tests/ActorBehavior/BehaviorConfigCatalogTests.cs b/Server/Framework.Shared.Tests/ActorBehavior/BehaviorConfigCatalogTests.cs index 98d0a237..0fd84fb2 100644 --- a/Server/Framework.Shared.Tests/ActorBehavior/BehaviorConfigCatalogTests.cs +++ b/Server/Framework.Shared.Tests/ActorBehavior/BehaviorConfigCatalogTests.cs @@ -108,7 +108,7 @@ namespace XWorld.Framework.Tests.ActorBehavior public void ExampleConfigFiles_LoadFromRepository() { string root = FindRepoRoot(); - string dir = System.IO.Path.Combine(root, "Client", "Assets", "Resources", "Config", "ActorBehavior"); + string dir = System.IO.Path.Combine(root, "Client", "Assets", "Game", "Config", "ActorBehavior"); BehaviorConfigCatalog catalog = BehaviorConfigCatalog.LoadFromJson( "fighter", diff --git a/docs/superpowers/plans/2026-07-30-actor-behavior-system.md b/docs/superpowers/plans/2026-07-30-actor-behavior-system.md index 9bf8d883..13bb867b 100644 --- a/docs/superpowers/plans/2026-07-30-actor-behavior-system.md +++ b/docs/superpowers/plans/2026-07-30-actor-behavior-system.md @@ -36,11 +36,11 @@ Create: - 配置加载、索引和校验。 - `Client/Assets/Framework/Shared/ActorBehavior/BehaviorWorld.cs` - 行为、飞行物、Buff、逻辑效果运行时。 -- `Client/Assets/Resources/Config/ActorBehavior/fighter_skill.json` +- `Client/Assets/Game/Config/ActorBehavior/fighter_skill.json` - 示例技能配置。 -- `Client/Assets/Resources/Config/ActorBehavior/fighter_flyobj.json` +- `Client/Assets/Game/Config/ActorBehavior/fighter_flyobj.json` - 示例飞行物配置。 -- `Client/Assets/Resources/Config/ActorBehavior/fighter_buff.json` +- `Client/Assets/Game/Config/ActorBehavior/fighter_buff.json` - 示例 Buff 配置。 - `Server/Framework.Shared.Tests/ActorBehavior/BehaviorConfigCatalogTests.cs` - 配置解析和校验测试。 @@ -665,9 +665,9 @@ Expected: PASS. ## Task 6: 示例配置、全量验证和 cleanup **Files:** -- Create: `Client/Assets/Resources/Config/ActorBehavior/fighter_skill.json` -- Create: `Client/Assets/Resources/Config/ActorBehavior/fighter_flyobj.json` -- Create: `Client/Assets/Resources/Config/ActorBehavior/fighter_buff.json` +- Create: `Client/Assets/Game/Config/ActorBehavior/fighter_skill.json` +- Create: `Client/Assets/Game/Config/ActorBehavior/fighter_flyobj.json` +- Create: `Client/Assets/Game/Config/ActorBehavior/fighter_buff.json` - Modify: all new actor behavior files as needed after refactor - Test: `Server/Framework.Shared.Tests/ActorBehavior/BehaviorConfigCatalogTests.cs` @@ -684,7 +684,7 @@ Add to `BehaviorConfigCatalogTests.cs`: public void ExampleConfigFiles_LoadFromRepository() { string root = FindRepoRoot(); - string dir = System.IO.Path.Combine(root, "Client", "Assets", "Resources", "Config", "ActorBehavior"); + string dir = System.IO.Path.Combine(root, "Client", "Assets", "Game", "Config", "ActorBehavior"); BehaviorConfigCatalog catalog = BehaviorConfigCatalog.LoadFromJson( "fighter", @@ -749,7 +749,7 @@ Expected: PASS. Run: ```powershell -git diff -- Client/Assets/Framework/Shared/ActorBehavior Server/Framework.Shared.Tests/ActorBehavior Client/Assets/Resources/Config/ActorBehavior +git diff -- Client/Assets/Framework/Shared/ActorBehavior Server/Framework.Shared.Tests/ActorBehavior Client/Assets/Game/Config/ActorBehavior ``` Expected: only actor behavior core, tests, and example config files changed. diff --git a/docs/superpowers/specs/2026-07-30-actor-behavior-system-design.md b/docs/superpowers/specs/2026-07-30-actor-behavior-system-design.md index f8f9446b..87734420 100644 --- a/docs/superpowers/specs/2026-07-30-actor-behavior-system-design.md +++ b/docs/superpowers/specs/2026-07-30-actor-behavior-system-design.md @@ -12,7 +12,7 @@ - `Server/Framework.Shared/Framework.Shared.csproj` 会从客户端共享目录编译同一份源码。 - 小游戏 Core 代码也使用同源模式：`scripts~` 目录同时被客户端和服务端项目编译。 - 已有虚拟 HUD 输入系统只负责输出摇杆和按钮事件，不负责技能协议或技能执行。角色行为系统位于输入层之后，把输入转换为行为请求。 -- 客户端已有 `Client/Assets/Resources/Config` 配置目录先例；服务端需要通过文件或字符串读取同一套 JSON 内容。 +- 通用行为配置放在 `Client/Assets/Game/Config/ActorBehavior`；小游戏私有行为配置放在对应小游戏目录下的 `Config/ActorBehavior`，例如 `Client/Assets/MiniGames/RockPaperScissors/Config/ActorBehavior`。服务端需要通过文件或字符串读取同一套 JSON 内容。 ## 推荐方案 @@ -187,6 +187,18 @@ fighter_flyobj.json fighter_buff.json ``` +通用大厅/全局角色配置放在： + +```text +Client/Assets/Game/Config/ActorBehavior/ +``` + +小游戏独有角色配置放在： + +```text +Client/Assets/MiniGames//Config/ActorBehavior/ +``` + 所有文件都包含： - `type`：角色类型名，例如 `fighter`。