装备拆解 - 动态材料回收

从不要的装备中回收制作材料
RuneScape: Dragonwilds – Steam/Win64
描述
装备回收可让你拆解不需要的武器、护甲、工具和盾牌，并回收部分制作它们所用的材料。
该模组直接从游戏中动态读取制作配方。你无需手动维护配方列表。只要未来更新中添加的装备使用标准的Dragonwilds装备配方系统，它们也可能自动生效。
默认情况下，拆解会返还50%的原始制作材料，向下取整。
如果配方只需要一个单位的材料，该模组会返还最少一个单位。此行为可在配置文件中更改。
功能

• 回收武器、护甲、工具和盾牌
• 使用游戏原生RecipeData资源进行动态配方检测
• 默认返还50%的原始制作材料
• 可配置的恢复百分比
• 游戏内预览，显示您将获得的材料
• 安全两步确认系统
• 每次操作移除恰好一件物品
• 仅在确认物品移除后才会发放材料
• 若材料交付失败，尝试恢复原物品
• 可配置热键
• 可配置物品排除列表
• 使用普通的龙野库存功能
• 不直接修改角色或世界存档文件
• 不包含EXE、CMD或BAT文件
  

如何使用

• 打开你的物品栏。
• 将鼠标移到你想分解的装备物品上。
• 按一次 F8。
• 物品提示框将显示你将获得的材料和数量。
• 保持选中同一物品。
• 在5秒内再次按F8以确认。
  

第一次按 F8 只是预览，不会移除或修改物品。
物品仅在第二次按下F8后才会被拆解。
默认打捞规则
默认恢复率为50%。
材料数量向下取整。
示例：
配方消耗：10根原木
已归还：5根原木
配方消耗：7根动物骨头
已归还：3根动物骨头
配方消耗：1个特殊材料
已返还：1个特殊材料
默认情况下，仅需一种材料的配方允许返还一种材料。可在配置文件中禁用此功能。
支持物品
该模组主要适用于：

• 武器
• 护甲
• 工具
• 护盾
• 其他具有有效标准制作配方的装备
  

该模组有意不回收：

• 原始资源
• 普通制作材料
• 食物
• 种子
• 任务物品
• 玩家绑定物品
• 通常无法被摧毁的物品
• 无有效装备制作配方的物品
  

这些限制可防止不相关的物品被转换为自身或用于材料复制。
要求

• RuneScape：龙荒之境 – Steam/Win64
• 可用的 UE4SS 安装
  

安装装备拆解模组前，必须确保UE4SS已正确安装并正常加载。
安装

• 完全关闭游戏。
• 下载并解压压缩包。
• 将 EquipmentSalvage 文件夹复制到：
  

Steam\steamapps\common\RSDragonwilds\RSDragonwilds\Binaries\Win64\ue4ss\Mods
最终的文件夹结构应为：
ue4ss\Mods\EquipmentSalvage\enabled.txt
ue4ss\Mods\EquipmentSalvage\Scripts\main.lua
ue4ss\Mods\EquipmentSalvage\Scripts\config.lua

• 正常开始游戏。
  

更新中

• 关闭游戏。
• 提取新档案。
• 将新的 EquipmentSalvage 文件夹复制并覆盖到现有版本上。
• 出现提示时替换旧文件。
  

配置文件可能会在更新时被替换。如果你更改过任何设置，请先备份。
配置
配置文件位于此处：
EquipmentSalvage\Scripts\config.lua
可用设置：
DryRun = false
启用仅预览模式。不会移除任何物品，也不会给予任何材料。
恢复速率 = 0.50
控制返还的制作材料百分比。
示例：
0.25 返回 25%
0.50 返还 50%
0.75 等于 75%
1.00 返回 100%
热键 = F8
更改打捞快捷键。
单种食材至少一个 = true
当原始配方仅需一个单位特定材料时，返还一个单位。
需要二次按下 = 是
启用确认系统。强烈建议保持启用状态。
确认秒数 = 5
控制再次按下热键并确认回收所需的时间长短。
PreviewDurationSeconds = 6
控制材质预览保持可见的时长。
HoverTimeoutSeconds = 15
控制模组记住上次所选物品栏槽位的时长。
排除物品
允许禁止回收特定物品。你可以使用物品的PersistencelD、内部名称或其资产路径的唯一片段。
安全与防复制保护
装备拆解在给予材料前会进行几项检查：

