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

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

📦 安装方式

方式一：VSIX 安装（推荐）

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

方式二：手动安装

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

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

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

🚀 快速开始

操作	方式
打开游戏	点击左下角状态栏 `📖 修仙` 图标
打开游戏	`Ctrl+Shift+P` → `修仙: 打开游戏`
保存存档	`Ctrl+Shift+P` → `修仙: 保存存档`
重置全部	`Ctrl+Shift+P` → `修仙: 重新开始`

🎮 游戏系统详解

一、多角色存档系统

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

可选角色（道途）

角色	图标	特点	起始法术	适合玩家
韩立	⚔️	剑修，天资平庸，坚韧不拔，主角道路	御剑术、青竹蜂云剑	新手推荐
厉飞宇	⚗️	丹修，天生丹火，擅长法术输出	真火术、丹火爆发	法术流
南宫婉	❄️	冰修，天生冰灵根，控制能力极强	寒冰箭、冰甲术	控制流
曲魂	👻	鬼修，鬼道秘术，诡异难测，爆发极高	鬼爪、魂缚	高难度

二、修炼境界体系

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

练气期（1-13层）
  └─ 练气一层 → 二层 → 三层 → ... → 十三层
        ↓ 需要【筑基丹】，80%成功率
筑基期（4阶）
  └─ 筑基初期 → 中期 → 后期 → 圆满
        ↓ 无需丹药，50%成功率
结丹期（4阶）
  └─ 结丹初期 → 中期 → 后期 → 圆满（终极目标）

突破类型	条件	成功率	失败惩罚
练气各层（1-12层）	修为达到上限	自动突破	无
练气十三层 → 筑基	修为满 + 筑基丹×1	80%	HP-30%
筑基圆满 → 结丹	修为满	50%	HP-40%，修为归零80%

三、战斗系统

战斗为回合制，速度高者先手（速度更快的敌人会先手出击）：

行动	说明
普通攻击	无消耗，造成基础伤害
法术技能	消耗MP/神识，强力效果
使用丹药	紧急回复，日志显示实际恢复量
遁逃	速度越高成功率越大（10%-90%）

四、NPC 系统与商店

游戏中有4位关键NPC，点击左侧人物列表后展开对话，选择**「购买丹药」**即可进入商店：

NPC	出售物品
👴 墨大夫	培元丹、聚气丹、小还丹、解毒丹、回气丹
🧑 厉飞宇	培元丹、真火丹
🧔 王管事	培元丹、小还丹、聚气丹

五、法宝装备系统

共6个装备部位，在**「道基」页**管理：

已装备：点击装备格直接卸下
空槽：点击展开下拉，从背包选择对应部位装备
悬浮提示：鼠标悬停任意物品显示名称、属性、故事描述

六、副本系统

副本	解锁境界	冷却	主要奖励
🔮 七玄门秘境	练气五层	12小时	聚气丹、培元丹
⛰️ 妖兽山脉	练气八层	24小时	七云丹、小还丹
😈 魔道秘地	练气十三层	48小时	真火丹、玄铁道袍
🏝️ 乱星海孤岛	筑基后期	72小时	凝元丹、火鸦幡
🌅 天南秘境	结丹初期	168小时	青竹蜂云剑、筑基丹

七、图鉴系统（新增）

点击**「图鉴」**标签页，包含两个子页面：

📦 物品图鉴

展示全部22种物品
每件物品含：世界观描述、属性数值、获取来源（怪物掉落率/副本/任务/商店）

⚔️ 妖兽图鉴

展示全部11种妖兽
每只妖兽含：背景描述、基础数值（HP/攻击/防御/速度/经验）、技能详情、掉落物品及概率

八、主线任务

#	任务名	解锁条件	奖励
1	初入七玄门	游戏开始	培元丹×2、道袍
2	结交道友	完成1 + Lv.3	聚气丹、培元丹
3	墨大夫的考验	完成2 + Lv.5	七云丹、飞剑
4	清剿妖兽	完成3 + Lv.6	小还丹×2
5	乱星海前的准备	完成4 + Lv.7	回气丹
6	乱星海奇缘	完成5 + Lv.9	千年寒玉 + 解锁道侣
7	筑基之路	完成6 + Lv.11	大还丹、天罡血晶
8	结丹大业	完成7 + Lv.14	凝元丹×2 + 蛟龙鳞片

📊 状态栏说明

📖 韩立[练气八层]  ❤120/150  💙60/80  💎320  📋
                    HP        法力     灵石   有新任务

📁 项目文件结构

xian-rpg/
├── package.json          # 扩展配置（发布者: wanxiong，版本: 1.0.3）
├── icon.png              # 扩展图标
├── src/
│   ├── types.ts          # 全部类型定义
│   ├── data.ts           # 游戏数据
│   ├── engine.ts         # 游戏核心逻辑
│   ├── panel.ts          # WebView 游戏界面
│   ├── statusbar.ts      # 状态栏管理
│   └── extension.ts      # 扩展入口
└── out/                  # 编译后JS（自动生成）

📋 更新日志

v1.0.3

新增「图鉴」Tab：物品图鉴（来源/描述/掉落率）+ 妖兽图鉴（技能/数值/掉落）
物品悬浮 Tooltip 增加故事描述
所有物品描述改为中文，新增世界观 lore 文字
修复图鉴页 HTML 结构错误导致内容不显示
修复 NPC 商店：点击 NPC 后商店选项正常展示
装备描述、丹药描述全面汉化

v1.0.2

道基页新增装备槽管理（点击装备/卸下/下拉选择）
物品悬浮 Tooltip
使用丹药日志显示实际恢复量（气血 +XX，法力 +XX）
NPC 商店购买功能
修复怪物先手导致玩家无法攻击的 bug
法术/装备描述汉化

v1.0.1

修复 WebView 脚本语法错误导致界面空白
发布者 ID 更新为 wanxiong

v1.0.0

初始版本：多角色存档、修炼/战斗/副本/任务/NPC/道侣/宠物系统

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