first commit

This commit is contained in:
2026-09-19 17:24:02 +08:00
commit afb343aa49
109 changed files with 13011 additions and 0 deletions
+45
View File
@@ -0,0 +1,45 @@
# OSM Godot 客户端
这里是《筽祀牻》的 Godot C# 客户端源码。仓库根目录是 Godot 工程根目录,因此现有素材可通过 `res://assets/...` 直接访问。
## 当前边界
- 客户端只显示权威快照并提交玩家意图,不计算伤害、命中或行动是否合法。
- 不直接依赖 `FunGame.Core`、`OshimaGameModules` 或服务器内部对象。
- 单人、房主和专用服务器都通过 `IGameTransport` 复用同一套客户端状态流。
- 战斗场景采用 2D 二等角逻辑格,默认规格为 16 × 12、单格 128 × 64。
## 目录
```text
src/
├─ Autoload/ 全局会话、状态仓库、素材、路由与设置
├─ Contracts/ 网络信封、DTO 与玩家意图
├─ Networking/ WebSocket 与 Mock 传输
├─ Resources/ 运行时资源清单
├─ Screens/ 主场景和战斗场景
└─ World/ 二等角投影、网格显示和相机
```
## 启动
使用 Godot 4.7 .NET 打开仓库根目录的 `project.godot`。当前客户端会进入灰盒战斗场景,并默认连接:
```text
ws://localhost:11030/ws/solo
```
先启动 `FunGame.Testing-v3/WebAPI`,再在右上角点击“连接”和“开始新局”。客户端目前支持:
- `system.ping` / `system.pong` 心跳;
- `gaming.start`、`gaming.state`、`gaming.request` 和 `gaming.action`;
- 角色选择、基础行动类型、技能/物品/目标选择与逻辑格选择;
- HUD 根据服务器权威快照更新回合、队列、角色资源和决策点。
可使用以下参数运行只在开发环境触发的连接冒烟测试:
```text
Godot_v4.7-stable_mono_win64_console.exe --headless --path <项目目录> -- --solo-smoke-test
```
测试会自动连接、开局、选择首个候选角色并等待首个权威快照;成功时输出 `SOLO_SMOKE_OK`。