Enjoy!

插件功能说明

项目简介

Mir2Script 是一个专为 996PC 引擎脚本语言开发的 VSCode 扩展插件，提供完整的代码编辑、导航、补全和调试支持，大幅提升脚本开发效率。

• 插件名称: mir2script
• 版本: 0.4.8
• 作者: 不吃青椒
• 支持语言: mir2script (文件扩展名: .txt)
• 最低 VSCode 版本: 1.60.2

全部功能

核心功能

1. 语法高亮与主题

• ✅ 语法高亮: 完整的 mir2script 语法高亮支持
• ✅ 深色主题: 996引擎PC端脚本主题(深色)
• ✅ 浅色主题: 996引擎PC端脚本主题(浅色)
• ✅ 自定义命令语法高亮: 用户自定义命令自动应用语法高亮
• ✅ 主题关键字颜色自定义: 命令面板执行 [主题颜色设置]，左侧调整各关键字颜色、右侧实时预览，支持导入/导出配色、恢复默认

2. 代码智能补全

• ✅ 命令补全: 支持所有引擎命令的智能补全
• ✅ 参数提示: 显示命令参数列表和说明（快捷键: Ctrl+J）
• ✅ 代码片段: 内置常用代码片段，快速生成代码模板
• ✅ 文件路径补全: 支持文件路径自动补全（触发字符: *, \, ., @）
• ✅ 常量补全: 自动补全系统常量
• ✅ 物品补全: 自动补全物品名称
• ✅ 触发补全: 自动补全触发事件
• ✅ 颜色补全: 自动补全颜色代码
• ✅ 简化模式: 可配置是否显示完整参数列表

3. 代码导航与跳转

3.1 定义跳转 (F12)

• ✅ 函数跳转: 跳转到函数定义位置
• ✅ 变量跳转: 跳转到变量定义位置
• ✅ Call 跳转: #call [路径] @标签 跳转到目标脚本
• ✅ SendCenterMsg 跳转: 跳转到消息处理标签
• ✅ SetOnTimer 跳转: 跳转到定时器标签 [@OnTimer]
• ✅ GMEXECUTE 跳转: 跳转到 GM 执行标签
• ✅ AutoRun 跳转: 跳转到自动运行标签
• ✅ NPC 跳转: 跳转到 NPC 脚本文件
• ✅ NPC 顶戴跳转: merchant.txt 右键 [跳转到NPC顶戴]，跳转到顶戴文件（不存在时提示创建）
• ✅ 地图跳转: 在 mapinfo.txt 中跳转到地图定义
• ✅ 门点跳转: 门点行的地图编号可跳转到地图定义
• ✅ 刷怪跳转: mongen.txt 中地图编号跳转到地图定义，怪物名称跳转到爆率文件
• ✅ 文件跳转: 支持多种命令的文件路径跳转，文件不存在时提示创建

3.2 引用查找

• ✅ 查找引用: 右键菜单或命令面板选择 [查找引用]，查找函数/标签的所有引用位置
• ✅ Shift+F12: 光标在变量或 [@标签] 上按 Shift+F12 快速查找引用并跳转到调用位置
• ✅ 引用树视图: 在侧边栏"函数引用"视图中查看所有引用关系
• ✅ 多标签支持: 支持 [@OnTimer]、autoRun、gmexecute 等标签的引用查找

4. 代码折叠

• ✅ 智能折叠: 自动识别代码块进行折叠
• ✅ 快捷键:
  • 一键折叠: Ctrl+K Ctrl+0
  • 一键展开: Ctrl+K Ctrl+J
• ✅ Sticky Scroll: 自动启用代码折叠粘性滚动

5. 悬停提示 (Hover)

• ✅ 命令说明: 鼠标悬停显示命令完整参数和说明
• ✅ 变量备注: 显示变量的备注信息
• ✅ 地图名称: 地图编号参数显示对应地图名称
• ✅ 当前参数高亮: 使用 * 标记当前光标所在的参数位置

6. 变量管理

6.1 变量搜索视图

