my_ai_town 是一个基于 Godot 4.7 与 GDScript 开发的单机像素小镇生活模拟游戏。核心特色是让小镇居民由 LLM 驱动，根据性格、职业、关系、记忆、位置、当前事件和世界状态自主决策、移动、工作与交流。项目目前处于 active development，已实现居民 Agent、职业工作链、自然对话、玩家化身、记忆关系系统、世界日志、天气、存档和主要 UI 等核心模块，但仍未发布稳定桌面版本，许可证也尚未统一明确。
适用领域
AI 游戏 / LLM Agent / 模拟经营 / 生活模拟 / Godot 游戏开发 / GDScript / NPC 自主行为 / 生成式 AI 交互 / 虚拟社会仿真
配置难度
中高。对于熟悉 Godot 和 GDScript 的开发者，可以较快运行和理解基础结构；但如果要深入修改居民 Agent、记忆、关系、世界事件、LLM 提示词和行为闭环，需要同时具备游戏工程、LLM API、多 Agent 系统和状态管理经验。
商业价值
该项目具有较高的原型与研究价值，适合用于探索 AI NPC、AI 小镇、虚拟社会和生成式 AI 游戏玩法。对于独立游戏团队，它可以作为验证 AI 生活模拟核心循环的参考；对于 AI 应用团队，它展示了 LLM Agent 与游戏世界状态结合的实际落地方式。不过，由于许可证未明确、项目仍在开发、且依赖外部 LLM 服务，短期商业化需要重点解决授权、成本控制、内容安全、稳定性和发行版本打包问题。
01
技术亮点
- 项目面向中文开发者和玩家，README、说明和游戏概念都非常清晰。
- 居民不是固定对白 NPC，而是根据性格、关系、记忆、职业、位置和当前事件自主决策。
- 实现了世界日志系统，可记录已确认事件、活动和对话，便于追踪虚拟社会演化。
- 每个居民拥有独立经历、关系和未完成事项，支持持续记忆和存档恢复。
- 玩家可以主动介入世界，例如交谈、发布公告、发送照片、改变天气，并观察影响传播。
- 项目结构清晰，按 agent、world、ui、tests、tools 等模块组织。
- 结合真实地点、设备、工作步骤和结果构建职业与工作链，增强模拟真实性。
- 已有 361 stars 和 65 forks，说明在 AI 游戏与 Godot 社区有一定关注度。
- 提供测试目录，包括合同测试、集成测试和运行验收，说明作者重视工程质量。
02
目标用户
- 对 AI NPC 和 LLM Agent 感兴趣的游戏开发者
- 使用 Godot/GDScript 开发游戏的开发者
- 研究虚拟社会、记忆系统和多 Agent 行为的技术人员
- 希望学习 AI 驱动角色对话与行为设计的独立游戏开发者
- 关注生成式 AI 游戏玩法原型的产品经理或创业团队
- 喜欢生活模拟、像素小镇和观察式 AI 沙盒的玩家
03
配置要求
- Godot 4.7 稳定版。
- 支持 Godot 4.7 的桌面操作系统。
- 可访问的 LLM Provider。
- LLM API Key，需要通过游戏内设置保存，不应写入仓库。
- Windows 发布版默认使用兼容渲染，可通过 Direct3D 11/ANGLE 运行，并在需要时回退到原生 OpenGL。
- 需要具备一定网络访问能力以调用大模型服务。
- 如果二次开发，需要了解 Godot 工程结构、GDScript、场景系统和资源管理。
04
适用场景
- 作为 LLM 驱动 NPC 行为系统的开源参考项目
- 学习如何在 Godot 中组织大型游戏工程、UI、世界系统和 Agent 系统
- 研究居民记忆、关系、承诺、事件日志如何影响后续行为
- 验证 AI 小镇、AI 沙盒、AI 生活模拟类游戏玩法
- 基于现有工程二次开发中文 AI NPC 游戏原型
- 分析多角色在共享世界状态下的决策、对话和长期记忆设计
- 用于教学演示 Godot 与大模型 API 结合的游戏开发流程
05
部署与配置
- 安装 Godot 4.7 稳定版。
- 准备一个可用的 LLM Provider，并获取对应 API Key。
- 克隆仓库：git clone https://github.com/mewamew/my_ai_town.git
- 进入项目目录：cd my_ai_town
- 使用 Godot 打开 game/project.godot。
- 运行项目。
- 在游戏内的模型设置页配置 LLM Provider 和 API Key。
- 使用 WASD 或方向键移动玩家化身，按 E 与附近目标互动。
06
风险与注意事项
- 项目仍处于持续开发阶段，功能和接口可能频繁变化，不适合直接作为稳定商业产品使用。
- 当前只提供源码，桌面版本尚未正式通过 GitHub Releases 发布。
- 许可证尚未整理完成，README 明确提示根许可证发布前不要将整个仓库视为已获得统一再分发授权，商业使用和再分发风险较高。
- 运行依赖外部 LLM Provider 和 API Key，存在调用成本、延迟、可用性和模型输出不稳定问题。
- LLM 驱动 NPC 可能产生不可控内容，需要额外的安全过滤、内容审核和行为约束。
- Godot 4.7 仍属于较新的版本要求，团队环境可能需要升级或适配。
- 如果需要扩展为多人在线或大规模模拟，当前单机架构可能需要较大改造。
- LLM 交互、记忆系统和世界状态闭环复杂，二次开发调试成本较高。
- 仓库未声明统一开源许可证，贡献、修改、打包发布前需要与作者确认授权边界。
2026-08-14
第21名
新收录 · github_search
2026-08-13
第17名
新收录 · github_search
2026-08-12
第15名
新收录 · github_search
2026-08-11
第21名
新收录 · github_search
