⚔️ 凡人修仙传 RPG — VSCode/Cursor 修仙游戏插件

世界观基于《凡人修仙传》小说，从韩立踏入修仙界到结丹圆满的完整修炼旅程。 隐藏在代码编辑器里的修仙模拟器——摸鱼神器。

📦 安装方式

方式一：VSIX 安装（推荐）

1. 在 Cursor 中按 Ctrl+Shift+P
2. 输入 Extensions: Install from VSIX
3. 选择 xian-rpg-3.0.0.vsix 文件
4. 安装完成后按 Ctrl+Shift+P → Reload Window

方式二：手动安装

将扩展目录放入 Cursor/VSCode 的 extensions 文件夹：

C:\Users\你的用户名\.cursor\extensions\wanxiong.xian-rpg-3.0.0\

目录结构需包含 package.json、icon.png 和 out\ 文件夹，然后 Reload Window。

🚀 快速开始

存档可能不兼容：升级后若遇到属性、装备或任务异常，请在升级提示或存档选择页一键清空存档，然后重新开始。

🎮 游戏系统详解

一、多角色存档系统

游戏提供 3个独立存档槽，每个存档进度完全独立，互不影响。

可选角色（道途）

二、修炼境界体系（v2.0 全新）

完全按照《凡人修仙传》原著设定，共 75级：

练气期（L1-13，共13层）
  └─ 一层 → 二层 → … → 十三层
        ↓ 需要【筑基丹】，80%成功率

筑基期（L14-44，共31级）
  ├─ 初期（L14-23，10层）─→ 突破需【化基丹】75%
  ├─ 中期（L24-33，10层）─→ 突破需【固基丹】70%
  ├─ 后期（L34-43，10层）─→ 突破需【圆满丹】65%
  └─ 圆满（L44）─────────→ 突破需【凝丹丹】55%

结丹期（L45-75，共31级）
  ├─ 初期（L45-54，10层）─→ 突破需【养丹丹】60%
  ├─ 中期（L55-64，10层）─→ 突破需【壮丹丹】50%
  ├─ 后期（L65-74，10层）─→ 突破需【大成丹】45%
  └─ 圆满（L75，终极目标）

突破丹药汇总

三、战斗系统

战斗为回合制，速度高者先手：

伤害分为 物理、金、木、水、火、土、风、雷、冰、毒、魂 11类。五行遵循金克木、木克土、土克水、水克火、火克金；风雷冰毒魂另有独立克制与抗性。攻击、法术强度、防御、速度、幸运、法力和神识均参与战斗结算。

四、副本系统（共14个）

境界专属副本

🐉 山海神兽秘境（动态缩放，无限挑战）

• 解锁：L40 即可进入，无冷却时间
• 特色：怪物属性随玩家等级同步提升，永远具有挑战性
• 怪物：《山海经》原典异兽（饕餮、混沌兽、九婴、飞廉、刑天、共工等）

五、装备系统

共 10个装备部位：武器、防具、戒指、腰带、符箓槽、帽子、项链、手套、护腕、鞋子

• 背包管理：装备不叠加，每件独立，可直接点击「装备」/「卸下」
• 装备强化：消耗灵石提升装备属性
• 宝石镶嵌：为装备嵌入宝石增加额外属性
• 套装系统：集齐套装触发套装效果（2~9件套，共20套）
• 九星装备：每件装备独立随机1~9星，界面固定展示9个星位
• 随机词条：1/2星1条、3/4星2条、5/6星3条、7/8星4条、9星5条
• 星级成长：星级提升基础属性倍率，幸运提高高星掉落概率
• 丢弃功能：所有物品均可丢弃

六、生产系统

七、图鉴系统

点击**「图鉴」**标签，含三个子页：

• 📦 物品图鉴：全部物品的描述、属性、获取来源
• ⚔️ 妖兽图鉴：全部妖兽的背景、数值、技能、掉落
• 🎭 套装图鉴：全部套装的件数、装备组成、激活效果

八、NPC 与任务

主线任务8条，覆盖从练气初期到结丹期的完整剧情线。

📊 状态栏说明

📖 韩立[筑基初期三层]  ❤120/150  💙60/80  💎320  📋
                         HP        法力     灵石   有新任务

📁 项目文件结构

