一键拾取

《Escape from Duckov》一键拾取战利品 MOD 使用指南

【核心介绍】
为《Escape from Duckov》提供高效、可定制的战利品拾取功能，支持按品质、价值、单位重量价值（$/kg）智能筛选并一键收集，全程热切换，无需重启游戏（启用 ModConfig 时）。

【安装指南】

1. 下载本 MOD：
   • Steam 玩家：直接订阅「OneKeyLoot」创意工坊页面；
   • GitHub 用户：下载源码包「Duckov_OneKeyLoot」。
2. 解压后，将整个 `OneKeyLoot` 文件夹放入：
   游戏根目录 /Duckov_Data/mods（若无 `/mods` 文件夹，请手动创建）。
3. 确保以下文件存在：
   /Duckov_Data/mods/OneKeyLoot/OneKeyLoot.dll
   ✅ 缺一不可；本 MOD 无需前置依赖，所有运行所需组件均已内置。

【功能详情】
✅ 已优化：

• 显示「全部拾取」按钮（原版隐藏功能）；
• 新增三组「一键收集战利品」按钮组：
  • 按品质（≥ 阈值，品质范围 1–9）；
  • 按价值（≥ 阈值，单位：金币）；
  • 按价重比（≥ 阈值，单位：$/kg）；
• 支持中/英文本地化热切换（不需重启）；
• 支持动态配置热切换（启用 ModConfig 时）：
  • 显示/隐藏任意按钮或按钮组；
  • 自定义按钮数量（每组最多 4 个）；
  • 自定义按钮颜色（十六进制格式，如 `4CAF4F`）；
  • 自定义拾取作用范围。
  ✨ 额外调整：
• 内置可选配置工具「ModConfig」，提供图形化设置界面；
• 首次启用后自动在 `/StreamingAssets/` 下生成 `OneKeyLootConfig.txt` 配置文件（手动编辑时需关闭游戏）。
  ❌ 未修改：
• 原版物品掉落逻辑、背包容量、品质数值定义；
• 其他 UI 元素（仅锚定并复用原版“一键拾取”按钮位置）；
• ModConfig 的配置文本不支持中英文热切换（修改后需重启游戏生效）。

【使用要求】

• 游戏版本：《Escape from Duckov》正式版（v1.0+）；
• 运行环境：系统需预装 .NET Framework 4.8（未安装可能导致 MOD 无法加载）；
• 启用方式：进入游戏 → 打开「模组」菜单 → 勾选「OneKeyLoot」；
  • 若同时使用 ModConfig：须勾选 ModConfig 并将其加载顺序置于 OneKeyLoot 之上；
  • 必须重启一次游戏，确保 DLL 正确注入与配置初始化。

【兼容性说明】

• 兼容范围：
  • 所有基于原版品质/价值/重量数据的 MOD（本 MOD 读取游戏官方隐藏品质字段，不依赖自定义标签）；
  • 「自定义掉落颜色」类 MOD（无冲突）。
• 不兼容模组：
  • 修改原版「一键拾取」按钮逻辑或 UI 锚点的 MOD（如重写该按钮行为、移除/遮挡其底层控件）；
  • 强制覆盖 `.NET Framework` 运行时版本的 MOD。
• 兼容补丁：暂未推出。

【注意事项】

• 按钮逻辑均以「物品标记为爱心（收藏）」为前提，未收藏物品不会被拾取；
• “按价重比”计算使用商店售价 ÷ 物品重量，重量单位为 kg；
• 手动编辑 `OneKeyLootConfig.txt` 时，请严格使用半角逗号分隔数值（如 `2,3,4,5`），格式错误将自动回退至默认值；
• UI 适配当前游戏默认分辨率，极端缩放比例下可能出现轻微偏移（不影响功能）。

【更新日志】

• 2024 年 6 月 15 日 新增 ModConfig 图形化配置支持，实现热切换；
• 2024 年 6 月 10 日 开放完整动态配置项（按钮数量、颜色、范围、显隐控制）；
• 2024 年 6 月 5 日 首发版本，支持中英文热切换及三类智能拾取逻辑。