• ✅ 变量占用视图: 侧边栏显示所有变量占用情况
• ✅ 变量分类: 支持全局变量、行会变量、私人变量、N$数值变量、S$字符变量
• ✅ 变量备注: 支持为变量添加备注，右键菜单修改备注
• ✅ 快速搜索: 点击变量在文件中搜索所有引用

6.2 变量相关功能

• ✅ 重新加载变量: 命令 [重新加载变量] 刷新变量列表
• ✅ 变量定义跳转: Ctrl+左键跳转到变量定义
• ✅ 变量补全: 自动补全已定义的变量

7. 文档大纲

• ✅ 符号导航: 在文档大纲视图中查看所有函数、标签、触发等符号
• ✅ 快速定位: 点击符号快速跳转到对应位置
• ✅ 触发类型说明: 大纲中显示触发类型信息

8. 代码格式化与对齐

• ✅ 一键对齐: 支持以下文件的一键对齐功能
  • merchant.txt - 商人配置
  • mongen.txt - 刷怪配置
  • startpoint.txt - 起始点配置
  • minimap.txt - 小地图配置
  • npcs.txt - NPC 配置
  • shopitemlist.txt - 商店物品列表
  • monsaymsg.txt - 怪物说话消息
  • guardlist.txt - 守卫列表
  • firedragonguard.txt - 火龙守卫
  • filteritemlist.txt - 过滤物品列表
• ✅ 列头固定: 第一行以 ; 开头的文件支持列头固定显示
• ✅ 注释对齐: 对齐时也会对齐注释部分

9. 地图相关功能

9.1 地图参数管理

• ✅ 添加地图参数: 在地图定义行右键选择 [添加地图参数]，快速添加常用地图参数
• ✅ 参数校验: 自动检查地图参数是否正确（可配置开关）
• ✅ 地图文件校验: 自动检查地图文件是否存在（可配置开关）

9.2 地图关系图

• ✅ 关系图可视化: 在 mapinfo.txt 中右键选择 [显示关系图]
• ✅ 交互式图表: 支持拖拽节点、缩放画布
• ✅ 层级选择: 支持 1-5 层和全部层级显示
• ✅ 双向链接: 自动合并双向链接为一条双向箭头
• ✅ 节点信息: 显示地图编号和名称
• ✅ 上下文显示:
  • 右键空行显示全部地图关系
  • 右键地图声明行或链接行显示该地图的相关关系

9.3 地图名称显示

• ✅ 门点地图名称: 在 mapinfo.txt 门点行的地图编号后显示地图名称
• ✅ 刷怪地图名称: 在 mongen.txt 第一个参数（地图编号）后显示地图名称
• ✅ 悬停提示: 鼠标悬停查看完整地图名称

10. 刷怪文件功能

10.1 刷怪可视化

• ✅ 可视化显示: 在 mongen.txt 中右键选择 [查看怪物刷新位置] 或按 F4
• ✅ 交互功能:
  • 支持缩放与拖拽
  • 地图右键复制鼠标所在位置坐标
  • 支持怪物筛选
  • 点击怪物坐标直接定位到 mongen.txt 对应行
• ✅ 范围显示: 显示光标所在行的怪物刷新范围

10.2 怪物数量统计

• ✅ 地图怪物统计: 在 mongen.txt 中右键选择 [查看地图怪物数量]
• ✅ 统计图表: 使用柱状图显示怪物数量分布
• ✅ 详细统计:
  • 右键空行显示全部地图数据统计
  • 右键有地图数据的行显示该地图的详细统计（总量和每个怪物的数量）
• ✅ 主题适配: 自动适配深色/浅色主题
• ✅ 标签显示: 单个地图详情图表在柱子顶部显示怪物数量标签

10.3 地图爆率查看

• ✅ 爆率分析: 在 mongen.txt 或 mapinfo.txt 中右键选择 [显示地图爆率]
• ✅ 数据展示:
  • 柱状图显示各物品被多少怪物爆出
  • 表格显示详细的掉落信息（物品、爆率、数量、怪物、刷新数量、刷新时间）
