AI Rank
EN
← 开源
4thfever

cultivation-world-simulator

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

ApplicationsOtherPython
在 GitHub 打开
增长势头
+-124 小时新增 Star-0.0%
2.11k
Star
238
Fork
+0
本周
15
贡献者
创建于 2025-08-18 · 更新于 2026-10-16 · 今日第 18747 名
主要开发者
4thfeverxzhsehteps3105

4thfever/cultivation-world-simulator 排名第 18,747，有 2,111 个星标。

同类别比较

4thfever/cultivation-world-simulator 排名第 18,747，此处有 8 个同类条目；enarjord/passivbot 排名第 18,744。

同类别比较
名称排名指标
dou-jiang/codex-console18,727
语言:
Python
星标数:
2,228
分叉数:
979
简介:
codex-console 是一个集成化控制台项目，支持任务管理、批量处理、数据导出、自动上传、日志查看与打包支持。
ai-christianson/RA.Aid18,729
语言:
Python
星标数:
2,223
分叉数:
211
简介:
Develop software autonomously.
githubharald/SimpleHTR18,737
语言:
Python
星标数:
2,190
分叉数:
913
简介:
Handwritten Text Recognition (HTR) system implemented with TensorFlow.
enarjord/passivbot18,744
语言:
Python
星标数:
2,129
分叉数:
680
简介:
Trading bot running on Bybit, Bitget, OKX, GateIO, Binance, Kucoin, WEEX and Hyperliquid
akl7777777/ShellGPT18,759
语言:
JavaScript
星标数:
2,021
分叉数:
234
简介:
**ShellGPT is a free chatgpt client, now Supported online search.no need for a key, no need to log in.Multi-node automatic speed measurement switch,Long text translation with no word limit, AI graphics.免费的chatgpt客户端，已支持联网搜索,无需密钥，无需登录,多节点自动测速切换,长文翻译不限字数,AI出图**
facebookresearch/Detic18,760
语言:
Python
星标数:
2,011
分叉数:
229
简介:
Code release for "Detecting Twenty-thousand Classes using Image-level Supervision".
android/androidify18,763
语言:
Kotlin
星标数:
1,989
分叉数:
319
简介:
Sample app for Androidify
run-llama/notebookllama18,766
语言:
Python
星标数:
1,977
分叉数:
243
简介:
A fully open-source, LlamaCloud-backed alternative to NotebookLM
关键参数与规格
关键参数与规格
参数值
语言Python
类别Applications
子类别Other
关键词Agent, AI character, Gaming, Prompt engineering
星标数2,111
分叉数238
贡献者15
创建日期2025-08-18
更新日期2026-10-16
1 天星标数-1
7 天星标数0
排名18,747
上次排名5,335
排名变化-13,412
7 天星标排名12,142
上次 7 天星标排名5,073
7 天星标排名变化-7,069
总星标排名6,069
上次总星标排名6,062
总星标排名变化-7
国家China
README 摘录

** **全员 LLM 驱动、群像涌现叙事，桌面版已在 Epic Games Store 免费发布，也支持 Docker 部署、源码开发与二次创作。 在规则与 AI 共同编织的世界中，修士Agent们与宗门意志相互博弈又合作，新的精彩剧情不断涌现。 你可以

静观沧海桑田，见证门派兴衰与天骄崛起，也可以降下天劫或魔改心灵，微妙地干预世界进程。 ✨ 核心亮点 👁️ **扮演“天道”**：你不是修士，而是掌控世界规则的**天道**。 🤖 **全员 AI 驱动**：每个 NPC 都独立基于LLM驱动，都有

独立的性格、记忆、人际关系和行为逻辑。 🌏 **规则作为基石**：世界基于灵根、境界、功法、性格、宗门、丹药、兵器、武道会、拍卖会、寿元等元素共同组成的严谨体系运行。 🚀 快速开始 推荐方式 **想改代码或调试**：使用源

码部署，并准备 Python 、Node. **想直接体验**：可前往 Epic Games Store 免费获取桌面版；也可以使用 Docker 一键部署。 首次启动说明 使用 Epic 桌面版时，启动后按设置页提示确认模型配置，即可开始新游戏。 使用源码或 Docker 时，首次

进入后需要先在设置页配置可用的模型预设（如 DeepSeek / MiniMax / Ollama），再开始新游戏。 开发模式下，前端页面通常会自动打开；如果没有自动打开，请访问启动日志中显示的前端地址。 方式零：Epic Games Store 桌面版 适合只

想游玩、不想配置开发环境的玩家。 如果你希望使用自己的模型服务，可以在设置页切换 DeepSeek / MiniMax / Ollama 等预设。 **配置模型** 在前端设置页选择模型预设（如 DeepSeek / MiniMax / Ollama）后，即可开始新游戏。 **访问前端** 开发模式会自

动拉起前端开发服务器，请访问启动日志中显示

常见问题

记录了多少星标和分叉？

