JX3Toy 剑网3 Lua 宏指南：从找到脚本到调出自己的配置

【免费下载链接】JX3Toy全功能减负工具项目地址: https://gitcode.com/GitHub_Trending/jx/JX3Toy

JX3Toy 是一个剑网3的开源 Lua 宏集合与减负工具，按门派和专精组织了大量 PVE 副本宏，配套提供副本数据记录模块、宏加密和简繁转换等工具，帮你把重复的技能循环交给脚本执行。

它替你省掉了哪些操作

剑网3的 PVE 循环有几个老生常谈的负担：

• 读条时机：技能之间要卡在 GCD 的缝隙里，稍慢就丢循环；
• 状态判断：距离够不够、面朝对不对、目标身上层数到没到、自己 buff 还剩几秒，全要边打边看；
• 版本适配：不同大版本（万灵当歌、日月明尊、群侠万变、怀旧）技能数值和机制不同，循环要跟着换；
• 输出与生存兼顾：减伤技能该在什么血量按，平时根本顾不上。

JX3Toy 的思路不是外挂，而是利用剑网3自带的 Lua 宏机制：每个脚本就是一个.lua文件，游戏内每帧调用一次Main()，脚本里用cast()、buff()、scdtime()等 API 读取当前状态，满足条件才释放技能。你在脚本注释里能看到完整决策过程，例如 宏/七秀/冰心_PVE_万灵当歌.lua 中"目标凝华大于6层再放剑气长江"这类判断，逻辑完全透明。

另外两个日常向的现成例子：宏/通用/调试自己技能释放.lua 把自己的技能释放、读条事件逐帧打印到日志，方便排查循环卡在哪；宏/通用/帮会钓鱼.lua 则自动完成放杆、收杆、交鱼篓的循环，你只需要保证背包里有鱼饵。

目录结构：先认路

每个门派的脚本命名能直接读出"专精 + 版本"，比如冰心_PVE_万灵当歌.lua是七秀冰心在万灵当歌版本的 PVE 宏，带_TW后缀的是繁体字版本。挑脚本时先按自己门派的版本分支找，别拿怀旧版脚本去打现行版本。

最小上手路径

整条流程可以压缩成四步，最短命令只有一条。

1. 拿到仓库：

git clone https://gitcode.com/GitHub_Trending/jx/JX3Toy

2. 选脚本：进入JX3Toy/宏/下对应门派的目录，选与你版本匹配的文件，例如天策傲血玩家选 宏/天策/傲血_PVE_万灵当歌.lua。
3. 准备运行环境：Lua 宏需要游戏客户端支持 Lua 脚本的插件环境（JX3 系插件）。把.lua文件放入插件目录加载；如果你的宏用到了模块，参考 Lib/README.md——模块放到软件所在目录的Lib文件夹，具体用法看每个模块文件头部的注释。
4. 绑定键位并测试：在游戏里把宏绑到一个键位，进副本前先在小怪上试打，重点确认技能释放顺序和你的奇穴、秘籍一致。

脚本头部通常写明了适配的奇穴与秘籍，例如冰心宏标注了"[青梅嗅][千里冰封]…"和四条秘籍点法。如果你的奇穴配置不同，先看注释里是否提到备选（如"第十一重奇穴也可以尝试[琼宵]"），不匹配的地方脚本里的对应判断可能不生效。

读一个宏的结构，学会自己调

以冰心 PVE 宏为例，整个文件可以拆成四块，几乎所有输出宏都是这个骨架：

1. 全局设置与开关：setglobal("自动面向", false)关掉自动面向，addopt("副本防开怪", false)这类宏选项会出现在宏的配置界面，运行时可切换。"副本防开怪"开启后，副本内未进战斗时脚本直接停手，防止拉怪。
2. 状态快照：Main()开头把 CD、buff 层数、目标血量、目标是否静止等读进变量表v，后面的判断全部基于这些值，避免重复调用 API。
3. 按优先级排技能：从关键技能到常规填充依次判断，条件不满足就落到下一个技能；减伤单独前置（life() < 0.6时放减伤），打断、防开怪这类防御逻辑也在主循环里。
4. 事件回调：OnCast等回调用来清理计时器、打印日志。CastX()这类封装函数在释放成功后同时记录一条信息，把 CD 快照打到日志窗口，方便回看每次按键的时机。

