牧场下落路由器

描述

描述你的模组的主要目的

安装说明

列出用户安装你的模组必须遵循的任何步骤

主要功能

描述你的模组的核心功能

需求

提供关于额外所需步骤、资源或模组的信息

致谢

感谢任何启发或帮助过你的人。Ranch Drio Router 《幻兽帕鲁》的牧场自动存储系统 内部模组/文件夹名称： AutoRanchLogistics

Ranch Drio Router 会自动将你的牧场周围产出的物品移动到位于同一个帕鲁终端基地内的实体存储中。 我最初制作这个模组，是因为我的大型牧场设置需要我专门投入大约 5–8 只搬运帕鲁，才能将牧场产出捡起并移动到箱子、饲料箱、冰箱等容器中。 这个模组无需将那么多帕鲁槽位纯粹用于搬运牧场产品，而是自动处理牧场物品的存储过程。 它专为牧场物流设计。它不是一个通用的自动拾取模组，也不会使用玩家的背包作为中转站。

---

功能说明

当符合条件的牧场产出物品出现在牧场附近的地面上时，Ranch Drio Router 会短暂等待，然后尝试将该物品直接移动到属于同一基地的合适实体存储容器中。

食物类物品 已识别的牧场食物产品按以下优先级进行路由： 饲料箱 → 冷藏存储 → 普通箱子 如果某个目的地已满或不可用，路由器可以继续转到下一个合适的存储目的地。

非食物类牧场物品 非食物类牧场产品被路由到： 最近且兼容的普通存储箱

该模组不会故意将牧场物品发送到另一个帕鲁终端基地，也不会使用全局/共享存储作为捷径。

---

制作原因

主要原因很简单： 我不想投入 5–8 只搬运帕鲁来不断在基地周围搬运牧场产品。 当多个牧场帕鲁同时生产物品时，我的基地很大一部分劳动力都浪费在简单地将蛋、牛奶、蜂蜜、材料和其他牧场产出从地面搬运到存储上。 Ranch Drio Router 让这些帕鲁槽位可以用于其他工作，同时仍能让牧场保持整洁。 在高产牧场周围减少松散物品实体的数量，也可能有助于减少物品杂乱，并可能在大型基地中提升性能，尽管此模组不应被视为保证解决崩溃或性能问题的修复程序。

---

主要特色

• 自动运输牧场掉落物
• 牧场物品直接进入实体存储
• 不会通过玩家背包路由物品
• 仅在同一帕鲁终端基地内路由
• 食物存储优先级
• 支持饲料箱
• 支持冷藏存储
• 支持普通箱子/存储
• 在每个存储类别中选择最近的存储
• 每次扫描最多处理 50 个符合条件的牧场掉落物
• 单个掉落物独立延迟，以便在同一次扫描中处理多个掉落物
• 设计用于兼容扩展存储设置
• 实际路由的牧场掉落物无需搬运帕鲁
• 无全局或跨基地存储路由
• 与 AutoLootNearbyItems 使用独立的内部模组 ID 和文件夹

---

需求

必需 《幻兽帕鲁》— PC UE4SS UE4SS 必须已安装并能与《幻兽帕鲁》正常工作。 这是一个 UE4SS Lua 模组。它不是 pak 模组，不会放入 Pal\Content\Paks 中。

非必需 AutoLootNearbyItems 非必需。 Ranch Drio Router 现在是一个独立的衍生模组，拥有自己的：

• 模组文件夹
• 内部模组 ID
• 配置文件
• 日志
• 运行时保护
• 默认按键配置

---

安装方法

下载并解压压缩包。 在 ZIP 中你应该会看到： AutoRanchLogistics 将整个文件夹放入你的 UE4SS Mods 目录中。 对于标准的 Steam 安装，通常位于： C:\Program Files (x86)\Steam\steamapps\common\Palworld\Pal\Binaries\Win64\ue4ss\Mods\ 安装后，重要路径应如下所示： Palworld\Pal\Binaries\Win64\ue4ss\Mods\AutoRanchLogistics\Scripts\main.lua 完整的结构应大致为： ue4ss → Mods → AutoRanchLogistics → Scripts → main.lua AutoRanchLogistics 文件夹还包含：

• config.txt
• enabled.txt
• info.json
• COMPATIBILITY.txt

不要将 ZIP 文件本身放入 Paks 文件夹。 如果你的 Steam 库安装在其他位置，请在 Steam 中右键点击**《幻兽帕鲁》**，然后使用： 管理 → 浏览本地文件 接着导航到： Pal\Binaries\Win64\ue4ss\Mods

---

默认行为

默认情况下，Ranch Drio Router：

• 每 5 秒扫描一次
• 新检测到的牧场掉落物在大约 5 秒后才符合搬运条件
• 每次扫描最多处理 50 个符合条件的掉落物
• 在牧场约 30 米范围内寻找牧场掉落物
• 仅路由与帕鲁终端基地相关联的掉落物
• 在本地玩家约 100 米范围内搜索活动掉落物
• 仅将物品路由到与该基地关联的实体存储中

这意味着该模组旨在自动化你实际在操作的牧场/基地区域。 它并非用于实现全局跨地图存储自动化。

---

配置

配置文件位于： AutoRanchLogistics\config.txt

启用 / 禁用 Enabled = 1 1 = 启用 0 = 禁用

扫描间隔 ScanIntervalMs = 5000 默认值：5000 毫秒 / 5 秒 建议出于稳定性考虑，将其保持在 3000 毫秒或以上。