4thfever/cultivation-world-simulator 有 2,111 个星标和 238 个分叉。

仓库排名是多少？

4thfever/cultivation-world-simulator 排名第 18,747。

记录的语言和类别是什么？

4thfever/cultivation-world-simulator 有 2,111 个星标，语言为 Python，类别为 Applications。

哪个仓库排名最接近？

4thfever/cultivation-world-simulator 与 enarjord/passivbot 比较，后者排名第 18,744，有 2,129 个星标。

README

简体中文 · 繁體中文 · English · Tiếng Việt · 日本語 · Français

— ✦ —

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

你将作为“天道”，观察一个由规则系统与 AI 共同驱动的修仙世界模拟器自行演化。 全员 LLM 驱动、群像涌现叙事，桌面版已在 Epic Games Store 免费发布，也支持 Docker 部署、源码开发与二次创作。

📖 简介

这是一个 AI 驱动的修仙世界模拟器。 模拟器中，每一个修士都是独立的Agent，可以自由观测环境并做出决策。同时，为了避免AI的幻觉与过度发散，编入了复杂灵活的修仙世界观与运行规则。在规则与 AI 共同编织的世界中，修士Agent们与宗门意志相互博弈又合作，新的精彩剧情不断涌现。你可以静观沧海桑田，见证门派兴衰与天骄崛起，也可以降下天劫或魔改心灵，微妙地干预世界进程。

✨ 核心亮点

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

宗门体系

   ![](assets/zh-CN/screenshots/宗门.png)

城市区域

   ![](assets/zh-CN/screenshots/城市.png)

事件经历

   ![](assets/zh-CN/screenshots/经历.png)

角色面板

   ![](assets/zh-CN/screenshots/角色.png)

性格与装备

   ![](assets/zh-CN/screenshots/特质.png)

自主思考

   ![](assets/zh-CN/screenshots/思考.png)

江湖绰号

   ![](assets/zh-CN/screenshots/绰号.png)

洞府探秘

   ![](assets/zh-CN/screenshots/洞府.png)

角色信息

   ![](assets/zh-CN/screenshots/角色信息.png)

丹药/法宝/武器

   ![](assets/zh-CN/screenshots/丹药.png) 
   ![](assets/zh-CN/screenshots/法宝.png) 
   ![](assets/zh-CN/screenshots/武器.png)

🚀 快速开始

推荐方式

  • 想改代码或调试：使用源码部署，并准备 Python 3.10+、Node.js 18+ 和可用的模型服务。
  • 想直接体验：可前往 Epic Games Store 免费获取桌面版；也可以使用 Docker 一键部署。
  • 如需快速查阅世界信息、动作、宗门等资料，可在 tools/wiki 生成本地辅助 wiki。

首次启动说明

  • 使用 Epic 桌面版时，启动后按设置页提示确认模型配置，即可开始新游戏。
  • 使用源码或 Docker 时，首次进入后需要先在设置页配置可用的模型预设（如 DeepSeek / MiniMax / Ollama），再开始新游戏。
  • 开发模式下，前端页面通常会自动打开；如果没有自动打开，请访问启动日志中显示的前端地址。

方式零：Epic Games Store 桌面版

适合只想游玩、不想配置开发环境的玩家。

  1. 前往 Epic Games Store 免费获取并安装。
  2. 启动游戏后，按设置页提示确认模型配置，即可开始新游戏。
  3. 如果你希望使用自己的模型服务，可以在设置页切换 DeepSeek / MiniMax / Ollama 等预设。

方式一：源码部署（开发模式，推荐）

适合需要修改代码或调试的开发者。

  1. 安装依赖并启动

    # 1. 安装后端依赖
pip install -r requirements.txt

# 2. 安装前端依赖 (需 Node.js)
cd web && npm install && cd ..

# 3. 启动服务 (自动拉起前后端)
python src/server/main.py --dev

  2. 配置模型 在前端设置页选择模型预设（如 DeepSeek / MiniMax / Ollama）后，即可开始新游戏。配置会自动保存到用户数据目录。

  3. 访问前端 开发模式会自动拉起前端开发服务器，请访问启动日志中显示的前端地址，通常为 http://localhost:5173。

方式二：Docker 一键部署（未测试）

无需配置环境，直接运行即可：

git clone https://github.com/4thfever/cultivation-world-simulator.git
cd cultivation-world-simulator
docker-compose up -d --build

访问前端：http://localhost:8123

后端容器通过 CWS_DATA_DIR=/data 统一持久化用户数据，包含设置、密钥、存档和日志。默认已映射到宿主机 ./docker-data，即使执行 docker compose down 后重新 up，这些数据也会保留。

局域网/手机访问配置 (点击展开)

