JX3Toy 完整指南：剑网3 全门派 PVE 宏工具，从克隆仓库到跑通技能循环

JX3Toy 完整指南：剑网3 全门派 PVE 宏工具，从克隆仓库到跑通技能循环

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

在万灵当歌版本的团本里，你一只手要换目标、丢玳弦急曲、盯着剑气长江的冷却，另一只手还要留着扶摇；打完一个 25 人本，手指比角色还累。JX3Toy 是围绕剑网3 官方宏系统编写的减负脚本合集：把技能释放顺序写成 Lua 脚本，由宏逐帧执行，你只需要负责站位和应急保命。

一句话定义：JX3Toy 是一个"全功能减负工具"，为 19 个门派的 PVE 专精提供自动技能循环宏，并附带帮会钓鱼、副本数据记录等日常减负脚本，以及宏加密、简繁转换两类配套工具。目标用户是想从重复操作中解放双手的 PVE 玩家，以及想在此基础上做个性化调试的宏用户。

🗺️ 项目全景：宏库、数据表与工具链

这个项目解决的核心问题是：PVE 中的技能循环依赖手动操作，资源管理和目标切换容易顾此失彼。它的能力分为四块：

模块	职责	一句话说明
宏/	门派宏脚本库	按 19 个门派分目录，覆盖输出与治疗专精的技能循环，另有通用减负脚本
Data/	技能数据配置	skill.lua 维护技能 ID 与技能名的映射，以及需要记录释放时间的重要技能表
Lib/	模块和库	副本数据记录.lua 由主宏加载，记录 Boss 与 NPC 的事件供战后分析
工具/	配套工具	宏加密把测试好的宏编译加密为 .luas；简繁转换基于 OpenCC 做简繁互转

和常见的宏合集相比，JX3Toy 的脚本按"门派 + 专精 + 游戏内版本"命名（万灵当歌、群侠万变、怀旧、日月明尊），繁体版本带 _TW 后缀，不容易拿错脚本。需要注意，仓库 README 已说明项目停止更新维护，配合新版本客户端使用时要留意兼容性。

🚀 快速上手：克隆仓库并配置门派宏

前置条件：游戏客户端与文件编码

• 支持宏系统加载 Lua 宏的剑网3 客户端
• 仓库宏文件使用 GB18030/GBK 编码（繁体版为 UTF-8），复制时不要用编辑器重新转码
• 简繁转换工具另需安装 Python 和 opencc 包

git 拉取仓库与目录结构

git clone https://gitcode.com/GitHub_Trending/jx/JX3Toy
cd JX3Toy
ls 宏

宏/ 目录下每个门派一个子目录：七秀、万花、天策、少林、纯阳、唐门、五毒、明教、丐帮、苍云、长歌、霸刀、蓬莱、凌雪、衍天、药宗、刀宗、万灵、藏剑，外加一个通用目录，里面放着帮会钓鱼.lua、调试自己技能释放.lua 这类跨门派脚本。

选择门派宏并完成首次运行验证

以七秀冰心为例，对应脚本是 宏/七秀/冰心_PVE_万灵当歌.lua。把脚本复制到游戏宏目录，在游戏内创建宏并绑定快捷键，然后在安全区域测试：对训练目标观察宏是否按顺序接上名动四方、玳弦急曲，血量低于阈值时是否自动套上天地低昂。宏的主结构是每帧被调用的 Main 函数：

function Main(g_player)
	if fight() and life() < 0.6 then
		cast("天地低昂")
	end
	-- 随后根据冷却与奇穴状态依次调度各技能
end

⚙️ 核心功能详解

自动技能循环：Main 主循环与技能调度

场景：冰心在团本里要同时盯着钗燕层数、目标的急曲层数和剑影留痕的释放时间，出手顺序还随奇穴变化。操作：宏的 Main 循环先采集状态（冷却、buff 层数、目标血量、距离），再按优先级调用各技能子函数。冰心脚本里，广陵月绑定在玳弦急曲之前释放，目标凝华超过 6 层时优先剑气长江，有流玉 buff 时先接玳弦。结果：玩家不用背顺序，只关注走位；每个技能的释放时间快照也会同步打到日志窗口，方便回看循环。

