这是一款以修仙为主题的文字冒险游戏,玩家将扮演一名修仙者,通过历练、修炼、突破境界等方式不断提升实力。游戏采用AI生成事件机制,每次历练都会遇到不同的随机事件,让每一次游戏体验都充满未知与惊喜。

• 🎲 AI驱动事件系统 - 使用 AI 生成丰富的随机事件,每次历练都是全新体验
• 🏔️ 完整修仙体系 - 从炼气期到飞升,7大境界,每个境界10层,共70层修炼之路
• 🌌 长生境规则之力 - 领悟天地规则,掌握改天换地的强大力量
• ⚔️ 合道期挑战 - 挑战天地之魄,证明合道实力,突破生命极限
• 🎒 丰富装备系统 - 武器、护甲、首饰、戒指、法宝等多样装备,支持祭炼强化
• 🐉 灵宠养成 - 收集、培养、进化灵宠,与灵宠并肩作战
• 🏛️ 宗门系统 - 加入宗门,完成宗门任务,兑换稀有物品
• 🎫 抽奖系统 - 使用抽奖券抽取稀有奖励,包含保底机制
• 🏆 成就系统 - 完成各种成就,获得称号和奖励
• 💎 本命法宝 - 祭炼本命法宝,获得50%属性加成
• ⚔️ 危险历练 - 遭遇邪修、魔修、陷阱等危险事件,体验真实的修仙世界

• Node.js >= 18.0.0
• pnpm >= 8.0.0 (推荐) 或 npm >= 9.0.0

git clone <repository-url>
cd react-xiuxian-game

使用 pnpm (推荐):

pnpm install

或使用 npm:

npm install

⚠️ 重要: 项目不再包含硬编码的 API Key,必须配置环境变量。

默认配置: 项目默认使用 GLM (智谱AI) 作为 AI 接口,只需配置 API Key 即可。

在项目根目录创建 .env.local 文件:

# .env.local
# 最小配置:只需设置 API Key,其他使用默认值(GLM/智谱AI)
VITE_AI_KEY=your-api-key-here
# 可选配置(如果不设置,将使用默认值)
# VITE_AI_PROVIDER=glm # 默认: glm (智谱AI)
# VITE_AI_MODEL=glm-4.5v # 默认模型

💡 获取 API Key:

• 访问 智谱AI开放平台 注册账号并创建 API Key
• 如需使用其他 AI 服务(SiliconFlow、OpenAI 等),设置 VITE_AI_PROVIDER 环境变量
• 支持的提供商:glm(默认)、siliconflow、openai、custom

⚠️ 安全提示: .env.local 文件已添加到 .gitignore,不会被提交到 Git。不要将 API Key 提交到代码仓库。

# 使用 pnpm
pnpm dev
# 或使用 npm
npm run dev

打开浏览器访问: http://localhost:3000

1. 输入你的修仙者名称
2. 系统会随机分配一个天赋(不可更改)
3. 开始你的修仙之旅!

游戏包含以下核心属性:

• 气血 (HP) - 生命值,战斗和危险事件会消耗气血
• 修为 (EXP) - 经验值,通过历练和修炼获得
• 攻击 - 影响战斗伤害
• 防御 - 减少受到的伤害
• 神识 - 影响法术威力和感知能力
• 体魄 - 影响生命上限和物理抗性
• 速度 - 影响行动顺序和闪避
• 幸运 - 影响随机事件的好坏
• 灵石 - 游戏货币,用于购买物品和服务

点击 "历练" 按钮,触发随机事件:

• ✅ 正面事件: 获得修为、灵石、物品、灵宠等
• ⚠️ 危险事件: 遭遇邪修、魔修、陷阱,可能受伤、属性降低或被抢灵石
• 🌌 特殊事件: 触发随机秘境,进入后获得更高风险和收益
• 🎫 抽奖券: 偶尔获得抽奖券,可在抽奖系统使用
• 🏆 传承: 极小概率获得传承,可直接突破1-4个境界

• 打坐修炼: 消耗时间获得修为,安全稳定
• 突破境界: 当修为达到上限时,可以尝试突破
  • 突破成功:提升境界或境界层数,大幅提升属性
  • 突破失败:修为和气血会减少,需要重新积累

• 装备类型:

  • 🗡️ 武器 - 提升攻击力
  • 🛡️ 护甲 - 提升防御力(头部、肩部、胸甲、手套、裤腿、鞋子)
  • 💍 戒指 - 最多装备4个,提供各种属性加成
  • 📿 首饰 - 最多装备2个,提供特殊效果
  • 🏺 法宝 - 最多装备2个,提供强大属性加成

• 装备强化: 使用强化材料和灵石强化装备,提升属性

• 本命法宝:

  • 选择一件法宝进行祭炼,消耗气血上限
  • 本命法宝获得 50% 属性加成
  • 同时只能拥有一件本命法宝

• 获得灵宠: 通过历练、抽奖等方式获得灵兽蛋,孵化后获得灵宠
• 培养灵宠:
  • 喂食灵宠提升经验
  • 灵宠升级后属性提升
  • 达到一定等级可进化,获得更强属性
• 灵宠技能: 每个灵宠都有独特的技能,提供战斗或辅助效果

• 加入宗门: 达到一定境界后可加入宗门
• 宗门任务:
  • 完成宗门任务获得贡献
  • 部分任务有每日限制(如巡逻任务每日10次)
