K
KsanaDock/Microverse
A god-simulation sandbox game built on Godot 4 as a multi-agent AI social simulation system. In this virtual world, AI characters possess independent thinking and memory, capable of autonomous social interactions, task completion, and developing complex social relationships through continuous communication.
ai-gameai-world-simulationgodotmulti-agent
GDScriptMIT创建于 2025/10/9更新于 今天
README
由 Gemini 翻译整理
Microverse
中文 | English
KsanaDock | 时空码头
帮助你轻松 DIY 属于你的 Microverse，生成独特的 AI 世界与角色。
这是一个基于 Godot 4 构建的上帝视角沙盒模拟游戏，同时也是一套多智能体 AI 社交模拟系统。在这个虚拟世界中，AI 角色拥有独立的思维与记忆，能够自主进行社交互动、完成任务，并在持续的交流中发展出复杂的社会关系。
📸 项目效果预览
办公室场景中的 AI 角色互动效果
🌟 项目特色
- 沙盒式 AI 社会: 类似斯坦福 AI 小镇，AI 角色在开放世界中自主生活与互动。
- 多智能体生态系统: 支持多个 AI 角色同时在场景中进行复杂的社会互动。
- 智能对话系统: 基于大语言模型（LLM）的自然对话，支持多种 API 提供商。
- 持久化记忆系统: AI 角色具备长期记忆能力，能够记录历史对话与事件，形成连续的生活体验。
- 自主任务管理: AI 角色可以自主接受、执行和管理各种任务，展现真实的工作与生活。
- 环境感知能力: AI 角色能够感知周围环境和其他角色的状态，并做出相应反应。
- 多 AI 服务集成: 支持 OpenAI、Claude、Gemini、DeepSeek、豆包、Kimi 等多种 AI 服务。
🎮 沙盒游戏特性
🤖 AI 角色生态系统
- 8 个预设 AI 角色，每个都有独特的性格、背景故事和行为模式。
- 角色可以在虚拟世界中自由移动、探索与互动。
- 支持角色状态管理、情绪变化和自主行为决策。
- AI 角色会根据环境和社交情况做出真实的反应。
💬 自然社交系统
- 基于大语言模型的自然语言对话，支持多轮深度交流。
- 动态对话气泡 UI，实时显示角色间的交流。
- 完整的对话历史记录和回放功能。
- 支持群体讨论、私人对话和随机社交互动。
🧠 智能记忆与学习
- 持久化长期记忆存储系统。
- AI 角色能够学习并适应环境变化。
- 记忆的格式化存储与智能检索。
- 基于记忆的个性化行为发展。
📋 自主任务生态
- 任务的自动创建、智能分配和实时跟踪。
- 基于优先级的任务管理系统。
- 任务完成状态的动态监控。
- AI 角色间的任务协作和竞争机制。
🛠️ 技术栈
- 游戏引擎: Godot 4.3+
- 编程语言: GDScript
- AI 集成: REST API 调用
- 数据存储: JSON 格式本地存储
- UI 框架: Godot 内置 UI 系统
📋 系统要求
开发环境
- Godot 4.3 或更高版本
支持平台
- Windows: Windows 10/11 (64位)
- macOS: macOS 10.15+ (Intel/Apple Silicon)
- Linux: Ubuntu 18.04+, Fedora 32+, Arch Linux 等主流发行版
- Android: Android 6.0+ (API Level 23+)
硬件要求
- 最低配置: 4GB RAM, 1GB 可用存储空间
- 推荐配置: 8GB RAM, 2GB 可用存储空间
- 网络: 稳定的互联网连接（用于 AI API 调用）
注意事项
- Android 平台需要额外的平台特定配置。
- 所有平台都需要有效的 AI 服务 API Key 才能正常使用对话功能。
🚀 快速开始
1. 克隆项目
git clone https://github.com/KsanaDock/Microverse.git
cd microverse
2. 打开项目
- 启动 Godot 编辑器。
- 点击“导入”按钮。
- 选择项目根目录下的
project.godot文件。 - 点击“导入并编辑”。
3. 配置 API
- 运行游戏。
- 按 ESC 键打开设置界面。
- 在 API 设置中配置你的 AI 服务提供商和 API Key。
- 支持的服务商：
- OpenAI (GPT-3.5, GPT-4)
- Anthropic Claude
- Google Gemini
- DeepSeek
- 字节跳动豆包
- 月之暗面 Kimi
- Ollama (本地部署)
4. 开始游戏
- 选择地图（目前支持办公室场景）。
- 使用 WASD 键移动角色。
- 按 T 键开始与 AI 角色对话。
- 按 L 键结束对话。
- 按 ` 键打开控制台。
🎯 使用说明
基本操作
- 移动: WASD 键或方向键
- 坐下: 空格键
- 开始对话: T 键
- 结束对话: L 键
- 打开设置: ESC 键
- 保存/加载: F1 键
- 控制台: ` 键（反引号）
AI 角色介绍
- Alice: 友善的项目经理
- Grace: 专业的数据分析师
- Jack: 创意十足的设计师
- Joe: 技术专家
- Lea: 市场营销专家
- Monica: HR 专员
- Stephen: 财务分析师
- Tom: 软件开发工程师
高级功能
- 记忆查看: 在控制台中查看 AI 角色的记忆。
- 任务管理: 给 AI 角色分配和管理任务。
- 场景切换: 支持多个场景地图。
- 存档系统: 保存和加载游戏状态。
🔧 开发指南
项目结构
office/
├── asset/ # 游戏资源文件
├── scene/ # 场景文件
├── script/ # 脚本文件
│ ├── ai/ # AI相关脚本
│ └── ui/ # UI相关脚本
└── docs/ # 文档文件
核心系统
- APIManager: API 调用管理
- DialogManager: 对话系统管理
- MemoryManager: 记忆系统管理
- CharacterManager: 角色管理
- TaskManager: 任务管理
扩展开发
- 添加新的 AI 角色
- 创建新的场景地图
- 集成新的 AI 服务提供商
- 扩展对话功能
🎮 Steam 版本即将上线
《Microverse In Box 盒中小世界》即将登陆 Steam 平台！
🎯 添加到 Steam 愿望单 | 📖 查看 Steam 页面
📝 关于本开源项目: 本仓库开源的是《Microverse In Box》游戏在 2025 年 6 月的初版 Demo，为开发者和爱好者提供学习和参考。完整版游戏将在 Steam 平台发布，包含更多功能、优化和内容。
🤝 贡献指南
欢迎贡献代码！请遵循以下步骤：
- Fork 本项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
📝 许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
🙏 致谢
- Godot 游戏引擎团队
- 各 AI 服务提供商
- 开源社区的贡献者们
- 美术素材来源: LimeZu - 感谢这位优秀艺术家提供的精美游戏素材
- dartnode 赠送的服务器