牧场半径 RanchRadiusCm = 3000 《幻兽帕鲁》/虚幻引擎的测量单位是厘米。 3000 cm = 30 米 地面掉落物必须在此水平距离内的牧场旁，路由器才会将其视为牧场掉落物。

每次扫描最大转移数 RanchTransferMaxDropsPerScan = 50 一次扫描最多可处理 50 个符合条件的牧场掉落物对象。

单个掉落物延迟 RanchTransferPerDropDelayMs = 5000 每个新检测到的掉落物必须存在大约 5 秒，才符合搬运条件。 这可以防止路由器立即处理一个刚出现的掉落物，同时仍允许在同一次扫描中移动多个不同的牧场掉落物。

---

基地半径设置

当前配置包含： BaseCampRadiusMultiplier = 2.0 重要提示： v0.5.8 最初是在自定义 200% 帕鲁终端/基地半径设置下测试的。 如果你使用标准的原版帕鲁终端半径，请将其改为： BaseCampRadiusMultiplier = 1.0 如果你使用将基地半径加倍的模组，那么 2.0 可能是合适的。 此设置会影响路由器的几何基地边界检测。

---

存储模组兼容性

我个人运行着一个高度模组化的《幻兽帕鲁》设置，约有 50 个模组，包括增加可用存储槽位数的模组。 Ranch Drio Router 已在该环境中测试过，到目前为止路由器本身并未导致我遇到崩溃。 该路由器包含一个可配置的存储槽位合理性限制： RanchTransferSlotSanityMax = 2048 这旨在允许与大幅扩展的存储容器兼容，同时防止路由器盲目处理明显无效的槽位数组。 这并不意味着保证与每个存储模组都兼容。 如果另一个模组完全替换或大幅更改了《幻兽帕鲁》底层的存储/容器系统，兼容性可能会有所不同。

---

与 AutoLootNearbyItems 一起使用

Ranch Drio Router 基于最初来自以下模组的代码： AutoLootNearbyItems by YellowChick / Le Dresseur Nomade https://www.nexusmods.com/palworld/mods/3430 这两个模组现在使用独立的文件夹、ID、配置文件、日志和默认热键，因此不应存在直接的安装/文件冲突。 但是，有一个重要的行为注意事项。 如果 AutoLootNearbyItems 被配置为自动拾取你基地内的地面物品，则两个模组可能都会注意到同一个牧场掉落物。 为了获得最干净的并行设置，我建议在以下文件中进行设置： AutoLootNearbyItems\config.txt 为： SkipInsideBaseCamp = 1 这创建了清晰的分离： AutoLootNearbyItems： 处理你基地外的自动拾取。 Ranch Drio Router： 处理你基地内的牧场产品。

---

玩家背包

Ranch Drio Router 不会使用玩家的背包作为中间存储位置。 预期的转移是： 牧场地面掉落物 → 同一基地的实体存储 而不是： 牧场地面掉落物 → 玩家背包 → 存储 路由器首先将物品写入选定的目标存储，并在减少原始地面堆叠之前验证目标已收到该物品。 如果无法验证目标写入，则源物品将被保留，而不是被故意删除。

---

空地面掉落物清理

物品成功转移后，模组可以移除现在为空的拾取物对象。 相关配置选项是： RanchFinalizeEmptyDropWithPickup = 1 在执行此清理之前，路由器会验证原始地面掉落物容器中的每个可读槽位均为空。 清理调用仅用于移除空的 actor。 它不用于通过玩家的背包运输牧场物品。 如果你在排查涉及地面物品清理或超大模组物品堆叠的异常崩溃，可以使用以下设置进行测试： RanchFinalizeEmptyDropWithPickup = 0 牧场路由本身与这个可选的最终清理步骤是分开的。

---

性能

我想要这个系统的另一个次要原因，是大型牧场设置周围会积累大量松散的掉落物。 自动将牧场产品移入存储，意味着地面上等待搬运帕鲁的松散牧场物品实体可以减少。 根据你的基地和模组设置，这可能会减少牧场区域的杂乱并缓解一些相关的卡顿。 我不声称这个模组是万能的性能或崩溃修复程序。

---

当前版本

Ranch Drio Router v0.5.8 内部文件夹 / 模组 ID： AutoRanchLogistics 内部名称有意以 A 开头，以便该模组出现在 UE4SS Mods 文件夹/列表的顶部附近。

---

鸣谢与许可

Ranch Drio Router 最初是以下模组的深度修改衍生版： AutoLootNearbyItems v1.3.9 创建者： YellowChick / Le Dresseur Nomade 原始模组： https://www.nexusmods.com/palworld/mods/3430 非常感谢 YellowChick / Le Dresseur Nomade 提供原始的 AutoLootNearbyItems 代码库，并允许我将这个经过深度修改、专注于牧场的版本作为独立模组发布。 Ranch Drio Router 有意与 AutoLootNearbyItems 的主要目的保持分离。 AutoLootNearbyItems 专注于自动玩家拾取。 Ranch Drio Router 则专门专注于： 牧场生产 → 同一基地的实体存储 根据要求，原始作者的署名也直接保留在源代码中。

---

错误报告

如果你遇到问题，请尽可能包含以下信息：

• 《幻兽帕鲁》版本
• UE4SS 版本
• Ranch Drio Router 版本
• 单人游戏 / 多人游戏 / 专用服务器
• 相关的存储模组
• 堆叠大小模组
• 基地半径模组
• 正在生产什么物品
• 有哪些可用的存储容器
• 问题是否反复出现

如果发生崩溃，说明是否使用了异常大的物品堆叠也会很有帮助。 这个模组仍处于早期发布阶段，因此来自不同基地布局和模组组合的报告都很有用。