cultivation-world-simulator

cultivation-world-simulator

基于 AI Agent 工作流的修仙世界模拟器,旨在还原智能、开放的仙侠世界。| An open-source Cultivation World Simulator using Agentic Workflow to create a dynamic, emerging Xianxia world.

Stars: 884

Visit
 screenshot

Cultivation World Simulator is an AI-driven open-world cultivation simulator where players take on the role of 'Tian Dao' (God) to observe and influence the world of cultivators. The simulator features AI-driven NPCs with unique personalities, memories, and behaviors, a detailed world system based on cultivation elements like spiritual roots and techniques, emergent storytelling without predefined scripts, and a focus on creating a truly immersive cultivation world experience.

README:

This project now supports English. Don't hesitate to give it a try!

— ✦ —

修仙世界模拟器 (Cultivation World Simulator)

GitHub stars Bilibili QQ Group Discord License Genre: Xianxia AI Agent

Powered by LLM Python FastAPI Vue TypeScript Vite PixiJS

游戏演示

一个AI驱动的修仙世界模拟器,旨在创造一个真正活着的、有沉浸感的仙侠世界。

Featured|HelloGitHub

📖 简介

这是一个 AI 驱动的开放世界修仙模拟器

不同于传统的 RPG 扮演某个角色,在这里,你将扮演“天道”(上帝)。 你不需要亲自打怪升级,而是以上帝视角观察众生,在规则与 AI 共同编织的开放世界中,见证门派兴衰与天骄崛起。你可以静观沧海桑田,也可以降下天劫或魔改心灵,微妙地干预世界进程。

✨ 核心亮点

  • 👁️ 扮演“天道” (上帝视角):你不是修士,而是掌控世界规则的天道。观察众生百态,体味苦辣酸甜。
  • 🤖 全员 AI 驱动:每个 NPC 都独立基于LLM驱动,都有独立的性格、记忆、人际关系和行为逻辑。他们会根据即时局势做出决策,会有爱恨情仇,会结党营私,甚至会逆天改命。
  • 🌏 规则作为基石:世界基于灵根、境界、功法、寿元等严谨的数值体系运行。AI 的想象力被限制在合理的修仙逻辑框架内,确保世界真实可信。
  • 🦋 涌现式剧情:开发者也不知道下一秒会发生什么。没有预设剧本,只有无数因果交织出的世界演变。宗门大战、正魔之争、天骄陨落,皆由世界逻辑自主推演。

宗门体系



城市区域



生平经历

角色面板



性格特质



自主思考



江湖绰号

洞府探秘



长短期目标



丹药/法宝/武器

💭 为什么要做这个?

修仙网文中的世界很精彩,但读者永远只能观察到一隅。

修仙品类游戏要么是完全的预设剧本,要么依靠人工设计的简单规则状态机,有许许多多牵强和降智的表现。

在大语言模型出现后,让“每一个角色都是鲜活的”的目标变得似乎可以触达了。

希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具,也不是像斯坦福小镇那样的纯粹研究,而是能给玩家提供真实代入感和沉浸感的实际世界。

📞 联系方式

如果您对项目有任何问题或建议,欢迎提交 Issue 或 Pull Request。
欢迎给我的B站账号留言!
也可以加入QQ群进行讨论:1071821688。进群问题的答案:肥桥今天吃什么
加入 Discord 社区:https://discord.gg/shhRWmZR

🚀 使用方法

⚙️ 运行步骤

方式一:Docker Compose 一键部署(推荐)

如果你已经安装了 Docker,这是最简单的方式:

  1. 克隆项目

    git clone https://github.com/AI-Cultivation/cultivation-world-simulator.git
    cd cultivation-world-simulator
  2. 启动服务(自动构建并运行)

    docker-compose up -d --build

方式二:手动安装运行

  1. 克隆项目到本地:

    git clone https://github.com/AI-Cultivation/cultivation-world-simulator.git
    cd cultivation-world-simulator
  2. 安装依赖:

    # 后端依赖
    pip install -r requirements.txt
    
    # 前端依赖 (需Node.js环境)
    cd web && npm install
  3. 配置LLM:

    推荐方式:在前端直接配置(支持快速填充预设)

    前端LLM配置

    也可以在 static/local_config.yml 中手动配置(OpenAI兼容格式):

    llm:
      base_url: https://api.deepseek.com       # API地址
      key: your-api-key-here                   # 你的API密钥
      model_name: deepseek-chat                # 智能模型名称
      fast_model_name: deepseek-chat           # 快速模型名称
      mode: default                            # 运行模式 (default/normal/fast)

    本地部署 (Ollama): 也支持对接本地 Ollama,在前端选择 "Ollama (本地)" 预设即可。

  4. 运行:

    # 启动服务 (推荐开发模式,会自动启动前端)
    python src/server/main.py --dev

    浏览器会自动打开网页前端。

🌐 访问应用

无论使用哪种方式运行,启动后都可以通过以下地址访问:

前端:http://localhost:8123 后端 API:http://localhost:8002

📱 手机/局域网访问

支持从局域网内的其他设备(如手机、平板)访问游戏。

⚠️ 注意:移动端 UI 目前未做适配优化,体验可能不佳。详见 Issue #130

配置步骤:

  1. static/local_config.yml 中添加:

    system:
      host: "0.0.0.0"  # 允许局域网访问
  2. 如果使用开发模式(--dev),还需在 web/vite.config.tsserver 配置中添加:

    server: {
      host: '0.0.0.0',  // 添加这一行
      proxy: { ... }
    }
  3. 启动服务器后,在手机浏览器访问:

    http://<电脑局域网IP>:5173  # 开发模式
    http://<电脑局域网IP>:8002  # 生产模式
    
  4. 查看电脑局域网 IP:

    # macOS
    ipconfig getifaddr en0
    
    # Linux
    hostname -I
    
    # Windows
    ipconfig

