⚔️ 凡人修仙传 RPG — VSCode/Cursor 修仙游戏插件
世界观基于《凡人修仙传》小说，从韩立踏入修仙界到结丹圆满的完整修炼旅程。
隐藏在代码编辑器里的修仙模拟器——摸鱼神器。
📦 安装方式
方式一：VSIX 安装（推荐）
- 在 Cursor 中按
Ctrl+Shift+P
- 输入
Extensions: Install from VSIX
- 选择
xian-rpg-2.0.3.vsix 文件
- 安装完成后按
Ctrl+Shift+P → Reload Window
方式二：手动安装
将扩展目录放入 Cursor/VSCode 的 extensions 文件夹：
C:\Users\你的用户名\.cursor\extensions\wanxiong.xian-rpg-2.0.3\
目录结构需包含 package.json、icon.png 和 out\ 文件夹，然后 Reload Window。
🚀 快速开始
| 操作 |
方式 |
| 打开游戏 |
点击左下角状态栏 📖 修仙 图标 |
| 打开游戏 |
Ctrl+Shift+P → 修仙: 打开游戏 |
| 保存存档 |
Ctrl+Shift+P → 修仙: 保存存档 |
| 重置全部 |
Ctrl+Shift+P → 修仙: 重新开始 |
🎮 游戏系统详解
一、多角色存档系统
游戏提供 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，终极目标）
突破丹药汇总
| 丹药 |
突破节点 |
成功率 |
主要掉落来源 |
| 🌟 筑基丹 |
练气→筑基 |
80% |
任务、副本 |
| 🔵 化基丹 |
筑基初→中 |
75% |
筑基魔修 |
| 🟣 固基丹 |
筑基中→后 |
70% |
筑基魔修 |
| ⭐ 圆满丹 |
筑基后→圆满 |
65% |
筑基后期魔修 |
| 🌕 凝丹丹 |
筑基圆满→结丹 |
55% |
筑基后期魔修 |
| 💛 养丹丹 |
结丹初→中 |
60% |
结丹初期老祖 |
| 🧡 壮丹丹 |
结丹中→后 |
50% |
结丹中期老祖 |
| ❤️ 大成丹 |
结丹后→圆满 |
45% |
结丹后期大能 |
三、战斗系统
战斗为回合制，速度高者先手：
| 行动 |
说明 |
| 普通攻击 |
无消耗，造成基础伤害 |
| 法术技能 |
消耗MP/神识，强力效果 |
| 使用丹药 |
紧急回复，日志显示实际恢复量 |
| 遁逃 |
速度越高成功率越大（10%-90%） |
四、副本系统（v2.0 全新，共13个）
境界专属副本
| 副本 |
解锁 |
冷却 |
主要奖励 |
| 【练气】七玄门秘境 |
L3 |
12h |
培元丹、聚气丹 |
| 【练气】妖兽山脉 |
L8 |
24h |
七云丹、妖核 |
| 【练气末】魔道秘地 |
L11 |
48h |
真火丹、天罡丹 |
| 【筑基初期】天南外域 |
L14 |
48h |
化基丹、龙鳞 |
| 乱星海孤岛秘境 |
L14 |
72h |
化基丹、寒玉 |
| 【筑基中期】天南秘林 |
L24 |
72h |
固基丹、化基丹 |
| 【筑基后期】天南禁地 |
L34 |
96h |
圆满丹、凝丹丹 |
| 【筑基圆满】天南极境 |
L44 |
120h |
凝丹丹、养丹丹 |
| 【结丹初期】金丹秘境 |
L45 |
120h |
养丹丹、上古灵剑 |
| 天南秘境 |
L45 |
168h |
养丹丹、龙鳞 |
| 【结丹中期】大能秘地 |
L55 |
144h |
壮丹丹、凤羽 |
| 【结丹后期】道法极地 |
L65 |
168h |
大成丹、九天法杖 |
| 【结丹圆满】大道终点 |
L74 |
168h |
大成丹、古项链 |
🐉 山海神兽秘境（动态缩放，无限挑战）
- 解锁：L40 即可进入，无冷却时间
- 特色：怪物属性随玩家等级同步提升，永远具有挑战性
- 怪物：《山海经》原典异兽（饕餮、混沌兽、九婴、飞廉、刑天、共工等）
五、装备系统
共 10个装备部位：武器、防具、戒指、腰带、符箓槽、帽子、项链、手套、护腕、鞋子
- 背包管理：装备不叠加，每件独立，可直接点击「装备」/「卸下」
- 装备强化：消耗灵石提升装备属性
- 宝石镶嵌：为装备嵌入宝石增加额外属性
- 套装系统：集齐套装触发套装效果（2~9件套，共20套）
- 丢弃功能：所有物品均可丢弃
六、生产系统
| 系统 |
说明 |
| ⚗️ 炼丹 |
收集材料，按丹方炼制各类丹药 |
| 📜 制符 |
收集符材，制作攻防类符箓 |
| 🔨 锻造 |
收集锻材，打造法宝装备 |
| 🎲 重洗 |
消耗灵石随机重置装备属性 |
| 💎 镶嵌 |
为装备嵌入宝石强化属性 |
| ⬆️ 强化 |
消耗材料提升装备强化等级 |
七、图鉴系统
点击**「图鉴」**标签，含三个子页：
- 📦 物品图鉴：全部物品的描述、属性、获取来源
- ⚔️ 妖兽图鉴：全部妖兽的背景、数值、技能、掉落
- 🎭 套装图鉴：全部套装的件数、装备组成、激活效果
八、NPC 与任务
| NPC |
位置 |
出售物品 |
| 👴 墨大夫 |
七玄门 |
培元丹、聚气丹、小还丹、解毒丹、回气丹 |
| 🧑 厉飞宇 |
七玄门 |
培元丹、真火丹 |
| 🧔 王管事 |
七玄门 |
培元丹、小还丹、聚气丹 |
主线任务8条，覆盖从练气初期到结丹期的完整剧情线。
📊 状态栏说明
📖 韩立[筑基初期三层] ❤120/150 💙60/80 💎320 📋
HP 法力 灵石 有新任务
📁 项目文件结构
xian-rpg/
├── package.json # 扩展配置（发布者: wanxiong，版本: 2.0.3）
├── icon.png # 扩展图标
├── src/
│ ├── types.ts # 全部类型定义
│ ├── data.ts # 游戏数据（怪物/物品/副本/套装等）
│ ├── engine.ts # 游戏核心逻辑
│ ├── panel.ts # WebView 游戏界面
│ ├── statusbar.ts # 状态栏管理
│ └── extension.ts # 扩展入口
├── webview/src/ # Vue3 前端
│ ├── pages/ # 各功能页面
│ ├── stores/ # Pinia 状态管理
│ └── gameData.ts # 前端展示数据
└── out/ # 编译后JS（自动生成）
📋 更新日志
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、道侣、宠物系统
《凡人修仙传》世界观归原作者我吃西红柿所有，本游戏为同人创作，仅供娱乐。