• 宗门商店: 使用贡献兑换稀有物品
• 宗门等级: 提升宗门等级,解锁更多权限

• 收集材料: 通过历练获得炼丹材料
• 炼制丹药: 消耗材料和灵石炼制丹药
• 丹药效果: 使用丹药获得临时或永久属性提升

• 获得抽奖券: 通过历练、成就等方式获得
• 抽奖奖励:
  • 灵石、修为、物品、灵宠、抽奖券等
  • 每10次抽奖必得稀有以上奖励(保底机制)

• 完成成就: 达成各种条件解锁成就
• 成就奖励: 获得称号、属性加成等奖励
• 称号系统: 装备称号获得额外属性加成

• 提升境界,突破到更高层次
• 收集强力装备,提升战斗力
• 培养灵宠,获得战斗伙伴
• 完成成就,解锁称号

• 🏆 飞升成仙 - 达到最高境界"飞升"
• 💎 收集仙品 - 获得所有仙品装备和灵宠
• 🏛️ 宗门领袖 - 在宗门中达到最高等级
• 🎖️ 成就大师 - 完成所有成就

• 前端框架: React 19.2.0
• 开发语言: TypeScript 5.8.2
• 构建工具: Vite 6.2.0
• UI图标: Lucide React
• AI服务: 支持多种 AI 服务(默认 GLM/智谱AI,支持 SiliconFlow、OpenAI 等)
• 状态管理: React Hooks (useState, useEffect)
• 数据持久化: localStorage

react-xiuxian-game/
├── components/ # React 组件
│ ├── AchievementModal.tsx # 成就弹窗
│ ├── AlchemyModal.tsx # 炼丹弹窗
│ ├── CharacterModal.tsx # 角色信息弹窗
│ ├── InventoryModal.tsx # 背包弹窗
│ ├── LotteryModal.tsx # 抽奖弹窗
│ ├── PetModal.tsx # 灵宠弹窗
│ ├── SectModal.tsx # 宗门弹窗
│ ├── ShopModal.tsx # 商店弹窗
│ └── ...
├── services/ # 服务层
│ └── aiService.ts # AI 事件生成服务
├── types.ts # TypeScript 类型定义
├── constants.ts # 游戏常量配置
├── App.tsx # 主应用组件
├── index.tsx # 应用入口
└── vite.config.ts # Vite 配置

📸 截图功能待添加,欢迎贡献!

# 开发模式
pnpm dev # 或 npm run dev
# 构建生产版本
pnpm build # 或 npm run build
# 预览生产构建
pnpm preview # 或 npm run preview

支持使用 Docker 进行部署,提供一键构建和打包命令。详细说明请查看 Docker 部署指南。

# 1. 配置环境变量(创建 .env 文件)
VITE_AI_KEY=your_api_key
VITE_AI_PROVIDER=glm
# 2. 一键构建并启动(推荐)
npm run docker:build-and-up
# 3. 访问应用
# http://localhost:3000

# 使用 npm 脚本(推荐)
npm run docker:build-and-pack
# 或使用 make 命令
make build-and-pack
# 这会生成 react-xiuxian-game.tar.gz 文件

# 查看日志
npm run docker:logs
# 或
make logs
# 停止容器
npm run docker:down
# 或
make down
# 构建镜像(无缓存)
npm run docker:build-no-cache

# 查看 npm 脚本
npm run
# 查看 Makefile 命令
make help

# 在目标机器导入打包的镜像
docker load < react-xiuxian-game.tar.gz

更多详细信息和高级配置,请查看:

• Docker 部署指南 - 完整的部署文档
• Docker 使用示例 - 常见场景和最佳实践

当前版本: v0.3.2 (2026年01月07日)

查看完整的版本更新历史和功能计划,请访问 CHANGELOG.md。

• 🌟 长生境系统: 新增规则之力系统,大幅提升后期玩法深度
• ⚔️ 合道期挑战: 新增天地之魄 BOSS 挑战,突破合道期的必经之路
• 🔨 法宝祭炼: 完整的装备强化系统,支持法宝属性进阶
• 🎨 UI/UX 优化: 适配新系统的交互界面,优化大后期性能表现

游戏共有 7大境界,每个境界有 10层:

1. 炼气期 - 修仙入门
2. 筑基期 - 奠定基础
3. 金丹期 - 凝聚金丹
4. 元婴期 - 元婴出窍
5. 化神期 - 神识化神
6. 炼虚期 - 虚空炼体
7. 飞升 - 成仙之路

• 普通 (白色) - 基础物品
• 稀有 (蓝色) - 属性提升 1.5倍
• 传说 (紫色) - 属性提升 2.5倍
• 仙品 (金色) - 属性提升 5.0倍

• 装备不可叠加 - 每件装备只能拥有1个
• 装备属性预览 - 装备描述中显示属性加成
• 本命法宝 - 只能同时拥有1个本命法宝

历练时可能遭遇:

• ⚠️ 邪修/魔修 - 可能受伤、被抢灵石、修为降低
• 🪤 陷阱 - 可能受伤、属性降低
• 🌌 随机秘境 - 高风险高收益的特殊区域

欢迎贡献代码、报告问题或提出建议!

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

• 感谢所有修仙小说作者提供的灵感
• 感谢 GLM (智谱AI)、SiliconFlow、OpenAI 等 AI 服务提供商