• ✅ 爆率解析:
  • 支持传统格式：几率 物品名 (数量)
  • 支持 #CHILD 格式：#CHILD 几率 RANDOM 和 #CHILD 几率，显示 CHILD 爆率和子爆率
  • RANDOM 块显示括号内物品总数
• ✅ 搜索筛选:
  • 物品名称和怪物名称搜索框，支持精确/模糊匹配切换
  • 点击表格中的物品或怪物名称自动填入搜索框
  • 点击图表柱状图自动搜索对应物品
  • 搜索框右侧显示清除图标（×），点击清空
• ✅ 快速跳转: 点击物品名称或"跳转爆率文件"按钮，自动打开对应的爆率文件并定位到对应行
• ✅ 自动刷新: 保存爆率文件后，Webview 自动刷新数据，保留当前搜索条件
• ✅ 统计信息: 显示怪物种类、掉落物条数、物品种类等统计信息

10.4 爆率设置

• ✅ 爆率设置面板: 爆率文件右键 [爆率设置]，支持批量修改爆率
• ✅ 批量应用: 支持按怪物分组或全部怪物应用配置，可撤回
• ✅ 物品/怪物配置: 配置管理、物品名校验、爆率文件存在性校验
• ✅ 爆率查询: 命令 [爆率查询] 快速查询物品爆率

10.5 爆率文件操作

• ✅ 转换为#CHILD: 选中内容转为 #CHILD 1/100 RANDOM 格式
• ✅ 取消#CHILD爆率: 取消 #CHILD 包裹，支持递归取消嵌套
• ✅ 爆率对齐: 对齐 1/100 物品名 [数量] 格式的行

10.6 爆率文件校验

• ✅ 文件检测: 自动检测爆率文件是否存在（可配置开关）

11. 颜色功能

• ✅ 颜色选择器: 右键菜单选择 [选择颜色]，打开颜色选择对话框
• ✅ 颜色预览: 代码中的颜色值显示颜色预览方块
• ✅ 颜色补全: 自动补全颜色代码和名称
• ✅ COLOR 标签: 支持 <COLOR=#$XXXXXX 文字> 格式（996 引擎），悬停显示色块预览；右键可替换颜色值
• ✅ 渐变颜色: 选中文字右键 [设置渐变颜色]，支持 2 色或 3 色渐变；[去掉渐变色] 移除 COLOR 标签
• ✅ SendMsg/SendMsgNew 文字颜色: 选中文字右键 [设置文字颜色]、[取消文字颜色]
• ✅ MapDesc1.dat: 支持颜色预览和选择功能

12. 文本转换功能

• ✅ 变量转换: 选中文本，右键选择 [变量转换<$STR()>] 或按 Alt+F1，自动添加 <$STR()> 包裹
• ✅ FONT 转换: 选中文本，右键选择 [FONT转换<font>] 或按 Alt+F2，自动添加 <font> 标签包裹
• ✅ MonItems 专用: 爆率文件中 Alt+F1/Alt+F2 支持包裹↔不包裹、RANDOM↔非RANDOM 切换

13. 中文符号转换

• ✅ 自动转换: 自动将中文标点符号转换为英文标点符号
• ✅ 可配置符号: 支持配置需要转换的符号（《》、""、''、【】、｛｝、（）、：、；、，、。、？、！、￥、……）
• ✅ 状态栏显示: 在状态栏显示转换状态
• ✅ 开关控制: 可在设置中启用/禁用此功能

14. 文件备份功能

• ✅ 自动备份: 文件保存时自动创建备份（可配置开关）
• ✅ 备份位置: 备份文件保存在工作区 backups 文件夹下
• ✅ 备份命名: 格式为 原文件名_backup_yyyyMMdd_hhmmss.扩展名
• ✅ 路径保持: 备份文件保持原文件的相对路径结构
• ✅ 智能备份: 仅在文件内容发生变化时创建备份
• ✅ 编码保持: 支持中文编码（GB2312/UTF-8）自动识别和保持
• ✅ 查看备份: 右键菜单 [查看备份]，在快速选择列表中查看所有备份版本
• ✅ 还原备份: 在 diff 比较视图中一键还原到备份版本
• ✅ 备份管理:
  • [打开备份文件夹] - 打开备份目录
  • [清空所有备份文件] - 清空所有备份
  • [切换文件备份] - 快速切换备份功能开关
