爱学传奇编辑器

作者与交流群

作　者：左心（QQ：2207715595）
交流群：563129785（QQ 群）

面向 LF、GOM、NGOM、GEE、996PC 的传奇脚本、地图与界面编辑工具。

核心功能

• 脚本编辑：语法高亮、智能补全、参数提示、定义跳转和代码大纲。
• NPC 可视化编辑：预览 NPC 对话框，添加、选择和移动界面控件，并直接修改脚本参数。
• 素材预览：读取客户端与补丁素材，预览图片、按钮、动画、物品等界面内容。
• 数据库工具：浏览和查询 SQLite、Access 物品数据库。
• 项目工具：提供变量查询、特殊符号、常用文件和 M2 菜单等功能。
• 远端编辑：连接远端模块，浏览和编辑传奇项目。

快速开始

1. 在 VS Code 中打开 MirServer（俗称版本）。
2. 打开传奇脚本，并选择 LF、GOM、NGOM、GEE 或 996PC 语言模式。
3. 点击编辑器标题栏中的“可视化 NPC 编辑”，打开当前脚本的界面预览。

扩展默认以 GB18030 打开传奇脚本；如果用户或工作区已经指定编码，则优先使用现有设置。

NPC 可视化编辑

可视化编辑器会分析当前标签和脚本内容，并预览 NPC 背景、文字、图片、按钮、动画和物品控件。

• 点击控件可查看完整脚本命令。
• 点击命令参数可直接输入新值。
• 素材参数可从素材库中选择，物品参数可从数据库中选择。
• 拖动控件可调整位置，确认后自动写回原脚本。

素材与数据库配置

打开活动栏中的“爱学编辑器设置”，可集中配置：

• 数据库
• 客户端目录
• 自定义补丁目录
• PAK 密码
• MMAP

客户端和自定义补丁素材从所选目录的 Data 子目录读取。同名资源存在时，自定义补丁优先。

PAK 图片预览支持 GEEPAK2、GEEPAK3、GAMEOFMIR2、GAMEOFMIR_LEGACY、JPK、WZX/WZL 和 WIX/WIL。解析工作在扩展自带的 TypeScript Worker 中完成，不需要安装 Python、Unicorn、VC 运行库或单独的 pak-engine.exe。素材映射文件默认读取 Mir200/Envir/EffectImageList.txt。

PAK 密码按 CP936 规则处理，支持中文和特殊符号。导入结果会按项目保存到 .aixue/PAK.TXT；查看已保存密码不会自动重新验证，需要时可在密码窗口手动触发验证。

PAK 解析开发

PAK 解析器位于 src/features/pakResources/engine/。PakEngineClient 通过 Node.js Worker Thread 调用 TsPakBackend，各格式由 FormatRegistry 独立注册。新增补丁格式时，应增加单独的格式适配器、固定测试样本和差异验证，不应在密码管理、素材解析或界面代码中增加格式分支。

旧 Python 引擎只保留为开发期差异验证基准，不会进入 VSIX。维护者可运行：

npm run check:pak-worker
npm run check:pak-differential
npm run check:pak-package

支持范围

• LF、GOM、NGOM、GEE、996PC 脚本
• GB18030 编码的传奇项目
• SQLite、Access 物品数据库
• 本地项目与远端项目

反馈

反馈问题时，请附上扩展版本、复现步骤，以及“输出”面板中的相关日志。

地图预览与刷怪

地图预览支持分块加载、可折叠地图列表、小地图、怪物与 NPC 显示、怪物放置、NPC 拖动新增，以及地图内 NPC 可视化编辑。地图预览顶部的“帮助”按钮提供当前操作说明。