Quick Swap


Quickly swap held belts, pipes, and electric poles with the mouse wheel.

Utilities
4 hours ago
2.0 - 2.1
0
Logistics

Changelog

Version: 0.2.9
Date: 2026-09-04
  Features:
    - Factorio 2.1 package of the 0.2.8 pipe and electric-pole swapping feature.
  Bugfixes:
    - Skip unavailable belt kinds during Shift-wheel cycling so partial belt groups still wrap.
Version: 0.2.8
Date: 2026-09-04
  Bugfixes:
    - Skip unavailable belt kinds during Shift-wheel cycling so partial belt groups still wrap.
  Features:
    - Support Shift-wheel and Control-wheel swaps in TAB/map view without requiring inventory items.
    - Keep the pre-swap quality in TAB/map and remote view while limiting items to force-unlocked recipes.
    - Read and replace the remote-view cursor ghost so wheel swaps work without a physical cursor stack.
    - Enable all four custom inputs while spectating so remote/map controllers receive the wheel events.
    - Preserve legendary remote cursor quality without rejecting all swap candidates through a redundant quality-unlock check.
    - Cycle between normal and underground pipes with Shift + mouse wheel.
    - Step through electric poles in ascending or descending order with Shift + mouse wheel, without wrapping at either end.
    - Skip unavailable intermediate electric poles when moving in either direction.
    - Keep belt, pipe, and electric-pole swaps isolated to their own groups.
    - Use the highest available target quality when swapping from character inventory.
  Changes:
    - Preserve vanilla wheel actions when no swap occurs, including blueprint-book cycling and normal zoom.
    - Temporarily lock the current zoom during a successful swap instead of restoring the camera after it moves.
Version: 0.2.7
Date: 2026-09-04
  Bugfixes:
    - Factorio 2.1 package of the 0.2.6 partial-stack and tier-skip fixes.
Version: 0.2.6
Date: 2026-09-04
  Bugfixes:
    - Allow belt swaps whenever at least one matching target item is available.
    - Use the target's actual available quantity when setting the cursor stack.
    - Skip unavailable intermediate tiers when cycling in either Control-wheel direction.
Version: 0.2.5
Date: 2026-09-04
  Bugfixes:
    - Factorio 2.1 package of the 0.2.4 full-stack swap fix.
Version: 0.2.4
Date: 2026-09-04
  Bugfixes:
    - Allow a full transport-belt stack to switch to an underground belt or splitter.
    - Return the original belt stack to inventory when the target item's stack limit is smaller.
Version: 0.2.3
Date: 2026-09-04
  Bugfixes:
    - Factorio 2.1 package of the 0.2.2 belt-tier and mouse-wheel fixes.
Version: 0.2.2
Date: 2026-09-04
  Bugfixes:
    - Classify belt tiers using the runtime `belt_speed` property.
    - Fix Shift type swaps for yellow belts and prevent cross-tier fallbacks.
    - Fix Control tier swaps, including Space Age and compatible mod-added tiers.
    - Consume the Shift/Control mouse-wheel bindings to prevent simultaneous zooming.
Version: 0.2.1
Date: 2026-09-04
  Changes:
    - Adds a separately packaged Factorio 2.1-compatible release.
Version: 0.2.0
Date: 2026-09-04
  Features:
    - Swap the held belt type with Shift + mouse wheel.
    - Swap the held belt tier with Control + mouse wheel.
    - Supports unlocked belt items in remote view and inventory-only swapping while controlling a character.
Version: 0.1.0
Date: 2026-09-04
  Features:
    - Initial Factorio 2.0 mod foundation.
    - Adds a configurable Quick Swap mode toggle (default: Control + B).