⚠️ 移动端 UI 暂未完全适配，仅供尝鲜。

  1. 后端配置：推荐通过环境变量启动后端，例如 PowerShell 中执行 $env:SERVER_HOST='0.0.0.0'; python src/server/main.py --dev。如需改默认值，可编辑只读配置 static/config.yml 中的 system.host。
  2. 前端配置：修改 web/vite.config.ts，在 server 块中添加 host: '0.0.0.0'。
  3. 访问方式：确保手机与电脑在同一 WiFi 下，访问 http://<电脑局域网IP>:5173。

外接 API / Agent/Claw 接入 (点击展开)

这部分适合做外部 agent / Claw 接入、自动化脚本，或者实现“观察 -> 决策 -> 干预 -> 再观察”的闭环游玩。

推荐直接围绕稳定命名空间开发：

  • 只读查询：/api/v1/query/*
  • 受控写入：/api/v1/command/*

常见起点接口：

  • GET /api/v1/query/runtime/status
  • GET /api/v1/query/world/state
  • GET /api/v1/query/events
  • GET /api/v1/query/detail?type=avatar|region|sect&id=
  • POST /api/v1/command/game/start
  • POST /api/v1/command/avatar/*
  • POST /api/v1/command/world/*

最小接入流程通常是：

  1. 先调用 GET /api/v1/query/runtime/status 判断当前运行状态。
  2. 如未开局，调用 POST /api/v1/command/game/start 初始化。
  3. 用 world/state、events、detail 拉取世界快照与目标信息。
  4. 根据策略调用一个 command 执行干预。
  5. 干预后重新 query，不要依赖本地缓存推断结果。

接口成功时通常返回：

{
  "ok": true,
  "data": {}
}

失败时会返回结构化错误，可读取 detail.code 与 detail.message 做程序判断。

补充说明：

  • 应用设置仍通过 /api/settings* 与 /api/settings/llm* 管理，它们属于设置真源，不属于外接控制兼容层。
  • 更完整的接口清单、分层设计与扩展约定请参考 docs/specs/external-control-api.md。

💭 为什么要做这个？

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

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

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

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

📞 联系方式

如果您对项目有任何问题或建议，欢迎提交 Issue。

⭐ Star History

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

分享

感谢贡献者为本 repo 贡献分享。

👥 贡献者


4thfever


xzhseh


teps3105


Meanliss


octo-patch


cooleryu


LuckVd


MarkYangKp


Robinwhliu


Seafoodsz


Tianrant


cw1990


mitsuko33000-ops


RealityError


hhzscreate

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

📋 功能开发进度

🏗️ 基础系统

  • ✅ 基础世界地图、时间、事件系统
  • ✅ 多样化地形类型（平原、山脉、森林、沙漠、水域等）
  • ✅ 基于Web前端显示界面
  • ✅ 基础模拟器框架
  • ✅ 配置文件
  • ✅ 桌面版一键启动包
  • ✅ 菜单栏 & 存档 & 读档
  • ✅ 灵活自定义LLM接口
  • ✅ 支持mac os
  • ✅ 多语言本地化
  • ✅ 开始游戏页
  • ✅ BGM & 音效
  • ✅ 玩家可编辑
  • ✅ 扮演模式

🗺️ 世界系统

  • ✅ 基础tile地块系统
  • ✅ 基础区域、修行区域、城市区域、宗门区域
  • ✅ 同地块NPC交互
  • ✅ 灵气分布与产出设计
  • ✅ 世界事件
  • ✅ 天地人榜
  • ✅ 更大更美观地图 & 随机地图

👤 角色系统

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

🏛️ 组织

  • ✅ 宗门
    • ✅ 设定、功法、疗伤、驻地、行事风格、任务
    • ✅ 宗门特殊动作：合欢宗（双修），百兽宗（御兽）等
    • ✅ 宗门等阶
    • ✅ 道统
  • ✅ 朝廷
  • ✅ 组织意志AI
  • ✅ 组织任务、资源、机能
  • ✅ 组织间关系网络

⚡ 动作系统

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

🎭 事件系统

  • ✅ 天地灵气变动
  • ✅ 多人大事件：
    • ✅ 拍卖会
    • ✅ 秘境探索
    • ✅ 天下武道会
    • ✅ 宗门传道大会
  • ✅ 突发事件
    • ✅ 宝物出世

⚔️ 战斗系统

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

🎒 物品系统

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

🌿 生态系统

  • ✅ 动植物
  • ✅ 狩猎、采集、材料系统
  • ✅ 妖族

🤖 AI增强系统

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

🏛️ 世界背景系统

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

✨ 特殊

  • ✅ 奇遇
  • ✅ 天劫 & 心魔
  • ✅ 命格
  • ✅ 阵法
  • ✅ 蛊
  • ✅ 机缘
  • ✅ 世界秘密
  • ✅ POI
  • ✅ 背景板NPC

🔭 远期展望

  • [ ] 飞升上界
  • [ ] 开宗立派/成为皇帝
  • [ ] 历史/事件的小说化&图片化&视频化
  • [ ] Skill agent化，修士自行规划、分析、调用工具、决策
  • [ ] 将自己的Claw配入修仙世界
排名相邻
同类项目