• 所选物品栏物品必须仍然存在
• 必须通过游戏原生的物品栏功能找到确切的物品栏槽位
• 槽位中必须仍是同一物品
• 必须移除恰好一件物品
• 移除前后均会检查槽位数量
• 移除前后都会检查该物品的总数量
• 仅在确认成功移除后才会发放材料
• 如果无法验证移除，则不会发放材料
• 如果材料交付失败，模组会尝试恢复原始物品
  

该模组不会直接编辑存档文件。
动态配方检测
装备拆解功能会读取游戏已加载的配方数据资源，并将所选物品与其制作配方进行匹配。
该模组会搜索标准装备配方的存放位置，并在需要时自动加载匹配的配方资源。
对于未提供兼容标准配方的特殊物品，还可使用可配置的备用配方表。
大多数支持的装备不需要手动编写拆解配方。
本地化
该模组直接从游戏中读取物品和材料名称。
因此，显示的物品名称会跟随当前激活的游戏语言，包括社区翻译模组。
技术打捞消息当前以英文显示。
卸载

• 完全关闭游戏。
• 删除以下文件夹：
  

RSDragonwilds\RSDragonwilds\Binaries\Win64\ue4ss\Mods\EquipmentSalvage
无需恢复存档，因为该模组不会直接修改存档文件。
卸载前已分解的物品无法自动恢复。
兼容性
该模组应与大多数视觉、本地化、平衡和内容模组兼容。
可能与以下模组发生冲突：

• 替换库存系统
• 替换标准装备RecipeData资源
• 更改UE4SS库存函数
• 使用相同的热键
• 替换物品栏提示控件
  

快捷键可在 config.lua 中更改。
故障排除
按下 F8 后没有任何反应
请确保UE4SS已正确安装，并确认该文件存在：
ue4ss\Mods\EquipmentSalvage\enabled.txt
打开背包，将鼠标移到一件装备上，在其提示框显示时按F8。
模组报告未找到任何配方
该物品可能不使用标准装备配方，或有意不受支持。
原材料、食物、种子和任务物品无法分解。
预览已出现，但物品未被分解
在保持选中同一物品的情况下，再次按 F8。
默认确认窗口为五秒。
错误的按键会激活模组
检查config.lua中的热键设置，并确保没有其他UE4SS模组使用相同的按键。

日志文件
诊断信息写入至：
RSDragonwilds\RSDragonwilds\Binaries\Win64\ue4ss\UE4SS.log
在日志中搜索：
装备回收
更新日志
版本 1.4

• 修复了剩余的库存查询错误
• 已移除不可靠的运行时ItemSlots迭代
• 新增原生GetItemFromSlot索引扫描功能
• 在移除前新增了精确物品校验
• 已确认在正常游戏过程中有效
  

版本 1.3

• 移除了无效的GetSlotForItem依赖
• 分离预览与库存修改
• 将第一次按下 F8 键改为纯预览模式
• 已添加槽位数量与物品总数验证
• 已添加自动物品恢复尝试
  

1.2版本

• 修复了由不兼容的UE4SS PrintString调用导致的崩溃问题
• 已将预览移入现有的背包提示框中
• 已停止创建额外的虚幻UI对象
  

版本 1.1

• 改进装备配方检测
• 为当前Dragonwilds装备配方路径添加了支持
• 已添加自动匹配配方加载
• 已添加工具提示预览和两步确认
  

已知限制

• 只有具备有效支持配方的装备才能被分解
• 未来的游戏更新可能需要兼容性更新
• 预览暂时使用现有的库存工具提示文本字段
• 多人游戏行为尚未经过广泛测试
• 主机应在共享世界中使用模组前先安装该模组
  

制作人员
为《RuneScape: Dragonwilds》创建，使用了UE4SS以及游戏原生的虚幻引擎物品栏和RecipeData系统。
感谢UE4SS开发者和社区提供模组框架。
RuneScape和RuneScape: Dragonwilds是Jagex Ltd.的商标。
权限
未经许可，请勿重新上传或分发完整的模组压缩包。
欢迎兼容补丁、翻译和配置预设。请链接到原始Nexus Mods页面，并将Equipment Salvage列为需求。