💡 确保手机和电脑连接同一个 WiFi,且防火墙已放行对应端口。

📊 项目状态

Repobeats analytics

⭐ Star History

如果你觉得这个项目有趣,请给我们一个 Star ⭐!这将激励我们持续改进和添加新功能。

Star History Chart

👥 贡献者

更多贡献细节请查看 CONTRIBUTORS.md

📋 功能开发进度

🏗️ 基础系统

  • ✅ 基础世界地图、时间、事件系统
  • ✅ 多样化地形类型(平原、山脉、森林、沙漠、水域等)
  • ✅ 基于Web前端显示界面
  • ✅ 基础模拟器框架
  • ✅ 配置文件
  • ✅ release 一键即玩的exe
  • ✅ 菜单栏 & 存档 & 读档
  • ✅ 灵活自定义LLM接口
  • ✅ 支持mac os
  • ✅ 多语言本地化
  • ✅ 开始游戏页
  • ✅ BGM & 音效
  • [ ] Mod支持

🗺️ 世界系统

  • ✅ 基础tile地块系统
  • ✅ 基础区域、修行区域、城市区域、宗门区域
  • ✅ 同地块NPC交互
  • ✅ 灵气分布与产出设计
  • ✅ 世界事件

👤 角色系统

  • ✅ 角色基础属性系统
  • ✅ 修炼境界体系
  • ✅ 灵根系统
  • ✅ 基础移动动作
  • ✅ 角色特质与性格
  • ✅ 境界突破机制
  • ✅ 角色间的相互关系
  • ✅ 角色交互范围
  • ✅ 角色Effects系统:增益/减益效果
  • ✅ 角色功法
  • ✅ 角色兵器 & 辅助装备
  • ✅ 丹药
  • ✅ 角色长短期记忆
  • ✅ 角色的长短期目标,支持玩家主动设定
  • ✅ 角色绰号
  • [ ] 生活技能
    • ✅ 铸造
    • ✅ 炼丹
    • [ ] 种植
    • [ ] 饲养
    • [ ] 技能可升级
  • ✅ 凡人系统

🏛️ 组织系统

  • [ ] 宗门系统
    • ✅ 设定、功法、疗伤、驻地、行事风格
    • ✅ 宗门特殊动作:合欢宗(双修),百兽宗(御兽)
    • ✅ 宗门等阶
    • [ ] 宗门意志ai
    • [ ] 宗门任务
  • [ ] 世家系统
  • [ ] 朝廷系统(未定)
  • [ ] 组织间关系网络

⚡ 动作系统

  • ✅ 基础移动动作
  • ✅ 动作执行框架
  • ✅ 有明确规则的定义动作
  • ✅ 长动作执行和结算系统
    • ✅ 支持多月份持续的动作(如修炼、突破、游戏等)
    • ✅ 动作完成时的自动结算机制
  • ✅ 多人动作:动作发起与动作响应
  • ✅ 影响人际关系的LLM动作
  • ✅ 系统性的动作注册与运行逻辑

🎭 事件系统

  • ✅ 天地灵气变动
  • ✅ 多人大事件:
    • ✅ 拍卖会
    • ✅ 秘境探索
    • [ ] 比武大会
    • [ ] 宗门大比
  • [ ] 突发事件
    • [ ] 宝物/洞府出世
  • [ ] 自然事件:
    • [ ] 自然灾害
    • [ ] 兽潮

⚔️ 战斗系统

  • ✅ 优劣互克关系
  • ✅ 胜率计算系统

🎒 物品系统

  • ✅ 基础物品、灵石框架
  • ✅ 物品交易机制

🌿 生态系统

  • ✅ 动植物
  • ✅ 狩猎、采集、材料系统
  • [ ] 魔兽

🤖 AI增强系统

  • ✅ LLM接口集成
  • ✅ 角色AI系统(规则AI + LLM AI)
  • ✅ 协程化决策机制,异步运行,多线程加速ai决策
  • ✅ 长期规划和目标导向行为
  • ✅ 突发动作响应系统(对外界刺激的即时反应)
  • ✅ LLM驱动的NPC对话、思考、互动
  • ✅ LLM生成小片段剧情
  • ✅ 根据任务需求分别接入max/flash模型
  • ✅ 小剧场
    • ✅ 战斗小剧场
    • ✅ 对话小剧场
    • ✅ 小剧场不同文字风格
  • ✅ 一次性选择(如是否要切换功法)

🏛️ 世界背景系统

  • ✅ 注入基础世界知识
  • ✅ 用户输入历史,动态生成功法、装备、宗门、区域信息

✨ 特殊

  • ✅ 奇遇
  • ✅ 天劫 & 心魔
  • [ ] 夺舍 & 重生
  • [ ] 机缘 & 因果
  • [ ] 占卜 & 谶纬
  • [ ] 男生女相 & 女生男相
  • [ ] 角色隐秘 & 双面人
  • [ ] 飞升上界
  • [ ] 阵法
  • [ ] 阴谋
  • [ ] 世界秘密 & 世界法则
  • [ ] 炼蛊
  • [ ] 灭世危机

🔭 远期展望

  • [ ] 历史/事件的小说化&图片化&视频化
  • [ ] MCP agent化,修士自行调用工具

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for cultivation-world-simulator

Similar Open Source Tools

For similar tasks

For similar jobs