UPS Saving Quality Ships

> "Get rid of computer performance and enjoy the ultimate technology!" —— Promethium Tech Pack Spaceship > > “摆脱电脑性能，畅享终极科技！” —— 黑瓶飞船

> 下拉以查看中文说明。

UPS Saving Quality Ships

Overview

UPS Saving Quality Ships modifies cargo interaction between a spaceship and the ground to simulate multiple identical spaceships operating at the same time and improve UPS.

Features

• Uses the quality level of the space platform hub as the simulation multiplier: ground-to-space cargo is divided by the multiplier on arrival, and space-to-ground cargo is multiplied by the multiplier before delivery.
• Ground to space: the mod increases the platform request first, then trims arriving cargo pod contents so the visible ship finally keeps about the original requested amount.
• Space to ground: the mod tries to launch extra cargo pods so the ground can receive about the multiplied amount while the visible ship only spends the original amount.
• The mod has a global buffer to balance rounded amounts, so repeated deliveries do not permanently create extra items or lose items.
• Adds a hub quality button for changing the quality of space platform hubs inside blueprints.
• Dynamically reads the active quality chain, so it can adapt to any mod that adds new qualities.

Usage

Multiplier

The simulation multiplier p comes from the quality level of the space platform hub.

| Hub quality | Quality level | Simulation multiplier | | --- | ---: | ---: | | normal | 0 | 1x | | uncommon | 1 | 2x | | rare | 2 | 3x | | epic | 3 | 4x | | legendary | 5 | 6x |

For quality mods, the mod reads the active quality chain from the game instead of using a fixed vanilla-only list.

Ground to space

When a ship requests x cargo from the ground and the hub multiplier is p, the mod makes the ground try to send about p × x cargo, then each arriving cargo pod is reduced so the visible ship keeps about x cargo.

Example with p = 3 and a visible ship request of 100 cargo:

| Step | Visible result | | --- | --- | | The ship requests 100 cargo | The mod makes the ground side try to send about 300 cargo | | Cargo pods arrive on the platform | The mod trims the arriving contents | | Final visible ship inventory | The ship keeps about 100 cargo |

This means one visible ship can behave like several identical ships for throughput, without needing to keep several physical copies running.

Space to ground

When the ground requests x cargo from the ship and the hub multiplier is p, the mod tries to send about p × x cargo to the ground while the visible ship only spends x cargo.

Example with p = 3 and a ground request of 100 cargo:

| Step | Visible result | | --- | --- | | The ground requests 100 cargo from the ship | The ship consumes about 100 cargo | | The mod prepares downward delivery | The mod tries to create enough cargo pods for about 300 cargo | | Final ground delivery | The ground can receive up to about 300 cargo |

If the platform cannot create enough extra downward cargo pods at that moment, the undelivered remainder is returned to the hub inventory or kept in the mod buffer for later balancing.

Buffer behavior

Some rocket loads are small or not cleanly divisible by the multiplier. The global buffer balances these rounded amounts across repeated deliveries so the long-term result stays correct.

Example with a single rocket load of 100 and p = 3:

| Rocket | Trimmed from pod | Buffer change | Ship receives | | --- | ---: | ---: | ---: | | 1 | 67 | +1 | 33 | | 2 | 67 | +1 | 33 | | 3 | 66 | -2 | 34 |

Across these three rockets, the ship receives 100 cargo in total, which is the intended visible amount.

Changing hub quality in blueprints

The original game cannot upgrade space platform hubs with an upgrade planner, and heavily wired hubs are annoying to replace manually in blueprints. This mod adds a button for changing space platform hub quality inside blueprints.

| Action | Result | | --- | --- | | Hold a writable blueprint and left-click the hub quality button | Raise the quality of space platform hubs in the blueprint | | Hold a writable blueprint and right-click the hub quality button | Lower the quality of space platform hubs in the blueprint | | Hold a writable blueprint book and use the same button | Process blueprints inside the book |

Blueprint records in My blueprints are read-only to mods. Move the blueprint or blueprint book to inventory or Public blueprints before using the button.

Acknowledgments

• Special thanks to BAYUNZIYUE; the original idea for this mod came from him, and repeated discussion and testing shaped the implementation.
• Special thanks to plexpt for pointing me to the forums when rocket launch behavior became difficult to understand.
• Special thanks to tanvec for helping with documentation research, dynamic logistics group direction, and blueprint modifiability questions.
• Special thanks to the BlueprintSignals project, which showed how to build bottom-right blueprint tools.
• Special thanks to PHIDIAS for providing reference code examples around whether blueprints can be modified and how to modify them.
• Thanks to every player who uses this mod.

If you have any comments or suggestions, please share them in the Factorio discussion or on GitHub.

中文说明

概览

UPS 友好型品质飞船会修改飞船与地面的货物交互逻辑，从而模拟多个相同的飞船同时运行，以提高 UPS。

功能简介

• 使用太空平台枢纽的品质等级作为模拟倍率：地面到太空的货物在到达后按倍率缩减，太空到地面的货物在发射前按倍率放大。
• 地面到太空：模组会先放大平台请求，再在货舱到达后缩减内容，让可见飞船最终大致保留原本请求的数量。
• 太空到地面：模组会尝试额外发射货舱，让地面大致收到倍率放大后的数量，而可见飞船只消耗原本数量。
• 模组有一个全局缓冲区用于平衡零头，确保多次运输后不会凭空多出物品或少掉物品。
• 新增了一个枢纽品质按钮，用于修改蓝图中的太空平台枢纽品质。
• 动态读取当前品质链，从而适配任何新增品质的模组。

使用说明