4f9c6d4c79d92c0d821ab75fa2bd8a9f4a9e1a60
修仙世界模拟器 (Cultivation World Simulator)
一个基于规则和AI驱动的修仙世界模拟器,旨在创造一个真正活着的、有沉浸感的仙侠世界。
简介
修仙世界模拟器是一个结合传统游戏规则系统和现代AI技术的仿真项目。通过建立完整的修仙世界模型,包括地形、角色、修炼体系、人际关系等要素,创造一个可以自主运行、充满生机的虚拟修仙世界。
项目的核心理念是:先建立可信的规则体系作为"世界模型"基础,再接入AI使世界生动起来。
截图预览
功能开发进度
🏗️ 基础系统
- ✅ 基础世界地图系统
- ✅ 多样化地形类型(平原、山脉、森林、沙漠、水域等)
- ✅ 时间系统(年月日历)
- ✅ 前端显示界面(pygame)
- ✅ 基础模拟器框架
- ✅ 项目文档(README)
- 配置文件系统(config)
- Web前端支持(从pygame切换)
- ECS并行工具(后期考虑)
🗺️ 地块系统
- ✅ 基础tile地块系统
- 同tile内NPC相互交互
- 乡村和城镇的机制
- 灵气分布与产出设计
- 地块间移动(move_to_region action)
👤 角色系统
- ✅ 角色基础属性系统
- ✅ 修炼境界体系
- ✅ 灵根系统
- ✅ 基础移动动作
- 动态的突破成功概率
- 角色关系系统
- 性格系统设计
- 角色特殊能力
- 角色称号&绰号
- 战斗相关
- 属性点分配
- 技能系统(功法)
- 装备系统
- 法宝系统
- 阵法
- 技能学习系统:
- 可学习技能
- 个人技(灵活融入代码)
- 生活技能
- 凡人角色支持
- 角色突破机制
🏛️ 组织系统
- 宗门系统
- 世家系统
- 朝廷系统(待定)
- 组织间关系网络
⚡ 动作系统
- ✅ 基础移动动作
- 有明确规则的定义动作
- 影响人际关系的LLM动作
- 动作执行框架
🎭 事件系统
- 世界范围大事件:
- 拍卖会
- 秘境探索
- 比武大会
- 规则发起事件
- NPC发起事件
- 自然事件:
- 自然灾害
- 天灾
- 战争
- 兽潮
⚔️ 战斗系统
- 战斗方式设计
- 优劣互克关系
- 胜率计算系统
- 战斗规则引擎
🎒 物品系统
- 基础物品框架
- 物品属性系统
- 物品交易机制
🌿 生态系统
- 魔兽系统
- 动植物生态
- 生物间相互关系
🤖 AI增强系统
- 角色AI系统(规则AI + LLM接口预留)
- LLM驱动的NPC对话
- 智能决策系统
- 动态剧情生成
- NPC观测空间设计
- NPC之间关系交互
- LLM接口集成
🏛️ 世界背景系统
- 上古历史生成
- 世界观设定
- 背景故事框架
使用方法
环境要求
- Python 3.8+
- pygame
- PyYAML
运行步骤
-
克隆项目到本地:
git clone https://github.com/your-username/cultivation-world-simulator.git cd cultivation-world-simulator -
安装依赖(如需要的话):
pip install pygame pyyaml -
运行模拟器:
python src/tools/run.py
基本操作
- 启动后会自动生成随机地图
- 可以观察角色在世界中的移动和行为
- 按ESC退出程序
项目背景
从小一直是修仙网文的读者,从最早的蜀山仙侠传,到比较新的赤心巡天,修仙网文陪伴了我非常多的时间。
作为游戏AI行业的从业者,对LLM这两年的进步感触很深。我认为,现在的LLM智能水平,已经足够支持起来一些仙侠风格的世界模拟了。
但是,纯粹只有LLM为NPC提供决策和对话能力是不够的。首先,要有可信的规则打底,作为修仙世界的"世界模型"。之后,才是接入LLM,使其生动起来。
我希望能够创造出纯粹的、快乐的、直接的、活着的修仙世界的沉浸感。不是像一些游戏公司的纯粹宣传工具,也不是像斯坦福小镇那样的纯粹研究,而是能给玩家提供真实代入感和沉浸感的实际世界。
项目结构
cultivation-world-simulator/
├── src/ # 核心源代码
│ ├── classes/ # 核心数据类
│ │ ├── avatar.py # 角色系统
│ │ ├── world.py # 世界模型
│ │ ├── tile.py # 地图系统
│ │ └── ... # 其他核心类
│ ├── front/ # 前端显示模块
│ │ └── front.py # pygame界面
│ ├── sim/ # 模拟引擎
│ │ ├── simulator.py # 核心模拟器
│ │ └── event.py # 事件系统
│ ├── tools/ # 工具脚本
│ │ ├── run.py # 主程序入口
│ │ └── create_map.py # 地图生成工具
│ └── utils/ # 实用工具
│ └── strings.py # 字符串处理
├── assets/ # 游戏资源
│ ├── tiles/ # 地形贴图
│ ├── males/ # 男性角色头像
│ └── females/ # 女性角色头像
├── configs/ # 配置文件
├── tests/ # 测试代码
└── README.md # 项目说明
技术架构
- 前端显示: pygame (计划未来支持Web)
- 模拟引擎: 自研事件驱动模拟器
- 世界模型: 基于规则的确定性系统
- AI集成: 预留LLM接口,支持混合决策
贡献指南
欢迎对修仙世界模拟器项目的贡献!无论是代码、创意还是测试反馈都非常宝贵。
许可证
本项目采用 LICENSE 文件中指定的许可证。
联系方式
如果您对项目有任何问题或建议,欢迎提交 Issue 或 Pull Request。
Description
基于 AI Agent 工作流的修仙世界模拟器,旨在还原智能、开放的仙侠世界。| An open-source Cultivation World Simulator using Agentic Workflow to create a dynamic, emerging Xianxia world.
Languages
Python
77.8%
TypeScript
11.8%
Vue
8.5%
HTML
1.2%
PowerShell
0.6%
