Mules-Supply-Mod-OPUS

Mules-Supply-Mod-OPUS

Capacity-based supply logistics for X4: Foundations

当前版本：v0.1.0-beta.3

这是我第一次制作模组。如果你有任何建议，欢迎分享。

感谢 GPT 6.1 SOL

注意：仅在 Version 8.00 Hotfix 4 (legacy) + SWI 0.91HF1 进行了测试，如果有任何版本兼容性问题欢迎反馈

---

描述

English

Mules-Supply-Mod-OPUS 是基于 Mules, Supply and Warehouses Extended 的供应优化衍生版。

本项目主要重做了 M4 采购骡子。同一基点空间站下属的 M4 不再完全独立搜索，而是共享调度信息。船队可以合并多种缺口、按照路径和实际价格选择货源，并将少量剩余订单分配给其他可用船只。

本模组的目标是在尽量保留原版骡子行为、贸易限制、黑名单、停靠条件和存档兼容性的基础上，提高玩家空间站的补给效率。

当前版本为公开测试版。

本版本重点测试 M4 采购、按货仓容量派单、多货源补给、空闲返航和船只失败诊断。大规模船队性能，以及所有参数、存档和其他模组组合仍需要继续测试。

中文

Mules-Supply-Mod-OPUS 是基于 Mules, Supply and Warehouses Extended 的供应优化衍生版。

本项目主要重做了M4采购骡子。同一基点空间站下属的M4不再完全独立搜索，而是共享调度信息。船队可以合并多种缺口、按照路径和实际价格选择货源，并将少量剩余订单分配给其他可用船只。

本模组的目标是在尽量保留原版骡子行为、贸易限制、黑名单、停靠条件和存档兼容性的基础上，提高玩家空间站的补给效率。

当前版本为公开测试版。

本版本重点测试M4采购、按货仓容量派单、多货源补给、空闲返航和船只失败诊断。大规模船队性能，以及所有参数、存档和其他模组组合仍需要继续测试。

---

安装说明

English

1. 从文件区或 GitHub Releases 下载 Mules-Supply-Mod-OPUS.zip。
2. 安装或更新前，完整退出 X4: Foundations。
3. 解压压缩包。
4. 将其中唯一的 mules_and_warehouses_extended 文件夹复制到游戏的 extensions 目录。

示例：

E:\SteamLibrary\steamapps\common\X4 Foundations\extensions\mules_and_warehouses_extended

解压后的模组文件夹内应直接包含：

• content.xml
• ext_01.cat
• ext_01.dat

不要出现额外嵌套：

extensions\Mules-Supply-Mod-OPUS\mules_and_warehouses_extended

更新时，请先将旧版本移出 extensions 文件夹。本项目为了兼容旧存档，沿用了原版骡子的扩展 ID。

不要同时启用原版骡子和本模组。

如果使用 Steam 创意工坊版本，请确认 Steam 不会覆盖本地安装版本。

中文

1. 从文件区或 GitHub Releases 下载 Mules-Supply-Mod-OPUS.zip。
2. 安装或更新前，完整退出 X4: Foundations。
3. 解压压缩包。
4. 将其中唯一的 mules_and_warehouses_extended 文件夹复制到游戏的 extensions 目录。

示例：

E:\SteamLibrary\steamapps\common\X4 Foundations\extensions\mules_and_warehouses_extended

解压后的模组文件夹内应直接包含：

• content.xml
• ext_01.cat
• ext_01.dat

不要出现额外嵌套：

extensions\Mules-Supply-Mod-OPUS\mules_and_warehouses_extended

更新时，请先将旧版本移出 extensions 文件夹。本项目为了兼容旧存档，沿用了原版骡子的扩展 ID。

不要同时启用原版骡子和本模组。

如果使用 Steam 创意工坊版本，请确认 Steam 不会覆盖本地安装版本。

---

主要功能

功能	说明
按实际货仓容量调度	船只按照实际货仓容量排序。容量较小的XL不会自动排在容量较大的L之前。
多笔采购	一艘船可以组合多笔兼容订单，但受到“最大交易次数”限制。
少量缺口处理	少量剩余缺货可以合并后交给小容量船只。当没有合适的小船时，可以解除最低装载率限制。
副货源搜索	当主货源无法提供足够数量时，可以在限定的主路径范围内搜索同一种商品的其他货源。
距离和价格评估	主货源优先比较合法星区跳数。同距离货源再比较实际采购价格，包括可取得的势力优惠。
优先从玩家进货	当玩家工厂的实际库存超过设定门槛时，可以优先从玩家工厂采购。关闭该选项不会完全禁止玩家工厂供货。
单船独立返航	每艘空闲M4都可以独立返回基点空间站附近或基点星区，不需要等待其他M4全部空闲。
基点迁移	修改基点空间站或基点星区后，船只会迁移到新的调度组和搜索范围。
船只专属诊断	贸易失败原因会写入对应船只的行为信息，不需要只依赖总日志寻找原因。
取消后重新派单	取消或失效的贸易可以释放需求，并在后续调度中交给其他空闲船只。
中英文支持	M4参数、警告、诊断信息和说明文档均提供中英文内容。

