零门槛搭建开源虚拟小镇：可视化工具让AI角色社交场景轻松落地

零门槛搭建开源虚拟小镇：可视化工具让AI角色社交场景轻松落地

【免费下载链接】ai-townA MIT-licensed, deployable starter kit for building and customizing your own version of AI town - a virtual town where AI characters live, chat and socialize.项目地址: https://gitcode.com/gh_mirrors/ai/ai-town

你是否曾梦想创建一个属于自己的虚拟世界，让AI角色在其中自由生活、交流并建立社交关系？但复杂的技术壁垒、高昂的服务器成本和繁琐的部署流程是否让你望而却步？现在，借助这款开源虚拟小镇项目，你可以零代码快速构建属于自己的AI社交场景，即使没有专业开发知识，也能在15分钟内启动你的虚拟世界。

问题：虚拟世界创建的三大痛点

作为虚拟世界创建者，你可能正面临这些挑战：技术壁垒高，需要掌握多种编程语言和框架；成本压力大，服务器和云服务费用高昂；部署流程复杂，涉及多个组件的配置和协调。这些问题让许多创意止步于想法阶段，无法转化为实际的虚拟体验。

技术壁垒：从代码到场景的鸿沟

传统虚拟世界开发需要掌握3D建模、游戏引擎、后端服务等多种技术，对非专业开发者来说门槛极高。即使是简单的场景和角色交互，也需要编写大量代码，这让许多创意爱好者望而却步。

成本压力：服务器与算力的双重负担

运行一个包含多个AI角色的虚拟世界需要强大的服务器支持，尤其是当AI角色需要频繁进行自然语言交互时，算力成本会急剧上升。对于个人开发者和小型团队来说，这是一个难以承受的负担。

部署复杂：多组件协同的挑战

虚拟世界通常包含前端界面、后端服务、数据库、AI模型等多个组件，这些组件的配置、集成和维护需要专业的DevOps知识。复杂的部署流程让许多人在搭建阶段就选择放弃。

方案：开源虚拟小镇的零代码解决方案

这款开源虚拟小镇项目提供了一套完整的解决方案，通过可视化工具和模块化设计，让你能够轻松创建、部署和定制自己的虚拟世界。项目采用MIT许可，完全开源，你可以自由修改和扩展其功能。

个人体验：Docker一键启动

对于想要快速体验的你，Docker Compose是最简单的方式。只需几个命令，就能在本地启动一个完整的虚拟小镇环境，包括前端界面、后端服务和管理面板。

git clone https://gitcode.com/gh_mirrors/ai/ai-town cd ai-town docker compose up --build -d

新手友好度：⭐⭐⭐⭐⭐

启动成功后，访问http://localhost:5173即可进入你的AI小镇。默认场景中包含多个AI角色，他们会自主移动、交谈并建立社交关系。

AI角色社交演示：虚拟小镇的日常场景，AI角色在其中自由移动和互动

团队协作：本地开发环境

如果你计划与团队一起开发或自定义AI角色和游戏规则，推荐使用标准本地部署。这种方式提供了更灵活的开发环境，支持热重载和实时调试。

# 克隆仓库 git clone https://gitcode.com/gh_mirrors/ai/ai-town cd ai-town # 安装依赖 npm install # 启动开发环境 npm run dev

新手友好度：⭐⭐⭐⭐

开发模式下，前端和后端会自动监听文件变化并热重载，极大提高开发效率。前端访问地址为http://localhost:5173，后端API地址为http://localhost:3210。

公网发布：云服务部署

当你准备好将虚拟小镇分享给更多人时，可以选择云服务部署。这种方式允许公网访问，无需本地资源，但可能产生云服务费用。具体部署步骤可参考项目文档中的"云服务部署指南"。

新手友好度：⭐⭐⭐

价值：释放虚拟世界创造力

这款开源虚拟小镇项目不仅解决了技术、成本和部署的痛点，更重要的是释放了你的创造力。通过可视化工具和模块化设计，你可以专注于创意实现，而不是技术细节。

功能体验：AI角色的智能交互

项目的核心魅力在于AI角色的智能交互，这依赖于大语言模型(LLM)的支持。你可以选择本地运行Ollama，也可以使用OpenAI等云端服务。

AI角色社交演示：虚拟小镇中的角色互动场景

