Logistic Group Circuit Combinator

Factorio 2.0 mod that adds a combinator which drives the contents of a logistic group from the circuit network. Wire item signals into it, assign its section to a named logistic group, and each signal's value becomes the requested amount of that item for the group — everywhere the group is used.

How it works

The Logistic Group Combinator is a reskinned (green) constant combinator. Every update tick the mod reads the item signals wired into it and writes them as the filters of the section you assigned to a logistic group. Because logistic groups are shared, those values propagate to every requester/buffer chest (and spidertron) that uses the same group.

• Signal value = requested amount. Iron plate = 500 makes the group request 500 iron plates.
• Signals at ≤ 0 or absent are not requested.
• Only item signals are used (fluids and virtual signals are ignored).
• Signal quality is respected — an uncommon item signal requests that quality.
• Red and green wires are summed.
• The combinator's own signal output is kept off, so it never feeds its signals back onto the network it reads (no feedback loop).

Usage

1. Research Circuit network (the recipe is unlocked alongside it) and build the Logistic Group Combinator (the green combinator).
2. Place it and wire a circuit (red or green) carrying the demand signals.
3. Open it, create a section, and assign it to a named logistic group.
4. In any requester/buffer chest, select the same group — it now requests whatever the signals dictate.

The refresh interval is configurable under Settings → Map: Logistic group update interval (ticks) (default 30).

Compatibility

• Factorio 2.0+ (base game). Logistic groups are a base 2.0 feature.
• Space Age (optional) — only needed for the quality pass-through to have an effect.

Localization

Available in: English, Português (Brasil), Deutsch, Русский, Français, Español, 简体中文, 日本語, Polski, Čeština, Українська.

Technical Notes

• Prototypes are built in prototypes/entity.lua by reusing the base constant-combinator and repointing the body sprite/icon to a green, hue-shifted copy in graphics/.
• Runtime logic lives in control.lua and runs on an on_nth_tick interval (no per-tick work).
• Build/destroy events are filtered to the mod's entity; only registered combinators are updated.

Installation

Copy the logistic-group-circuit_<version> folder into your Factorio mods/ directory and enable it from the in-game mod manager.

Packaging

Set the target release version in info.json, then run ./scripts/package.sh to generate a zip in this format:

• logistic-group-circuit_<version>.zip
• containing folder logistic-group-circuit_<version>/ with all project files

Pushes to develop build the same versioned zip as a workflow artifact for local testing. Pushes to main build the zip, create the matching GitHub release tag, attach the zip to the GitHub Release, and publish the package to the Factorio Mod Portal. Configure the GitHub Actions secret FACTORIO_MOD_PORTAL_TOKEN with a Mod Portal API token before publishing from main.

Version History

• 1.0.0 - Initial release: Logistic Group Combinator that drives a logistic group's item requests from circuit signals; green hue-shifted sprite and icon; packaging scripts and CI workflows.

Maintainer note: whenever info.json version changes for a release, append a new section to the top of changelog.txt using the custom tags Changes, Bugfixes, and Info.