功能说明

功能	说明
按实际货仓容量调度	船只按照实际货仓容量排序。容量较小的XL不会自动排在容量较大的L之前。
多笔采购	一艘船可以组合多笔兼容订单，但受到“最大交易次数”限制。
少量缺口处理	少量剩余缺货可以合并后交给小容量船只。当没有合适的小船时，可以解除最低装载率限制。
副货源搜索	当主货源无法提供足够数量时，可以在限定的主路径范围内搜索同一种商品的其他货源。
距离和价格评估	主货源优先比较合法星区跳数。同距离货源再比较实际采购价格，包括可取得的势力优惠。
优先从玩家进货	当玩家工厂的实际库存超过设定门槛时，可以优先从玩家工厂采购。关闭该选项不会完全禁止玩家工厂供货。
单船独立返航	每艘空闲M4都可以独立返回基点空间站附近或基点星区，不需要等待其他M4全部空闲。
基点迁移	修改基点空间站或基点星区后，船只会迁移到新的调度组和搜索范围。
船只专属诊断	贸易失败原因会写入对应船只的行为信息，不需要只依赖总日志寻找原因。
取消后重新派单	取消或失效的贸易可以释放需求，并在后续调度中交给其他空闲船只。
中英文支持	M4参数、警告、诊断信息和说明文档均提供中英文内容。

---

与原版M4采购骡子的主要变化

原版行为	本模组行为	修改原因
每艘M4主要独立搜索和评估贸易。	同一基点下的M4共享一次船队调度、需求状态和货源信息。	减少重复搜索，并允许多艘船协作处理同一组缺口。
船只可能按照XL、L、M、S等级顺序处理，即使实际容量存在交叉。	所有符合条件的船按照实际货仓容量和型号分组排序。	避免小容量XL阻塞大容量L。
单个订单不足装载率时可能被拒绝。	船只可以组合副订单；尾单阶段必要时解除最低装载率限制。	避免少量缺口长期无人处理。
某种商品可能只搜索到一个实际货源。	在设定的主路径范围和距离限制内继续搜索同商品的其他工厂。	避免单个工厂产量不足导致整笔缺口失败。
玩家和NPC货源沿用原有优先级。	库存超过门槛的玩家工厂可以优先供货；关闭优先后，合格玩家工厂仍可以正常参与竞争。	支持专门的玩家后勤工厂，同时避免低库存的商业工厂被强制纳入供货。
空闲返航依赖更大范围的船队状态。	每艘空闲船独立返回设置的空间站或星区。	避免其他船仍在贸易时，空闲船长期停留在远方。
修改基点后可能继续使用旧位置搜索。	船只迁移到新的基点调度组，并重新建立搜索上下文。	确保采购依据设置的基点，而不是船只当前位置。
失败原因难以对应到具体船只。	对应船只显示可读的行为失败原因，同时保留必要的总日志通知。	方便测试、维护和发现配置问题。

与原版M4采购骡子的主要变化

原版行为	本模组行为	修改原因
每艘M4主要独立搜索和评估贸易。	同一基点下的M4共享一次船队调度、需求状态和货源信息。	减少重复搜索，并允许多艘船协作处理同一组缺口。
船只可能按照XL、L、M、S等级顺序处理，即使实际容量存在交叉。	所有符合条件的船按照实际货仓容量和型号分组排序。	避免小容量XL阻塞大容量L。
单个订单不足装载率时可能被拒绝。	船只可以组合副订单；尾单阶段必要时解除最低装载率限制。	避免少量缺口长期无人处理。
某种商品可能只搜索到一个实际货源。	在设定的主路径范围和距离限制内继续搜索同商品的其他工厂。	避免单个工厂产量不足导致整笔缺口失败。
玩家和NPC货源沿用原有优先级。	库存超过门槛的玩家工厂可以优先供货；关闭优先后，合格玩家工厂仍可以正常参与竞争。	支持专门的玩家后勤工厂，同时避免低库存的商业工厂被强制纳入供货。
空闲返航依赖更大范围的船队状态。	每艘空闲船独立返回设置的空间站或星区。	避免其他船仍在贸易时，空闲船长期停留在远方。
修改基点后可能继续使用旧位置搜索。	船只迁移到新的基点调度组，并重新建立搜索上下文。	确保采购依据设置的基点，而不是船只当前位置。
失败原因难以对应到具体船只。	对应船只显示可读的行为失败原因，同时保留必要的总日志通知。	方便测试、维护和发现配置问题。

---

M4 参数

English

The main settings for the M4 Supply Mule are:

