如何3分钟上手修仙世界模拟器Epic免费桌面版、Docker一键部署与源码运行完整指南【免费下载链接】cultivation-world-simulator基于 AI Agent 工作流的修仙世界模拟器旨在还原智能、开放的仙侠世界。| An open-source Cultivation World Simulator using Agentic Workflow to create a dynamic, emerging Xianxia world.项目地址: https://gitcode.com/gh_mirrors/cu/cultivation-world-simulator修仙世界模拟器Cultivation World Simulator是一个基于 AI Agent 工作流的开源修仙世界模拟器每一位修士都是独立的 LLM Agent拥有自己的性格、记忆与目标在严谨的修仙规则体系中自主演化。本文面向新手带你用 3 分钟跑起这个项目完整覆盖Epic 免费桌面版、Docker 一键部署与源码运行三种方式并附上首次开局配置模型的关键步骤。这是什么AI驱动的修仙世界模拟器和其他预设剧本的修仙游戏不同这个模拟器的核心玩法是——你扮演天道俯瞰一个由规则系统与 AI 共同驱动的仙侠世界自行演化全员 AI 驱动每个 NPC 都由 LLM 独立驱动会修炼、争斗、结盟、陨落剧情由世界逻辑自主推演️完整的修仙体系灵根、境界、功法、宗门、丹药、兵器、寿元、天劫、机缘等元素构成严谨的基石涌现式剧情没有预设剧本宗门大战、正魔之争、天骄崛起皆由因果交织涌现多世界与多语言内置多张地图与多种地形区域界面支持简中、繁中、英语、日语、越南语、法语。想进一步了解玩法细节可以阅读仓库根目录的 README.md世界设定与玩法资料也可以在 tools/wiki/ 生成本地辅助 wiki 快速查阅。30秒选对运行方式运行方式适合人群环境要求上手时间Epic 免费桌面版只想游玩的玩家无下载安装即可约 1 分钟Docker 一键部署想私有部署、体验 Web 版仅需 Docker约 3 分钟源码运行想改代码、做二次创作Python 3.10、Node.js 18约 5 分钟三种方式都要求你准备一个可用的大模型服务如 DeepSeek / MiniMax / Ollama用于驱动修士们的思考与决策。方式一Epic 免费桌面版——最快零配置上手 适合只想游玩、不想配置任何环境的玩家。打开 Epic Games Store搜索AI Cultivation World Simulator本项目为免费下载安装并启动游戏进入水墨风启动画面按设置页提示确认模型配置可用默认预设也可切换 DeepSeek / MiniMax / Ollama 并填入自己的 Key点击开始游戏即可开始一局全新的修仙世界模拟。 小贴士桌面版的打包与发布流程说明见 docs/packaging.md桌面端相关实现位于 desktop/src/ 目录。方式二Docker 一键部署——免装环境跑 Web 版⚙️ 适合想在服务器或本机私有部署、通过浏览器访问 Web 界面的玩家。只需安装好 Docker 与 Docker Compose执行下面 3 条命令git clone https://gitcode.com/gh_mirrors/cu/cultivation-world-simulator.git cd cultivation-world-simulator docker-compose up -d --build构建完成后访问http://localhost:8123即可打开游戏前端。这套部署的定义在 docker-compose.yml 中值得了解的几个细节后端镜像构建脚本deploy/Dockerfile.backend前端镜像构建脚本deploy/Dockerfile.frontend后端端口为8002前端端口映射为8123:80前端由 Nginx 代理配置见 deploy/nginx.conf数据统一持久化后端通过CWS_DATA_DIR/data保存设置、密钥、存档与日志默认映射到宿主机./docker-data目录——即使docker compose down后重新启动存档也不会丢失。部署后想验证服务健康状态后端提供http://localhost:8002/api/v1/query/runtime/status接口Docker 健康检查也正是依赖它。相关契约测试可参考 tests/test_docker_runtime_smoke.py。方式三源码运行——开发者二次创作推荐️ 适合想修改代码、调试逻辑或做二次创作的开发者。需要Python 3.10与Node.js 18。# 1. 克隆仓库 git clone https://gitcode.com/gh_mirrors/cu/cultivation-world-simulator.git cd cultivation-world-simulator # 2. 安装后端依赖 pip install -r requirements.txt # 3. 安装前端依赖 cd web npm install cd .. # 4. 启动服务自动拉起前后端 python src/server/main.py --dev启动后开发模式会自动拉起前端开发服务器浏览器访问日志中显示的前端地址通常为http://localhost:5173即可。源码目录结构速览方便你定位兴趣模块src/server/FastAPI 后端服务、外接控制 API 与存档加载src/sim/模拟器核心引擎与存档/读档逻辑src/classes/修士、宗门、动作、事件等领域模型src/systems/战斗、修炼、气运、阵法、天劫等游戏系统web/Vue 3 PixiJS 前端static/game_configs/功法、材料、地图等游戏配置数据全局架构约定见 AGENTS.md配置系统说明见 docs/specs/config-architecture.md。首次开局3分钟开始第一局修仙世界无论哪种方式首次进入后都要完成同样三步配置模型打开设置页选择模型预设DeepSeek / MiniMax / Ollama 等并填入 API Key配置会自动保存到用户数据目录开始新游戏回到开始界面点击开始游戏等待世界初始化地图、宗门、角色生成以天道视角观察打开事件流看修士的修炼、结拜、争斗也可以降下天劫、魔改心灵微妙地干预世界进程——开发者也不知道下一秒会发生什么。注如果开发模式下前端页面没有自动打开直接访问启动日志中显示的前端地址即可。常见问题FAQQ1三种方式的数据互通吗不互通。桌面版、Docker、源码各自使用独立的数据目录Docker 版的数据保存在./docker-data。Q2没有 API Key 能玩吗可以搭配本地 Ollama 使用开源模型无需付费 Key但模型能力会影响修士思考的质量。Q3想在局域网/手机上访问怎么办后端可通过环境变量SERVER_HOST0.0.0.0启动默认值在只读配置 static/config.yml 的system.host前端在 web/vite.config.ts 的 server 块加host: 0.0.0.0然后手机访问http://电脑局域网IP:5173。移动端 UI 暂未完全适配仅供尝鲜。Q4能用脚本或外部 Agent 控制这个游戏吗可以。项目提供稳定的外接控制 API只读查询走/api/v1/query/*受控写入走/api/v1/command/*完整设计见 docs/specs/external-control-api.md。写在最后从 Epic 免费桌面版 1 分钟即玩到 Docker 3 条命令私有部署再到源码运行参与二次创作——修仙世界模拟器把观察一个活着的仙侠世界这件事的门槛降到了最低。世界已在运转修士正在修炼只差你降下第一道天道之力。 延伸阅读docs/frontend.md前端架构、docs/testing.md测试指南、docs/packaging.md打包发布。【免费下载链接】cultivation-world-simulator基于 AI Agent 工作流的修仙世界模拟器旨在还原智能、开放的仙侠世界。| An open-source Cultivation World Simulator using Agentic Workflow to create a dynamic, emerging Xianxia world.项目地址: https://gitcode.com/gh_mirrors/cu/cultivation-world-simulator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考