TheDemiuge — Agent 驱动的 RPG 框架

返回项目列表
TheDemiuge — Agent 驱动的 RPG 框架
开发中
UE5/C++/Go/AI Agent/MCP/游戏框架

用 UE5.8 + C++ 写一个分层解耦的 RPG 游戏本体,配一个 Go 实现的 AI 通信桥(ReAct + MCP + SSE)驱动 NPC 决策。后端已完成,当前重心在游戏本体的系统架构。

它是什么#

一个 Agent 驱动的 RPG。 由两个独立项目组成:

  • TheDemiugeUE5 —— UE5.8 + C++ 的游戏本体,当前主战场
  • TheDemiuge-Bridge —— Go 写的 AI 通信桥,负责把大模型接进游戏(已完成)

一般的 AI-NPC demo 都停在「接上一个对话接口」。这里想做的是另一件事:让 NPC 的行为由 Agent 实时驱动,而这件事的前提是先有一个系统之间足够解耦、状态足够可控的游戏本体。所以重心放在了本体架构上。

游戏本体:L0 ~ L10 分层架构#

Docs/ARCHITECTURE.md 定下的十一层结构,编译期依赖严格单向向下:

层内容
L0基础层:时钟 / 句柄 / 事件总线 / 配置
L1 / L2实体 / 属性与修饰器(数值)
L3 / L4条件引擎 / 物品(定义与实例分离)
L5行为层:Effect —— 唯一的状态变更通道
L6 / L7世界标记 / 叙事任务
L8Agent 层:NPC 决策接入
L9 / L10表现层 / 横切层(存档等)

几条贯穿全局的约束:

  • 时间是「可推进的累计量」,不是系统时钟——睡觉跳过 8 小时,冷却要跟着结束
  • 时效性数据存绝对时间戳,绝不存「剩余时长」
  • Effect 是唯一的状态变更通道,事件总线只通知、不改状态
  • Agent 四条硬约束:只读只提议 / 知识视图(信息隔离)/ 版本戳(乐观并发)/ 仲裁失败要有反馈回路
  • 存档策略:全量快照 + Effect 日志增量

AI 侧:Go 通信桥(已完成)#

TheDemiuge-Bridge(Go + Hertz)7 层模块(server / service / agent / tool / llm / memory / config):

  • ReAct 对话循环 + 工具调用,HTTP SSE 全链路流式返回
  • MCP 注册中心:mcp.Registry 接口把依赖方向反转,工具注册与推理逻辑解耦,方便对接不同引擎
  • 通信层设计成引擎无关——UE5 只是第一个前端

一个主动砍掉的方向#

模型端不做了。 早期设想过端侧轻量模型 + LoRA 蒸馏做 NPC 记忆,后来判断过之后放弃:

  • 玩家机器不可控——卡不卡、跑不跑得完、炸了能不能回滚,全都不可控
  • 自研模型的复杂度会持续挤压真正难的部分:游戏本体的系统架构

所以 AI 侧收敛成「调外部 LLM API + 工程化的记忆管理」,接口留了可替换后端。取舍的标准很简单:哪些是这游戏非做不可的,哪些只是听着酷。

进度#

  • ✅ Bridge 后端完成:ReAct 对话 + MCP 注册中心 + SSE 全链路
  • ✅ 游戏本体:架构文档 rev.2 + 进度跟进机制(事实快照脚本 + 人工台账分离)
  • 🔄 游戏本体 L0 基础层:GameClockSubsystem 时间系统已跑通初版(固定步长 + 时间刻 Slot 事件容器 + 时间对齐)
  • ⏭ 下一步:事件总线 → 配置数据层 → 句柄/生命周期,然后进 L1 实体与 L2 数值层

一点体会#

先写清楚「哪些层不许互相依赖」,比先写出能跑的功能重要得多。这一个项目里最花时间的不是写代码,是决定状态到底归谁管。

Profile Image of the Author
热尘
游戏开发者 · AI 爱好者
公告
欢迎来到我的博客!这是一则示例公告。
分类
标签
站点统计
文章
38
分类
5
标签
12
总字数
46,029
运行时长
0 天
最后活动
0 天前
站点信息
构建平台
GitHub Actions
博客版本
Firefly v6.16.8
文章许可
CC BY-NC-SA 4.0
文章目录