Files
Oshima-Game/src/README.md
T
2026-09-19 17:24:02 +08:00

1.8 KiB
Raw Blame History

OSM Godot 客户端

这里是《筽祀牻》的 Godot C# 客户端源码。仓库根目录是 Godot 工程根目录,因此现有素材可通过 res://assets/... 直接访问。

当前边界

  • 客户端只显示权威快照并提交玩家意图,不计算伤害、命中或行动是否合法。
  • 不直接依赖 FunGame.Core、OshimaGameModules 或服务器内部对象。
  • 单人、房主和专用服务器都通过 IGameTransport 复用同一套客户端状态流。
  • 战斗场景采用 2D 二等角逻辑格,默认规格为 16 × 12、单格 128 × 64。

目录

src/
├─ Autoload/       全局会话、状态仓库、素材、路由与设置
├─ Contracts/      网络信封、DTO 与玩家意图
├─ Networking/     WebSocket 与 Mock 传输
├─ Resources/      运行时资源清单
├─ Screens/        主场景和战斗场景
└─ World/          二等角投影、网格显示和相机

启动

使用 Godot 4.7 .NET 打开仓库根目录的 project.godot。当前客户端会进入灰盒战斗场景,并默认连接:

ws://localhost:11030/ws/solo

先启动 FunGame.Testing-v3/WebAPI,再在右上角点击“连接”和“开始新局”。客户端目前支持:

  • system.ping / system.pong 心跳;
  • gaming.start、gaming.state、gaming.request 和 gaming.action;
  • 角色选择、基础行动类型、技能/物品/目标选择与逻辑格选择;
  • HUD 根据服务器权威快照更新回合、队列、角色资源和决策点。

可使用以下参数运行只在开发环境触发的连接冒烟测试:

Godot_v4.7-stable_mono_win64_console.exe --headless --path <项目目录> -- --solo-smoke-test

测试会自动连接、开局、选择首个候选角色并等待首个权威快照;成功时输出 SOLO_SMOKE_OK。