• ✅ 状态显示: 状态栏显示备份功能开关状态

15. 自定义命令功能

• ✅ 命令管理: 支持创建、编辑、删除用户自定义命令
• ✅ 自动集成: 自定义命令自动集成到代码补全和参数提示
• ✅ 语法高亮: 自定义命令支持与内置命令相同的语法高亮样式
• ✅ 参数配置: 支持命令参数配置（参数名、值、默认值、描述）
• ✅ 下拉选择: 参数值支持 JSON 数组格式（如下拉选择项）
• ✅ 编辑界面: 弹窗式编辑界面，无需滚动即可编辑
• ✅ 搜索过滤: 支持命令搜索过滤功能
• ✅ 导入导出: 支持批量备份和分享自定义命令
• ✅ 重复检测: 导入时自动检测重复命令，支持替换或跳过
• ✅ 实时刷新: 保存命令后自动刷新代码补全和语法高亮，无需重启

16. M2 服务器集成

• ✅ 自动获取 M2: 自动获取 M2 服务器窗口句柄
• ✅ M2 日志: 命令 [M2日志] 查看 M2 控制台日志
• ✅ M2 菜单: 侧边栏"引擎菜单"视图，显示 M2 菜单项
• ✅ 菜单点击: 命令 [点击M2菜单] 执行 M2 菜单操作
• ✅ 自动重载: 文件保存时自动重载 M2（支持多种文件类型）

17. 快捷功能视图

• ✅ 快捷功能面板: 侧边栏"快捷功能"视图，提供常用文件快速打开（支持 command:、explorer:、xlseditor: 等协议）
• ✅ Webview 界面: 使用 Webview 提供丰富的交互界面
• ✅ 保持状态: 切换侧边栏视图时不重新加载，保持当前状态

18. 数据库编辑 (XLS)

• ✅ 数据库编辑器: 编辑 cfg_item.xls、cfg_monster.xls、cfg_magic.xls 等数据库文件
• ✅ Tab 切换: 物品、怪物、技能分 Tab 展示，支持搜索、筛选、排序
• ✅ 冻结列: 可设置左侧固定 0～5 列
• ✅ 分类筛选: 物品支持按装备类、触发类、时装类、首饰盒等筛选
• ✅ 行操作: 每行「更多」下拉提供复制、删除；支持批量删除
• ✅ 侧边详情: 选中行显示物品/怪物/技能详细属性
• ✅ 快捷打开: 从 cfg_item.xls 等文件打开时自动进入对应 Tab；快捷功能支持 xlseditor: 协议

19. 代码校验 (LSP)

• ✅ 语法校验: 检查代码语法错误（可配置开关，默认关闭）
• ✅ 参数校验: 部分命令可以校验操作符或值是否在范围内
• ✅ 地图信息校验: mapinfo.txt 文件校验（可配置开关）
• ✅ 刷怪文件校验: mongen.txt 和爆率文件校验（可配置开关）

20. 文件路径补全

• ✅ 智能补全: 在需要文件路径的命令中自动补全文件路径
• ✅ 支持类型: 可配置支持的文件类型（默认: .txt, .ini）
• ✅ 触发字符: 可配置触发补全的字符（默认: *, , ., @）
• ✅ 隐藏文件: 可配置是否显示隐藏文件

21. 物品数据

• ✅ 物品加载: 命令 [加载物品数据] 加载物品数据库
• ✅ 物品提示: 代码中显示物品预览方块
• ✅ 物品补全: 自动补全物品名称
• ✅ 自动重载: 物品文件修改后自动重载

22. 触发提示

• ✅ 触发显示: 代码中显示触发事件的幻影注释
• ✅ 触发补全: 自动补全触发事件名称
• ✅ 主题适配: 根据主题颜色显示更加明显