选项开关：addopt 与 setglobal 控制行为

场景：多本连跑时不想让宏在非战斗状态误放技能开怪；某些打法又希望保留手动打断的时机。操作：宏用 addopt 定义选项、setglobal 定义全局参数。例如 addopt("副本防开怪", false) 开启后，副本内未进入战斗时 Main 循环直接返回；开启打断选项后，目标出现可打断读条时自动释放打断技能。结果：一套宏通过开关切换行为，不必为不同场景维护两份脚本。

副本数据记录：为 Boss 循环分析提供日志

场景：写新 Boss 的宏之前，需要先摸清它的技能顺序和间隔。操作：在主宏中加载 Lib/副本数据记录.lua 模块，它接管 OnCast、OnPrepare、OnBuff 等事件，把 Boss 的技能释放、增益变化和 NPC 出现按时间写入日志窗口。结果：打完副本把日志另存为文件，即可还原 Boss 的技能循环，作为编写或核对循环脚本的依据。

🔧 进阶配置与参数调整

参数	默认值	说明	影响范围
自动面向	false	setglobal 定义，宏是否自动面向目标	全门派
副本防开怪	false	addopt 定义，副本内未战斗时不释放技能	团队副本
打断	false	addopt 定义，目标可打断时自动打断	PVE 战斗
记录信息	true	技能释放后是否输出冷却快照	日志调试

配置组合示例：习惯手动控制打断时机的玩家，保持打断关闭、只开副本防开怪，适合多本连跑；需要核对循环细节的调试阶段，保持记录信息开启，日志里每个技能后都能查到流玉时间、剑气CD 等状态值。繁体服玩家选择 _TW 版脚本，或用 工具/简繁转换 把简体版转过去：

pip install opencc
python 工具/简繁转换/s2tw.py 宏/七秀/冰心_PVE_万灵当歌.lua

❓ 常见问题与避坑

Q: 宏复制进游戏后显示乱码或无法加载，为什么？ A: 宏文件使用 GB18030/GBK 编码（繁体版为 UTF-8）。用默认 UTF-8 打开再保存会破坏编码，游戏宏系统就无法解析。复制前确认编码不变，直接复制原文件最稳妥。

Q: 项目已停止更新，脚本会随新版本失效吗？ A: README 明确说明项目已停止更新维护。游戏版本迭代（万灵当歌、群侠万变等玩法调整）后，技能名或奇穴若有变动，对应宏可能失效。选脚本时对照文件名里的版本标注与你游戏内的版本是否一致。

Q: 使用自动循环宏会有封号风险吗？ A: 宏通过官方宏系统接口释放技能，但自动循环属于灰色行为，官方态度可能随版本变化，风险需要自行评估，建议关键节点保留手动干预。

Q: 配置较低的电脑运行宏卡顿，瓶颈在哪？ A: Main 每帧调用，开启记录信息后每次技能释放都会打一行日志，多目标战斗中输出量不小。可以关闭记录类开关降低日志压力，同时避免同时挂多个宏。

Q: 同一门派的怀旧、日月明尊等版本宏如何区分？ A: 游戏内心法存在多个版本分支，脚本文件名标注了对应版本，例如 PVE_冰心_日月明尊.lua 对应日月明尊版。按自己实际的版本选用，不要混用不同版本的循环脚本。

JX3Toy 把"背顺序、卡时机"的 PVE 负担变成一套可执行、可开关的脚本，它的价值在于接管那些不需要你留意的操作，而不是替代你的判断。下一步：克隆仓库，按门派找到对应宏，在安全区域绑定快捷键跑通一遍循环，再带去副本。有脚本问题或建议，可通过项目 README 中列出的官方社区渠道反馈。

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