Payload Loader

Payload Loader is a specialized block that assembles and outputs payloads by combining the items and liquids it holds into a single transportable payload. It differs from most storage and crafting blocks by treating its internal contents as components for an outgoing payload rather than simply as stock: when a payload is being filled the loader selects whichever item or liquid it currently contains the most of and begins filling that payload type, and the payload is emitted once any single component reaches that payload’s capacity.

Payload Loaders have a hard limit of 100 total items stored inside them; when the sum of all item stacks in the block reaches 100, no further items can be inserted. Liquids are handled alongside items and may be loaded at the same time as item payload components. When multiple item types are present, the loader starts by filling with the most abundant type that the payload can accept. If that most populous type runs out mid-fill, the loader will switch to the next-most-populous compatible type and continue filling until the payload emits.

A payload emits as soon as any one item or liquid in the payload reaches the maximum amount that payload accepts. This means payloads that require large single-component quantities will delay output until that component reaches its threshold; conversely payloads with lower per-component capacity will emit sooner. Practical consequences of this design include the need to ensure the loader is supplied with a steady, concentrated source of the intended payload component to avoid prolonged or stalled filling.

• Total internal item capacity is 100 items; no further item insertion occurs once this cap is reached.
• Filling preference is determined by current abundance: the loader uses the item or fluid it contains the most of, provided the payload can store that component.
• If the chosen component is depleted while a payload is being filled, the loader immediately begins filling with the next-most-abundant compatible component.
• Items and liquids can be loaded simultaneously into the same payload; a payload will output once any single stored component reaches that payload’s maximum capacity.
• Because payload emission depends on per-component maxima, matching supply rates to the payload’s highest-required component shortens fill time and prevents blocking on scarce components.