xian-rpg/
├── package.json          # 扩展配置（发布者: wanxiong，版本: 3.0.0）
├── icon.png              # 扩展图标
├── src/
│   ├── types.ts          # 全部类型定义
│   ├── data.ts           # 游戏数据（怪物/物品/副本/套装等）
│   ├── combatRules.ts    # 五行与元素战斗规则
│   ├── equipmentRules.ts # 九星装备与随机词条规则
│   ├── dataValidation.ts # 数据表外键与槽位完整性校验
│   ├── engine.ts         # 游戏核心逻辑
│   ├── panel.ts          # WebView 游戏界面
│   ├── statusbar.ts      # 状态栏管理
│   └── extension.ts      # 扩展入口
├── webview/src/          # Vue3 前端
│   ├── pages/            # 各功能页面
│   ├── stores/           # Pinia 状态管理
│   └── gameData.ts       # 前端展示数据
├── tests/                # 核心流程与数据表回归测试
└── out/                  # 编译后JS（自动生成）

📋 更新日志

v3.0.0（当前版本）

• 存档可能不兼容：升级时弹窗提示，可一键清空；存档页新增清空全部存档
• 任务检测重构：接取时读取当前等级和当前持有数量，修复小还丹30个仍为0、提前升级后卡任务
• 属性单一结算：装备、星级词条、强化、宝石、套装、灵兽、道侣和状态统一由后端计算，并显示来源明细
• 元素战斗系统：加入五行、风、雷、冰、毒、魂伤害、克制、抗性、命中、闪避和状态抵抗
• 九星装备系统：同名装备实例独立随机1~9星，星级决定基础倍率、词条数量和高星闪烁效果
• 装备实例修复：强化、宝石、星级、词条和重铸结果换装后不再丢失；初始装备卸下后仍保留
• 套装修复：山海神兽套移除双鞋，七玄剑圣套移除双护腕，所有20套均可实际穿齐
• 副本修复：山海怪物可正常生成，动态副本奖励不再变成1点修为
• 数据表校验：构建时校验物品、掉落、任务、配方、副本、套装槽位和元素字段

v2.0.3

• 新增：技能/功法 hover 展示详细效果与说明（人物页、战斗页均支持）
• 修复：物品携带数量改为无限制（移除30个上限）
• 优化：所有装备补全掉落来源，图鉴展示稀有度标签（普通/精良/稀有/史诗/传说）
• 优化：装备爆率按稀有度分级（common 20-25%，uncommon 10-15%，rare 5-8%，epic 2-5%）
• 优化：40+ 怪物全面补充装备掉落，共覆盖 70+ 件装备

v2.0.2

• 怪物先手修复：进入副本战斗时，若怪物速度更快，立即触发怪物攻击，而不只是显示提示文字

v2.0.1

• 副本无冷却：所有副本通关后可立即再次挑战，无任何等待时间
• 背包无上限：物品携带数量无限制，装备可无限存放

v2.0.0

• 境界体系重构：75级完整修炼路线（筑基/结丹各含初/中/后/圆满，每阶10层）
• 突破丹药系统：8种专属突破丹药，各有不同成功率与失败惩罚
• 副本扩充：从5个扩展至14个，每个修炼阶段均有专属副本
• 山海神兽秘境：L40解锁，怪物等级动态随玩家提升，无限挑战
• 新增BOSS：结丹中期老祖（L60）、结丹圆满守护者（L75）
• 新区域：结丹秘境（L65解锁）
• 图鉴滚动修复：修复所有页面无法滚动的根本原因
• 物品显示修复：补全缺失的装备名称，修复物品类型标签全部显示为中文
• 套装图鉴修复：套装内装备名称正确显示

v1.1.x 系列

• 装备实例化系统（每件装备独立ID，支持强化/镶嵌）
• 装备一键装备/卸下，丢弃功能
• 套装重构（每件装备仅属于一个套装）
• 套装 Tooltip 优化，HTML富文本显示
• 乱码修复（UTF-8无BOM编码）
• 物品栏滚动、图鉴滚动修复

v1.0.x 系列

• 炼丹、制符、锻造、重洗、镶嵌、强化系统
• 山海经主题怪物与装备（20种怪物、20种散装）
• 套装系统（20套，2-9件套）
• 图鉴系统（物品/妖兽/套装三合一）
• 多角色存档、战斗、副本、任务、NPC、道侣、宠物系统

《凡人修仙传》世界观归原作者忘语所有，本游戏为同人创作，仅供娱乐。