调参时最常用的是改两类数字：血量阈值（减伤和保命技能的触发线）和距离/层数条件（技能的前置要求）。改完先在训练假人或小怪上验证，再用调试宏对照日志确认顺序。

三个实用工具的使用方式

宏加密：测试通过的宏不想泄露时，把.lua文件拖到 工具/宏加密/ 里的宏加密.bat，会在同目录生成加密后的同名.luas文件。详见 工具/宏加密/README.md。

简繁转换：脚本里大量中文字符串（技能名、buff 名）在简繁客户端下需要对应字库。按 工具/简繁转换/README.txt 的步骤：安装 Python 后执行pip install opencc，然后把文件拖到简转繁.bat或繁转简.bat，转换结果保存在原文件同目录（简体转繁体用 UTF-8，繁体转简体用 GB18030 保存）。

副本数据记录：Lib/副本数据记录.lua 负责记录战斗中 Boss 与 NPC 的技能释放，帮你复盘 Boss 循环。模块注释里给了接入方式：主宏里用

DungeonLog = DungeonLog or load("Lib/副本数据记录.lua")

防止重复加载，然后把OnCast、OnEnterMap等回调转发给模块（或直接把模块回调赋给主宏的同名函数）。打完副本后在日志窗口右键"另存为"，就能拿到一份用于分析 Boss 技能循环的记录。

按你的玩法选脚本

• PVE 输出：找带"专精名_PVE"的文件，优先与你当前版本同名的大版本脚本（万灵当歌/日月明尊/群侠万变/怀旧）。同一专精有多个版本变体时，说明作者针对版本差异分别维护了循环，不要混用。
• PVE 治疗：如 宏/七秀/PVE_奶秀.lua 里能看到完整的选目标逻辑——用party()在 20 码内找气血最少的队友，低于 50% 交大招、80% 才放读条大加、给坦克补减伤，条件阈值都写在明处，你可以按团队配置自行收紧或放宽。
• 繁体客户端：直接用同目录带_TW的文件，或自己用简繁转换工具处理。
• 日常挂机：宏/通用/ 下有帮会钓鱼这类脚本，属于纯交互类，不涉及战斗判断，风险最低，适合第一次试 Lua 宏。

常见问题

Q：脚本里奇穴、秘籍标注和我的配置不一样，还能用吗？先看头部注释有没有提到备选项。脚本对奇穴的判断用的是qixue("化冰")这类函数，点了对应奇穴才走那条分支，没点一般不会误放；但秘籍点法影响技能数值与机制（比如某条秘籍改变 CD 或消耗），不匹配时循环收益会打折，建议按注释点齐或另寻贴合你配置的版本。

Q：脚本在副本里不动作？大概率是"副本防开怪"选项开着而你还没进战斗，或未选中敌对目标。关闭该宏选项、确认定位正常后重试；仍无输出时挂上 调试自己技能释放.lua 看日志窗口的实际事件。

Q：简体客户端用_TW脚本会怎样？技能名与 buff 名都是字符串精确匹配，繁体字符串在简体客户端下匹配不到，表现为宏"失忆"。客户端与脚本字库保持一致即可，必要时用简繁转换工具处理。

Q：项目还在维护吗？遇到问题找谁？README 已注明本项目停止更新维护，脚本按现状使用，版本更新后请以仓库内对应新版本的脚本为准。社区入口在 README.md 中列出：Zulip 聊天室、邮件 jx3toy@proton.me、Keybase。

下一步

• 克隆仓库并进入 宏/ 目录，按"门派/专精_版本"找到你的脚本；
• 打开目标脚本通读一遍头部奇穴、秘籍注释，确认与自己配置一致；
• 需要记录 Boss 循环时按 Lib/副本数据记录.lua 头部注释接入模块；
• 使用中遇到脚本行为与预期不符，把现象整理清楚后到社区 Zulip 提问，或直接在仓库提 Issue 描述门派、版本与问题复现步骤。

【免费下载链接】JX3Toy全功能减负工具项目地址: https://gitcode.com/GitHub_Trending/jx/JX3Toy