23. 常量提示

• ✅ 常量显示: 代码中显示常量的幻影注释
• ✅ 常量补全: 自动补全系统常量
• ✅ CSV 配置: 支持从 CSV 文件加载常量配置

24. 符号大全

• ✅ 符号面板: 右键菜单 [符号大全]，弹出常用符号选择面板
• ✅ 分类浏览: 按类别展示符号，支持搜索和最近使用

25. 文件图标主题

• ✅ 996引擎图标: 内置文件图标主题，Ctrl+K Ctrl+T 选择「996引擎」
• ✅ 文件识别: 为脚本、配置、地图、数据库等文件类型分配专属图标

配置选项

代码校验相关

• mir2script.LspSwitch: 代码校验开关（默认: false）
• mir2script.MapInfoValidationSwitch: 地图信息文件校验开关（默认: false）
• mir2script.MongenValidationSwitch: 刷怪文件爆率文件校验开关（默认: false）

代码补全相关

• mir2script.CodeCompletionSwitch: 代码自动补全开关（默认: true，需重启生效）
• mir2script.CodeCompletionMode: 代码补全简化开关（默认: false，需重启生效）

提示功能相关

• mir2script.ConstantSwitch: 常量提示开关（默认: true，需重启生效）
• mir2script.ItemSwitch: 物品提示开关（默认: true，需重启生效）
• mir2script.TriggerSwitch: 触发提示开关（默认: true，需重启生效）
• mir2script.ColorSwitch: 颜色提示开关（默认: true，需重启生效）

M2 相关

• mir2script.getM2Switch: 是否启用获取 M2（默认: true）

文件路径补全相关

