EricSun0218/OpenGameAgent
EricSun0218/OpenGameAgent has 61 GitHub stars and 9 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 21:16 UTC. Last push 2026-11-13.
实测星标增长
- 24小时
- 0
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
MIT-licensed TypeScript runtime for AI-native game characters and worlds, with durable state, reliable actions, memory, tools, and Unity, Godot, and Unreal Engine integrations.
人工智能README.zh-CN.md
原文OpenGameAgent
OpenGameAgent 是面向 AI 原生游戏角色与世界的 TypeScript 运行时,采用 MIT 许可证。 框架负责 Agent 循环、运行控制、持久化与工具调用;游戏负责规则、权限和权威世界状态。
当前为持续开发中的源码预览版。接入项目时请固定 Git 提交,不要将历史 C# 发布包与当前源码混用。
快速开始
准备 Node.js 24.15.0(见 .nvmrc)和 npm 11.12.1:
git clone https://github.com/EricSun0218/OpenGameAgent.git
cd OpenGameAgent
npm ci
npm run build
npm run example:local
本地示例 会注册一个角色、提交游戏输入并打印回复。 示例使用确定性的模型替身与内存事件存储,不需要 API Key,也不会调用外部服务。 真实游戏接入请阅读开发者集成说明,配置模型与凭据、SQLite 持久化、工具权限和游戏动作。
TypeScript 工作区目前以源码形式提供。package.json 中的 private: true 用来防止意外发布到 npm,
不限制 MIT 许可证授予的使用与分发权利。以前的 C# 版本仍保留在 Git 历史与 Releases 中。
核心能力
- 基于 Pi 的单一 Agent 循环,支持运行准入、取消、排队、延迟响应恢复与精确运行标识。
- SQLite 权威存储、事件回放、可靠 Actions、审批与结构化玩家交互。
- 角色设定与世界书、游戏时间记忆、混合检索,以及可选的本地或远程嵌入适配器。
- 目标、信号、日程、委派任务、行为 Skill、Agent Skills、Agent Plugins 和 MCP 工具接入。
- 图像附件与视觉观察、持久化媒体任务、语音识别与合成、实时语音协调。
- 服务端、TypeScript 客户端与 Unity、Godot、Unreal Engine 集成。
完整包结构与各包职责见英文 README。各模块按需组合,游戏始终保有世界状态写入权。
游戏引擎
| 引擎 | 接入方式 | 文档 |
|---|---|---|
| Unity 6 | C# 包与侧车运行时 | Unity |
| Godot | C# 客户端与引擎节点 | Godot |
| Unreal Engine | C++ 插件与侧车运行时 | Unreal |
开发与验证
npm run gate
该命令检查生成产物、格式、静态分析、类型、测试、构建、媒体验收、包内容、依赖漏洞及公共源码边界。 GitHub Actions 在 Ubuntu 24.04 上执行相同流程;Unity、Godot 与 Unreal 的真实编辑器验收需要另行配置本地环境。 命令与证据范围见验证说明。
提交改动前请阅读贡献指南与行为准则。 安全问题请按安全政策私密报告。