自动拾取

主角自动拾取 / PlayerAutoPickup v1.0.0

================ 中文介绍 ================

为《明末：渊虚之羽》主角增加独立自动拾取功能，无需召唤宠物或按键。

默认效果

• 以主角脚下为中心，水平半径 20 米。
• 物品与主角脚下的绝对高度差不超过 3 米，可向上或向下拾取。
• 每 2 秒检查一次，每次最多发起一处原生拾取，该处物品由游戏正常入包。
• 探索和正常战斗均可用；暂停、菜单、过场、死亡和重生初始化期间暂停。
• 与宠物一样按距离拾取，不检查墙体遮挡。

保留游戏规则

沿用宠物的普通掉落物类型和原生拾取流程，保留背包/仓库容量检查、获得提示和存档标记。 不修改物品数量，不强行入包；满背包/仓库时保留掉落物并延后重试。 不自动开启宝箱、操作机关、触发对话，不拾取陷阱/特殊脚本对象或未打碎容器里的物品。

安装

1. 先准备兼容 UE4SS，并完全退出游戏。
2. 将包内 Project_Plague 文件夹合并到游戏根目录。
3. 确认 Project_Plague/Binaries/Win64/ue4ss/Mods/PlayerAutoPickup/ 内有 enabled.txt、config.lua 和 Scripts。
4. 完整重启，进入存档后自动启用。无需重复修改 mods.txt。

本包不含公共前置。仅依赖 UE4SS，不需要宠物、坐骑、法术、视野或 AutoRecovery MOD。

配置与性能

config.lua 可调整开关、半径、高度与检查间隔；单位为厘米和秒，编辑前退出游戏。 使用一个固定游戏线程回调，首次建立普通掉落物缓存，之后通过拾取物专用蓝图事件补充，并分批维护。 不在正常运行中每两秒遍历全场景，也不扫描敌人。初始登记仍可能产生一定开销，未进行实机帧率测量。 设计为可与宠物同装，通过原生可拾取状态检查避免重复请求；不修改宠物脚本。

停用和排查

退出游戏后将 config.lua 中 Enabled 改为 false，或将 enabled.txt 改名为 enabled.off。 如手动在 mods.txt 另有启用条目，也需关闭该条目。卸载只移走 PlayerAutoPickup 文件夹。 日志前缀：[PlayerAutoPickup]。首次进入世界或加载新区域时，可能需要几个检查周期。

验证与说明

压缩包附独立中英文 TXT 说明。已通过 Lua 5.4 语法及 11 组离线场景检查。 实机拾取、宠物同装和性能表现尚待验证。兼容 UE4SS 需提供固定游戏线程循环、蓝图 Hook 和地图事件接口。 感谢 UE4SS 项目及游戏原生拾取实现。本 MOD 为非官方作品。

================ English description ================

Standalone automatic loot collection for the player in WUCHANG: Fallen Feathers. No pet summon or hotkey is needed.

Defaults

• 20-metre horizontal radius centred on the player's feet.
• Maximum absolute vertical difference of 3 metres, above or below the player's feet.
• One native pickup interaction every 2 seconds; the game processes that drop's contents.
• Active in exploration and normal combat. Pauses in menus, cinematics, death and respawn initialization.
• Like pet collection, range checking does not test walls or other occluders.

Native rules

Uses the pet collector's ordinary drop types and the game's native pickup workflow, including inventory/warehouse capacity, notifications and pickup save marks. Full-capacity drops remain on the ground for later retries. No direct inventory or item-quantity changes. Does not open chests, operate mechanisms, trigger dialogue, collect trap/scripted subclasses or take items from intact destructible containers.

Installation

1. Install compatible UE4SS and fully close the game.
2. Merge the archive's Project_Plague folder into the game root.
3. Check Project_Plague/Binaries/Win64/ue4ss/Mods/PlayerAutoPickup/ contains enabled.txt, config.lua and Scripts.
4. Fully restart and load a save. The mod activates automatically. Do not duplicate its entry in mods.txt.

UE4SS binaries are not bundled. No pet, mount, spell, camera or AutoRecovery mod is required.

Configuration and performance

Edit config.lua while the game is closed to change enable flags, radius, height and interval. Units are centimetres and seconds. Uses one retained game-thread callback, initial pickup-class enumeration, pickup-specific Blueprint events and bounded cache maintenance. No recurring world enumeration or enemy scan during normal operation. Initial enumeration still has a cost; live frame-rate impact has not been measured. Designed to coexist with pet collection via native interactability checks, without editing pet scripts.

Disabling and troubleshooting

Close the game and set Enabled=false, rename enabled.txt to enabled.off, or move only the PlayerAutoPickup folder. Also disable any manually added mods.txt entry. Look for [PlayerAutoPickup] in ue4ss/UE4SS.log. Initial registration or newly loaded areas may take several checking cycles.

Validation and credits

Includes separate Chinese and English TXT manuals. Lua 5.4 syntax and 11 offline scenario checks passed. Live pickup, pet coexistence and performance still need in-game verification. UE4SS must provide the retained game-thread scheduler, Blueprint hooks and map events. Thanks to UE4SS and the game's native pickup implementation. This is an unofficial mod.