• filePathCompletion.supportedFileTypes: 支持的文件类型（默认: [".txt", ".ini"]）
• filePathCompletion.triggerCharacters: 触发字符（默认: ["*", "\", ".", "@"]）
• filePathCompletion.showHiddenFiles: 是否显示隐藏文件（默认: false）

中文符号转换相关

• chineseSymbolConverter.enable: 启用/禁用中文符号自动转换（默认: true）
• chineseSymbolConverter.showStatus: 在状态栏显示转换状态（默认: true）
• chineseSymbolConverter.symbolSettings: 符号转换设置（对象格式，键为中文符号，值为是否启用）

备份功能相关

• mir2script.backupEnabled: 启用/禁用文件自动备份功能（默认: true）

快捷键

命令列表

导航类

• [查找引用] - 查找当前符号的所有引用
• [重新加载变量] - 重新加载变量列表

转换类

• [变量转换<$STR()>] - 将选中文本包裹为 <$STR()>
• [FONT转换<font>] - 将选中文本包裹为 <font> 标签

地图类

• [地图参数] - 打开地图参数快速指南
• [添加地图参数] - 在地图定义行添加参数
• [显示关系图] - 显示地图关系图

刷怪类

• [查看怪物刷新位置] - 可视化显示怪物刷新位置
• [查看地图怪物数量] - 统计并显示地图怪物数量
• [显示地图爆率] - 查看地图的爆率信息（支持 mongen.txt 和 mapinfo.txt）
• [爆率设置] - 爆率文件批量修改、配置管理
• [爆率查询] - 快速查询物品爆率
• [爆率对齐] - 对齐爆率格式
• [转换为#CHILD爆率] - 转为 #CHILD 格式
• [取消#CHILD爆率] - 取消 #CHILD 包裹
• [删除不存在怪物] - 删除 cfg_Monster.xls 中不存在的怪物行
• [按地图生成怪物分组配置] - 按地图生成怪物分组配置文件

工具类

• [选择颜色] - 打开颜色选择器
• [符号大全] - 打开符号选择面板
• [删除当前行] - 删除当前行（默认 Ctrl+D）
• [一键对齐] - 对齐当前文件内容
• [加载物品数据] - 重新加载物品数据库
• [自定义命令] - 编辑自定义命令
• [打开数据库编辑器] - 打开 XLS 数据库编辑界面

M2 相关

• [M2日志] - 查看 M2 控制台日志
• [获取M2Server] - 获取 M2 服务器
• [点击M2菜单] - 执行 M2 菜单操作

备份类

• [查看备份] - 查看文件备份列表
• [还原为备份版本] - 还原到备份版本
• [切换文件备份] - 切换备份功能开关
• [打开备份文件夹] - 打开备份目录
• [清空所有备份文件] - 清空所有备份

符号转换

• 切换中文符号转换 - 切换符号转换功能
• 打开符号转换设置 - 打开符号转换配置
• 重置符号转换设置 - 重置符号转换配置

视图面板

996PC引擎脚本插件

• 快捷功能: Webview 视图，提供常用文件快速打开
• 函数引用: 树形视图，显示所有函数引用关系
• 引擎菜单: M2 菜单视图（需要 M2 激活）

996PC引擎变量搜索

• 变量占用: 树形视图，显示所有变量占用情况，支持备注和搜索

文件类型支持

插件主要支持以下文件类型的编辑和功能：

• 脚本文件 (.txt): NPC 脚本、QF 脚本、QM 脚本等
• 数据库文件 (.xls, .xlsx): cfg_item.xls、cfg_monster.xls、cfg_magic.xls 等，支持自定义数据库编辑器
• 地图数据 (.dat): MapDesc1.dat 支持颜色预览和选择
• 配置文件:
  • mapinfo.txt - 地图信息（支持关系图、参数管理、门点跳转、爆率查看）
  • mongen.txt - 刷怪配置（支持可视化、统计、跳转、爆率查看）
  • merchant.txt - 商人配置（支持对齐、跳转）
  • npcs.txt - NPC 配置（支持对齐、跳转）
  • startpoint.txt - 起始点配置（支持对齐）
  • minimap.txt - 小地图配置（支持对齐）
  • shopitemlist.txt - 商店物品列表（支持对齐）
  • monsaymsg.txt - 怪物说话消息（支持对齐）
  • guardlist.txt - 守卫列表（支持对齐）
  • firedragonguard.txt - 火龙守卫（支持对齐）
  • filteritemlist.txt - 过滤物品列表（支持对齐）

技术特性

编码支持

• ✅ 自动识别 GB2312 和 UTF-8 编码
• ✅ 文件保存时保持原编码格式
• ✅ 备份文件保持原编码格式

性能优化

• ✅ 延迟加载：按需加载数据，提升启动速度
• ✅ 缓存机制：缓存常用数据，减少重复计算
• ✅ 增量更新：仅更新变化的部分

错误处理

• ✅ 优雅降级：功能异常时不影响其他功能
• ✅ 错误提示：友好的错误提示信息
• ✅ 日志记录：详细的日志记录便于调试

更新日志

详细的更新日志请查看项目根目录下的 CHANGELOG.md 文件

使用建议

1. 文件夹选择: 文件->打开文件夹,选择MirServer文件夹作为工作区目录,选择其他文件夹部分插件功能将无法使用
2. 首次使用: 插件激活后会自动执行一些数据加载，建议等待完成后再开始编辑
3. 性能优化: 如果项目文件较多，可以关闭部分提示功能以提升性能
4. 备份功能: 建议保持备份功能开启，重要文件修改前会自动备份
5. 自定义命令: 可以将常用命令模板保存为自定义命令，提升开发效率
6. 地图开发: 使用地图关系图功能可以更好地理解地图之间的连接关系
7. 刷怪调试: 使用刷怪可视化功能可以直观地查看怪物分布情况
8. 爆率分析: 使用地图爆率查看功能可以快速了解地图的掉落情况，支持搜索和筛选

注意事项

1. 编码格式: 插件默认使用 GB2312 编码，确保文件编码正确
2. 文件路径: 某些功能需要正确的文件路径结构（如 Mir200/Envir/）
3. M2 集成: M2 相关功能需要 M2 服务器正在运行
4. 重启生效: 部分配置修改需要重启 VSCode 才能生效
5. 版本要求: 最低 VSCode 版本为 1.60.2

Enjoy! 🎉