Changelog

Version: 0.3.0
Date: 2026-09-02
  Overview:
    - Introduced the event-driven v2 Flow Engine, replacing global BFS graph sweeps with localized delta wavefront pressure propagation that sleeps at 0-UPS during steady state.
    - Added pressure gradient-driven capsule motion with multi-hop internal transitions, data-driven hub cross-transit, and zero GC table churn pathfinding.
    - Integrated object destruction hooks for clean sandbox wipes and chunk deletions, paired with console debug message prefix filters and Alt Mode render sensitivity.
  Features:
    - Upgraded the flow engine backend to Version 2 (now default), propagating pressure differentials locally at 60 tiles/second and sleeping completely when networks reach equilibrium.
    - Implemented pressure gradient-driven capsule movement for v2 networks, enabling capsules to evaluate downstream path validity, navigate hubs (`cross_transit`), and park cleanly when no positive drop is available.
    - Added a startup mod setting (`pneumatic-flow-version`) to toggle between the legacy pressure graph engine (`v1`) and the new event-driven delta wavefront engine (`v2`).
    - Added `/debug-filter <text>` and `/debug-filter-reset` console commands to filter debug chat logging output by string prefix.
  Minor Features:
    - Integrated object destruction handlers (`script.register_on_object_destroyed`) across pneumatic structures and liminal holders to cleanly purge flow nodes and capsules during sandbox wipes or chunk deletions.
    - Updated the v2 flow engine to dynamically react to electrical power availability and circuit network enable conditions on pneumatic pumps and diverters.
    - Configured visual debug overlays to natively respect Factorio Alt Mode settings (`only_in_alt_mode = true`).
    - Decoupled capsule crossing permission (`cross_transit`) from gas flow propagation (`transmit`), allowing hubs to route capsules without bridging independent pressure networks.
  Optimizations:
    - Replaced map-wide capsule scans during target wakeups with an O(1) spatial parked capsule index (`storage.parked_by_port`).
    - Implemented time-sliced batching (`BATCH_SIZE = 50`) on the flow propagation queue to smooth processing across ticks during large blueprint placements or mass deconstruction.
    - Implemented module-level persistent scratch buffers for pathfinding, hop selection, and neighbor wakeups in the v2 motion runner, eliminating Lua GC table allocation during active transit.
    - Added fast-path short-circuits in visual debug renderers to bypass string key formatting and node lookups when overlays are disabled.
  Bugfixes:
    - Fixed capsule oscillation ("dancing") in zero-gradient zones, unpowered tube lines, or dead ends by enforcing strict positive pressure drop requirements (`drop > 0`).
    - Resolved capsule lockups when flow direction reverses by resetting stale origin port memory upon parking and target wakeups.
    - Fixed potential Pneumatic Control Panel GUI crashes when updating debug overlays from player handles or integer player indices.
    - Fixed orphan tracking data and stalled tube traffic during Sandbox "remove all entities" wipes by safely unparking capsules, waking upstream traffic, and disembarking passengers.

Version: 0.2.0
Date: 2026-08-31
  Overview:
    - This update introduces a consolidated Pneumatic Control Panel GUI, distinct color-coded capsule render overlays, expanded Space Age biological cargo support, and increased diverter junction throughput.
    - Network pathfinding now features downstream route lookahead validation to prevent diverters from backing up, while complete item metadata and equipment grids are preserved across all capsule operations and ground spills.
    - Major performance optimizations include 0-tick queue advancement and time-sliced network rebuilding to eliminate lag spikes, paired with seamless circuit proxy placement and improved spilled container mechanics.
  Features:
    - Added a unified Pneumatic Control Panel GUI (`/pneumatic-panel`, `/debug-panel`) accessible via a single hotbar shortcut button (`pt-debug-panel`).
    - Added Alt Mode capsule hover-peeking (`/toggle-capsule-peek` or `/capsule-peek`) to inspect capsules occupying targeted pneumatic structures.
    - Added distinct color-coded indicator rings for each capsule variant overlay (Gold, Emerald Green, Frost Cyan, Slate Grey, Violet Purple, Crimson Orange).
    - Expanded bio capsule 2x slot capacity bonus to all Space Age and Factorio 2.0 organic items (yumako, jellynut, seeds, slumps, bioflux, nutrients, eggs, bacteria, fish, wood).
    - Added red inventory bar limit slider to Pneumatic Hub GUIs for inserter deposition control.
    - Increased Pneumatic Diverter internal capsule capacity from 1 to 2 to double junction throughput.
  Minor Features:
    - Added downstream capacity and filter lookahead validation to diverters to prevent capsules from taking branches leading to full or blocked lines.
    - Preserved 100% of item metadata (quality, spoilage, durability, health, ammo, custom tags) and equipment grids (`stack.grid`) across transfers, spills, and decay.
    - Configured spilled capsule containers to red-lock slots against manual item insertion while supporting Ctrl+Click fast-looting and self-despawning when empty.
    - Partitioned storage surface grid into dual domains, placing biological cargo on 3x3 lab platforms with 2-tile water moats to contain spawned organic units.
  Graphics:
    - Configured debug render overlays to update dynamically mid-flight when refrigerated tools expire into spent capsules or cargo spoils.
    - Updated debug render layers so capsule overlays draw cleanly in front of flow vectors.
    - Suppressed secondary selection box outlines on pump and diverter circuit proxies.
  Optimizations:
    - Implemented 0-tick queue advancement for parked capsules, waking queued upstream capsules instantly when space opens without 10-tick retry delays.
    - Implemented staged, time-sliced network rebuilding and batched flow updates to eliminate FPS/UPS drops during mass building, blueprinting, or deconstruction.
    - Implemented O(1) spatial occupancy indexing and memoized port key parsing for constant-time lookups during pathing.
    - Suppressed 60-tick periodic inventory spoilage scans for capsules carrying non-spoilable cargo or fully spoiled cargo.
  Bugfixes:
    - Fixed circuit proxy combinators blocking building placement, building over, and fast-replace upgrades by assigning an empty collision mask.
    - Tuned circuit proxy selection footprints to cleanly defer hover selection and GUI opening to parent pump and diverter entities.
    - Fixed orphaned circuit proxies remaining after sandbox deconstruction, scripted removal, or space platform building/mining events.
    - Fixed Factorio 2.0 LuaItemPrototype indexing crash during hub packing.
  Locale:
    - Added localized English display names for pneumatic pump circuit proxies and hotbar shortcut toggles.

Version: 0.1.2
Date: 2026-08-29
  Features:
    - Added English locale strings for bio capsule technologies.
    - Reorganized pneumatic items and structures into a dedicated inventory tab.
    - Added native Alt Mode visual overlays for flow maps and pressure levels.
    - Refactored debug console commands and visual overlays to work per-player.
    - Added circuit network toggles for diverter enable/disable operational modes.
    - Improved hub packing logic to dynamically select optimal, capacity-cleared dispatch ports.
    - Added circuit proxies, custom GUI, and dynamic network updates for pneumatic pumps.

Version: 0.1.1
Date: 2026-08-28
  Features:
    - Fixed thumbnail having two .png extensions.

Version: 0.1.0
Date: 2026-08-28
  Features:
    - Initial public testing build for pneumatic tube transport, dynamic flow, and diverters.