• Maximum trades — Maximum number of purchase lots assigned in one dispatch.
• Minimum cargo used — Normal minimum cargo-fill percentage before a ship accepts a plan.
• Corridor depth — How many jumps outside the primary route may be searched for secondary suppliers.
• Corridor markup — Price evaluation increase for each jump away from the primary route.
• Prefer player suppliers — Allows eligible player factories to be considered before NPC suppliers.
• Player factory supply threshold — A player factory may supply only when its physical stock is strictly above this percentage of its allocated storage.
• Only serve home station — Restricts receiving stations according to the configured home scope. When disabled, other valid player stations inside the home range may also be served.
• Allow NPC suppliers — Controls whether NPC factories may be used as sources.
• Allow player suppliers — Controls whether eligible player-owned factories may be used as sources.
• Resource, intermediate and build storage options — Controls which production or construction-related demands may be considered.

A player factory that passes the stock threshold does not have to keep that percentage after the shipment. The threshold is an eligibility trigger, not a reserve requirement.

If the above information still doesn't help you understand these parameters, my https://github.com/Sam-D709/Mules-Supply-Mod-OPUS will provide dedicated examples

中文

M4采购骡子的主要参数包括：

• 最大交易次数：一次调度中最多组合多少笔采购订单。
• 货仓装载比例：正常模式下，船只接受采购方案所需达到的最低货仓占用百分比。
• 副单搜索范围：允许在主路径外额外搜索多少跳的同商品货源。
• 副单价格加成：货源偏离主路径时，每偏离一跳增加的估价百分比。
• 优先从玩家进货：允许符合条件的玩家工厂优先于NPC货源。
• 玩家工厂存货超过%时允许供货：玩家工厂实际库存必须严格超过其分配仓储量的该百分比，才允许作为玩家货源。
• 仅服务基点空间站：根据基点范围限制收货空间站。关闭后，基点范围内其他合法玩家空间站也可能被服务。
• 允许NPC货源：控制是否可以从NPC工厂采购。
• 允许玩家货源：控制是否可以从符合条件的玩家工厂采购。
• 允许原材料、允许中间产物、允许建材：控制哪些生产或建造相关需求可以被纳入搜索。

玩家工厂通过库存门槛后，发货后不需要继续保留该百分比库存。这个门槛只是“是否允许供货”的触发条件，不是强制库存保留比例。

如果以上信息还不能帮你理解这些参数，在我的 https://github.com/Sam-D709/Mules-Supply-Mod-OPUS 会有专门的举例说明

---

需求与兼容性

English

• X4: Foundations.
• Optional Mods API Support allows you to output debug logs for modules
• This mod replaces the original Mules extension.
• Do not enable both this mod and the original Mules extension.
• Mods that replace the same AI scripts, station assignment logic or trade behavior may require compatibility testing.
• Back up important saves before testing beta versions.

中文

• 需要 X4: Foundations。
• 可选Mods API Support，有了它可以输出模组的debug日志
• 本模组替代原版骡子扩展。
• 不要同时启用本模组和原版骡子。
• 修改相同AI脚本、空间站下属分配或贸易行为的模组可能需要额外测试兼容性。
• 测试版本可能改变行为，测试前请备份重要存档。

---

BUG 列表

English

Currently, the issues include:

• When scanning a major order, once a major order is confirmed, the main order will not be changed, even if the sum of the main order and all possible secondary orders cannot meet the warehouse load ratio. At this point, the order will be sent to the small ship; if there is no small ship, the warehouse restriction release action will be triggered

Solution:

• Ships that add small cargo holds to this space station

The next version may prioritize addressing this issue, but the time and performance impacts caused by multi-master order detection are still under testing

I might have to wait until I've experienced all the SWI modules before considering it

中文

目前含有的问题有：

• 货船在扫描主要订单时，只要确认了一个订单，就不会再变更主要订单，即使该主要订单连带所有可能的次要订单总和都不能满足货仓载货量比例，这时候则会将该订单下发给小船，如果没有小船则会触发解除货仓限制行动

解决方案：

• 为该空间站多放点小货仓的船

下个版本可能会优先处理这个问题，关于多主订单检测产生的时间影响和性能影响还待测试

可能得等我体验完毕SWI模组的所有内容后再做考虑

---

注意

如果你有bug需要反馈或者建议功能请前往https://github.com/Sam-D709/Mules-Supply-Mod-OPUS提交issue

如果你有bug需要反馈或者建议功能请前往https://github.com/Sam-D709/Mules-Supply-Mod-OPUS提交issue

---

鸣谢

English

Many thanks to:

• MoistDreams
• BHaden53
• Galaxy Spam
• All previous authors and contributors to Mules, Supply and Warehouses Extended
• Players who provided saves, reproduction steps, testing reports and gameplay feedback

This project is a derivative work and retains the original attribution and license information in ATTRIBUTION.md and LICENCE.md.

中文

特别感谢：

• MoistDreams
• BHaden53
• Galaxy Spam
• Mules, Supply and Warehouses Extended 的历代作者和贡献者
• 提供存档、复现步骤、测试报告和游戏反馈的玩家

本项目属于衍生作品，原作者署名和许可证信息保留在 ATTRIBUTION.md 与 LICENCE.md 中。

---

链接

GitHub Repository: https://github.com/Sam-D709/Mules-Supply-Mod-OPUS

Issue Tracker: GitHub Issues