实现原理：角色的"大脑"构造

每个AI角色的"大脑"由三个核心模块组成：

1. 记忆系统：存储角色的经历和关系，使用向量数据库（就像角色的长期记忆库）进行高效检索。
2. 决策引擎：基于当前状态和记忆决定下一步行动。
3. 对话生成：结合角色性格和上下文生成自然对话。

定制方法：创建你的AI角色

所有角色数据都存储在data/characters.ts文件中。要添加新角色，只需在characters数组中添加类似以下的配置：

{ name: "Alice", description: "一位热爱阅读的图书管理员", x: 10, y: 15, traits: ["curious", "friendly", "knowledgeable"] }

实操小贴士：修改角色后，需要运行npx convex run testing:wipeAllTables重置数据库使更改生效。

功能体验：自定义地图与场景

项目提供了丰富的地图编辑工具，让你可以创建独特的虚拟环境。你可以使用Tiled地图编辑器设计自己的场景，并通过转换脚本生成游戏可用格式。

虚拟小镇地图编辑界面，展示各种地形和建筑元素

实现原理：地图数据结构

地图数据以JSON格式存储，包含地形、建筑、道路等元素的位置和属性。游戏引擎会根据这些数据渲染出可视化场景，并处理角色在地图上的移动和交互。

定制方法：创建你的专属地图

1. 下载并安装Tiled地图编辑器
2. 编辑地图文件（如data/gentle.js）
3. 使用转换脚本生成游戏可用格式：

node data/convertMap.js <mapDataPath> <assetPath> <tilesetpxw> <tilesetpxh>

实操小贴士：项目提供了多个tileset资源，位于public/assets/目录下，包括建筑、自然景观和角色等元素。

资源占用控制指南

随着小镇规模扩大，你可能需要控制资源消耗。以下是一些实用技巧：

1. 减少AI角色数量：在data/characters.ts中减少初始角色
2. 降低LLM调用频率：修改convex/agent/conversation.ts中的对话间隔
3. 调整游戏速度：在convex/constants.ts中修改TICK_DURATION

实操小贴士：对于低配置电脑，建议初始角色数量不超过5个，并使用较小的地图尺寸。

常见失败案例与解决方案

案例一：Docker启动失败

问题：执行docker compose up后，服务无法正常启动。解决方案：

1. 检查容器状态：docker compose ps
2. 查看日志：docker compose logs -f backend
3. 验证端口占用：确保5173、3210、6791端口未被占用

案例二：Ollama连接问题

问题：本地Ollama服务无法被AI小镇访问。解决方案：

1. 测试Ollama连接：curl http://localhost:11434
2. 重新设置Ollama地址：npx convex env set OLLAMA_HOST http://host.docker.internal:11434

应用场景：从教育到商业

教育场景：历史人物互动学习

创建历史人物AI，让学生与虚拟历史人物互动学习。例如，你可以创建一个虚拟的文艺复兴小镇，其中包含达芬奇、莎士比亚等历史人物AI，学生可以与他们对话，了解历史背景和文化知识。

实施方案：

1. 在data/characters.ts中定义历史人物角色
2. 编写特定领域的知识库，增强角色的专业知识
3. 设计教育场景任务，引导学生与AI角色互动学习

商业场景：虚拟购物体验

创建虚拟商场，让AI角色作为店员和顾客，模拟真实购物场景。商家可以测试新产品展示方式和营销策略，收集用户行为数据。

实施方案：

1. 使用src/editor/tilesets/Modern.png中的现代建筑元素创建商场地图
2. 定义不同类型的店员AI角色，设置产品知识和销售策略
3. 实现虚拟货币系统和交易功能

总结

通过这款开源虚拟小镇项目，你可以零门槛创建属于自己的虚拟世界。无论是教育、娱乐还是商业应用，都能在这里找到合适的解决方案。项目的模块化设计和可视化工具让创意实现变得简单，而开源特性又为技术探索提供了无限可能。现在就启动你的虚拟小镇，释放创造力，探索AI社交的无限可能！

【免费下载链接】ai-townA MIT-licensed, deployable starter kit for building and customizing your own version of AI town - a virtual town where AI characters live, chat and socialize.项目地址: https://gitcode.com/gh_mirrors/ai/ai-town