新手必看！《巫师 3》Mod 安装指南：从入门到玩转 AutoLoot (MSF)
一、新手入门：Modding 基础指南
强烈建议：首次接触《巫师 3》Modding 的玩家，先阅读官方 Modding 指南《The Tome of Witcher 3 Modding》，获取全面的基础知识与操作规范：
点击查看指南
二、AutoLoot (MSF) 安装步骤（图文详解）
前置要求
必须先安装核心框架：Mod Settings Framework（MSF）（作者 SpontanCombust），可在 Mod 平台搜索下载并 “endorse” 支持作者。
安装流程
复制 Mod 文件
将下载包中的mods文件夹内的modAutoLootMSF文件夹，粘贴到游戏根目录的mods文件夹中。
路径示例：\The Witcher 3\mods\modAutoLootMSF
配置 XML 文件
将下载包中的bin文件夹内的AutoLootMSF.xml文件，粘贴到游戏根目录的bin\config\r4game\user_config_matrix\pc路径下。
路径示例：\The Witcher 3\bin\config\r4game\user_config_matrix\pc\AutoLootMSF.xml
关联 DX 配置文件
手动操作：
用文本编辑器打开dx11filelist.txt和dx12filelist.txt（路径同上），在末尾添加：AutoLootMSF.xml;
懒人方案：使用 Mod 工具Menu Filelist Updater（作者 Aeltoth），一键自动完成配置，永久避免手动编辑。
可选：快捷键设置
若需使用 Mod 内置快捷键（如开关自动模式），按以下步骤操作：
编辑游戏根目录的input.settings文件（需备份），根据add_to_input_settings.txt内容添加按键绑定。
若需自定义快捷键，编辑同路径下的input.xml文件，参考add_to_input_xml.txt说明修改。
冲突解决（关键步骤）
运行Script Merger（推荐使用 Phaz42 制作的 “Fresh and Automated Edition” 版本），扫描并合并脚本文件，解决 Mod 间冲突。
操作提示：安装后首次启动游戏前务必执行此步骤，避免崩溃。
启动游戏验证
进入游戏，通过 Mod 菜单（通常为ESC键→“Mods” 选项）确认 AutoLoot (MSF) 已激活。
三、卸载流程（彻底清除 Mod 痕迹）
删除 Mod 文件
删除\mods\modAutoLootMSF文件夹。
移除配置文件
删除\bin\config\r4game\user_config_matrix\pc\AutoLootMSF.xml文件。
清理 DX 配置
从dx11filelist.txt和dx12filelist.txt中删除AutoLootMSF.xml;条目。
还原快捷键设置
若曾修改input.settings或input.xml，请恢复为 Mod 安装前的原始内容。
再次运行 Script Merger
扫描并应用更改，确保无残留脚本影响游戏。
四、核心配置解析：手把手教你调参
通用设置（General Settings）
选项	说明
Enable Auto Loot Mod	全局开关，控制 Mod 启用 / 关闭。
Remove Junk From Actor Remains	开启后自动移除尸体中的 “垃圾”（普通品质武器 / 护甲、标记为垃圾的非任务物品）。
Allow Theft	允许偷窃容器（强烈建议关闭，避免触发 guards 攻击，影响沉浸感）。
Protect Relic Gear	开启后自动保护至少 “遗物” 品质的装备，避免误拾取（凸显稀有物品价值）。
Suppress Overencumbrance Effect	无视负重限制，仍可正常移动 / 传送（偶尔需丢弃并重新拾取物品刷新计算）。
过滤设置（Filter Settings）
核心逻辑：需同时满足类型、品质、价值条件（逻辑 “与” 关系）。
关键选项：
Enable Separate Loot Sources (SLS)：开启后可独立配置杂物 / 尸体 / 草药的拾取源。
<item type filter>：选择需拾取的物品类型（如武器、护甲、草药等）。
<item quality>：设置最低品质要求（如 “普通”“魔法”“稀有” 等）。
<item value>：设置最低价值门槛（仅拾取价值≥指定数值的物品）。
自动模式设置（Auto Mode Settings）
选项	说明
Enable Automatic Mode	自动模式开关（关闭时需手动激活容器，跳过拾取弹窗）。
Enable Line Of Sight	视线检测开关（建议开启，仅拾取可见范围内物品，减少任务冲突风险）。
Global Search Distance (GSD)	全局搜索距离（米），默认覆盖所有类型容器。
Enable Looting In Combat	开启后可在战斗中拾取（不推荐，可能影响战斗节奏）。
通知设置（Notification Settings）
自定义拾取提示样式，支持为杂物、尸体、草药分别设置文字颜色、显示位置等，建议根据个人偏好调整，保持界面简洁。
五、新手常见问题与解决方案
Q：安装后 Mod 未生效？
A：
确认已安装 MSF 框架，并位于mods目录；
检查dx11filelist.txt/dx12filelist.txt是否正确添加AutoLootMSF.xml;；
运行 Script Merger 解决脚本冲突。
Q：自动拾取无反应？
A：
确保 “Enable Automatic Mode” 已开启（可通过快捷键 KEY 1 切换）；
靠近目标并调整视角，确认视线无遮挡（关闭 KEY 3 可临时禁用视线检测测试）；
检查过滤条件是否过于严格（如品质 / 价值设置过高导致无符合条件物品）。
Q：游戏崩溃或卡顿？
A：
减少独立搜索距离（HSD/RSD）或降低扫描频率（Search Trigger Interval）；
关闭多余 Mod，通过 Script Merger 排查冲突脚本；
确保游戏安装路径不含中文或特殊符号。
六、进阶技巧：打造个性化拾取体验
极简配置：初次使用可在 Mod 菜单中点击 **<Default>** 一键恢复默认设置，熟悉基础功能后再逐步调整。
沉浸玩法：搭配 Mod《All Containers Glow without Witcher Senses》，无需法印即可高亮可拾取容器，与视线机制联动提升探索真实感。
性能优化：若配置复杂功能后出现卡顿，可关闭 “Separate Loot Sources” 并统一使用 GSD 全局距离，减少系统资源占用。
七、致谢与反馈
本 Mod 基于 SpontanCombust 开发的 MSF 框架，感谢所有开源作者的贡献！
若遇到 BUG 或有优化建议，欢迎通过 Mod 页面留言反馈（请附上详细操作步骤与配置截图）。
尊重开发者劳动，请勿擅自修改或转载 Mod 文件，如需分享请注明原作者与来源。
结语：掌握以上步骤，即使是 Mod 新手也能轻松驾驭 AutoLoot (MSF)，让《巫师 3》的搜刮体验从此告别繁琐！祝各位猎魔人旅途顺利，尽享无缝探索的乐趣！