微宇宙 - Godot 多智能体沙盒游戏

项目说明

Microverse

中文 | English

<di="center">

![KsanaDock]()

KsanaDock | 时空码头

帮助你轻松 DIY 自己版本的 Microverse，生成独特的 AI 世界和角色。

点击访问 www.ksanadock.com

</div>

---

一个模拟上帝类的沙盒游戏，基于Godot 4开发的多智能体AI社交模拟系统。在这个虚拟世界中，AI角色拥有独立的思维和记忆，能够自主进行社交互动、完成任务，并在持续的交流中发展出复杂的社会关系。

📸 项目效果预览

<di="center">

!项目效果预览

*办公室场景中的AI角色互动效果*

</div>

🌟 项目特色

沙盒式AI社会: 类似斯坦福AI小镇，AI角色在开放世界中自主生活和互动

多智能体生态系统: 支持多个AI角色同时在场景中进行复杂的社会互动

智能对话系统: 基于大语言模型的自然对话，支持多种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密钥才能正常使用对话功能

🚀 快速开始

1. 克隆项目

2. 打开项目

1. 启动Godot编辑器
2. 点击"导入"按钮
3. 选择项目根目录下的project.godot文件
4. 点击"导入并编辑"

3. 配置API

1. 运行游戏
2. 按ESC键打开设置界面
3. 在API设置中配置你的AI服务提供商和API密钥
4. 支持的服务商：
- OpenAI (GPT-3.5, GPT-4)
- Anthropic Claude
- Google Gemini
- DeepSeek
- 字节跳动豆包
- 月之暗面Kimi
- Ollama (本地部署)

4. 开始游戏

1. 选择地图（目前支持办公室场景）
2. 使用WASD键移动角色
3. 按T键开始与AI角色对话
4. 按L键结束对话
5. 按键打开控制台

🎯 使用说明

基本操作

移动: WASD键或方向键

坐下: 空格键

开始对话: T键

结束对话: L键

打开设置: ESC键

保存/加载: F1键

控制台: 键（反引号）

AI角色介绍

Alice: 友善的项目经理

Grace: 专业的数据分析师

Jack: 创意十足的设计师

Joe: 技术专家

Lea: 市场营销专家

Monica: HR专员

Stephen: 财务分析师

Tom: 软件开发工程师

高级功能

记忆查看: 在控制台中查看AI角色的记忆

任务管理: 给AI角色分配和管理任务

场景切换: 支持多个场景地图

存档系统: 保存和加载游戏状态

🔧 开发指南

项目结构

核心系统

APIManager: API调用管理

DialogManager: 对话系统管理

MemoryManager: 记忆系统管理

CharacterManager: 角色管理

TaskManager: 任务管理

扩展开发

添加新的AI角色

创建新的场景地图

集成新的AI服务提供商

扩展对话功能

🎮 Steam版本即将上线

<di="center">

!Microverse In Box 盒中小世界

《Microverse In Box 盒中小世界》即将登陆Steam平台！

![Steam]()

🎯 添加到Steam愿望单 | 📖 查看Steam页面

---

📝 关于本开源项目: 本仓库开源的是《Microverse In Box》游戏在2025年6月的初版Demo，为开发者和爱好者提供学习和参考。完整版游戏将在Steam平台发布，包含更多功能、优化和内容。

</div>

🤝 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 创建Pull Request

📝 许可证

本项目采用MIT许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

Godot游戏引擎团队

各AI服务提供商

开源社区的贡献者们

美术素材来源: LimeZu - 感谢这位优秀艺术家提供的精美游戏素材

dartnode赠送的服务器

![Powered by DartNode]( "Powered by DartNode - Free VPS for Open 源码")

📞 /github.com/KsanaDock/Microverse/issues" target="_blank" rel="noopener">GitHub Issues

官方网站: 时空码头KsanaDock

🌐 关注我们

<di="center">

在社交媒体上关注我们的最新动态

<table>
<tr>
<td align="center" width="200">
<a href="
<img src=" alt="小红书"/>
<br/>
<strong>小红书</strong>
<br/>
_{创意分享与交流}
</a>
</td>
<td align="center" width="200">
<a href="
<img src=" alt="Bilibili"/>
<br/>
<strong>哔哩哔哩</strong>
<br/>
_{中文视频内容}
</a>
</td>
<td align="center" width="200">
<a href="
<img src=" alt="GitHub"/>
<br/>
<strong>GitHub</strong>
<br/>
_{项目源码与更新}
</a>
</td>
</tr>
<tr>
<td align="center" width="200">
<a href="
<img src=" alt="X"/>
<br/>
<strong>X (Twitter)</strong>
<br/>
_{最新资讯与讨论}
</a>
</td>
<td align="center" width="200">
<a href="
<img src=" alt="Steam"/>
<br/>
<strong>Steam</strong>
<br/>
_{游戏发布与更新}
</a>
</td>
<td align="center" width="200">
<a href="
<img src=" alt="YouTube"/>
<br/>
<strong>YouTube</strong>
<br/>
_{演示视频与教程}
</a>
</td>
</tr>
</table>

</div>

---

Star History

![Star History Chart]()

注意: 使用本项目需要有效的AI服务API密钥。请确保遵守各AI服务提供商的使用条款和条件。

技术栈

开发语言：GDScript

项目类型：Godot 多智能体沙盒游戏

Star 数：2490

功能特点

这是一套Godot 多智能体沙盒游戏，代码结构清晰，适合开发者学习游戏的客户端渲染、服务端逻辑、场景管理与资源加载。项目涵盖了游戏的核心玩法、界面交互、地图与角色系统等模块，对理解游戏开发的完整流程具有较高的参考价值。

从技术实现角度看，游戏项目的难点在于：游戏循环与状态管理、资源加载与渲染优化、客户端与服务端的协议同步、以及多平台适配。本项目在这些方面提供了可运行的实现，开发者可以在此基础上进行二次开发或学习研究。

部署说明

1. 下载源码压缩包，解压到本地开发环境。

2. 根据项目类型准备对应的运行环境（Node.js / Go / C# / Unity / Godot 等）。

3. 按照 README 中的步骤配置依赖、数据库和配置文件。

4. 先启动服务端，再运行客户端，即可进入游戏进行测试。

注意：本项目仅供学习研究使用，请勿用于商业或非法用途。

学习价值

对于想进入游戏开发领域的开发者来说，这套源码是一个很好的入门参考。通过阅读代码，可以学习到游戏的核心玩法实现、场景与资源管理、网络协议设计、以及渲染优化等关键技术点。

同时，项目中的代码组织方式和模块划分，也展示了游戏项目在工程化方面的实践经验，值得开发者深入研究和借鉴。理解一个完整游戏项目的架构，对后续开发其他类型游戏也很有帮助。

免责声明

本资源来源于开源社区，仅供学习研究和技术交流使用，请勿用于任何商业或违法违规用途。使用本项目产生的一切后果由使用者自行承担。若涉及第三方权益，请联系删除。