Changelog

Version: 0.1.19
Date: 2026-06-05
  Bugfixes:
    - Fixed a crash when a house build was rejected at the current house cap and the mod tried to spill the refunded item using an outdated Factorio API signature.
    - Automated house ghosts that are rejected by the house cap now print a throttled message to connected players on that force, so blueprint-heavy builds explain why some houses were cancelled.
  Changes:
    - Lumberjacks now deposit harvested wood into Storage Points first, falling back to other linked houses only if every Storage Point in the network is full. Previously wood would scatter across neighbouring house inventories and Storage Points often stayed empty.
    - Storage Points now display a green dashed link line to their nearest connected house or outpost when the network is highlighted, matching how houses and outposts already show their inter-node links. Lines refresh immediately when Storage Points are placed or mined.

Version: 0.1.18
Date: 2026-06-04
  Changes:
    - Houses in the same connected network now share their item inventories for the lumberjack logistics pipeline. Workers can count, fetch, and deposit build materials across other linked houses instead of being limited to their own house inventory.
  Bugfixes:
    - Fixed lumberjacks getting stuck in "Heading home before dark" / sleeping flow for some houses. Camps in the sleeping state now always receive their wake-up tick, so the worker respawns reliably at sunrise.
    - The house "Zzzz..." sleep indicator now appears immediately when a lumberjack goes inside for the night, instead of depending on a later housekeeping sync.

Version: 0.1.17
Date: 2026-06-04
  Features:
    - Added a new 3x3 Storage Point building using `graphics/buildings/storagehouse.png`. Lumberjacks now automatically deposit harvested wood into linked Storage Points in their network, while inserters can move items in and out just like a normal chest.
    - Wood stored in linked Storage Points is now available to the lumberjack build pipeline, so house networks can consume shared lumber from storage when placing ghosts and running wood-based jobs.
    - Added `/wcai-unlock-first-houses`, an admin command that instantly researches `woodcutter-houses-1` and unlocks the first 10 houses for fast testing.
    - `/wcai-test-setup` now includes Storage Points in the starter test chest and directly in the player's inventory for quicker setup.

Version: 0.1.16
Date: 2026-06-04
  Features:
    - Added a 10-tier "House Settlement" research line. Each tier unlocks +10 buildable houses, capped at 100 total for performance. Tier 1 also unlocks the house recipe itself (locked from the start of a new game). Costs scale from 15 red science (tier 1) to 300 red + 300 green (tier 10).
    - House placements over the current cap are rejected: the entity is destroyed, the item is refunded (player inventory → robot cargo → spilled on the ground), and a "House cap reached" flying text is shown.
  Changes:
    - Mod portal description rewritten.
  Credits:
    - Added Jstank as a contributor.

Version: 0.1.14
Date: 2026-06-04
  Bugfixes:
    - Fixed cursor and selected-entity range visualizations for houses and outposts to mirror vanilla roboport exactly: orange `construction_radius = 55` outer ring + green `logistics_radius = 25` inner ring. Previously the cursor preview drew a 55-tile green logistics circle (with construction radius zeroed out for the outpost variant, and a duplicate 55-tile orange + 55-tile green for the house variant), which made the buildings look radar-sized rather than roboport-sized. After upgrading a house/outpost to a vanilla roboport, the visible range now stays identical.
    - Placed `house` (container) now also draws the 55-tile construction ring on selection. Previously containers drew nothing, so a placed house had no visible range at all while an outpost showed 55 tiles.
    - Hidden link-anchor companions explicitly disable both construction and logistic radius visualization so they cannot leak any extra rings into the cursor preview.

Version: 0.1.13
Date: 2026-06-04
  Bugfixes:
    - Fixed cursor-preview link distance for houses/outposts. The roboport-preview prototype's `logistics_connection_distance` was set to 55 (one radius) instead of 110 (two radii), so the engine only drew preview lines half as far as a vanilla roboport's cursor would. Runtime network linking already used the correct 110-tile distance, so this only affected the visual when holding the item.

Version: 0.1.12
Date: 2026-06-04
  Features:
    - Added a shortcut-bar button for the Roboport Upgrade Planner. Click the new button (or assign a keybind in Controls) to grab the tool directly into the cursor without opening a chest.

Version: 0.1.11
Date: 2026-06-04
  Features:
    - Added a custom selection-tool item, "Roboport Upgrade Planner" (`wcai-roboport-upgrade-planner`), that marks houses and outposts for upgrade to vanilla roboport. Drag over an area to mark, alt-drag to cancel. Lumberjacks then execute the upgrade through the standard upgrade pipeline (destroy + create), refunding the original house/outpost item to the network. The vanilla upgrade-planner UI cannot be used here because Factorio 2.0 requires upgrade pairs to share the same prototype type; container/radar -> roboport is rejected at the data layer regardless of `fast_replaceable_group` or `next_upgrade`. The custom tool sidesteps this by calling `entity.order_upgrade{target = "roboport"}` directly.
    - The /wcai-test-setup chest now stocks one of the upgrade tools so it can be tested immediately.

Version: 0.1.10
Date: 2026-06-04
  Changes:
    - House and outpost now share the exact roboport footprint (collision 3.4x3.4, selection 4x4) and AI radius (55 tiles), so the upgrade planner can be used to convert a network of houses/outposts directly into vanilla roboports (and back). House/outpost art is rescaled to fit the larger 4x4 selection. The shared `fast_replaceable_group` is the missing piece that previously made the upgrade-planner UI reject `house` -> `roboport` mappings.
  Fixes:
    - Lumberjacks can now execute upgrade-planner jobs that change the underlying prototype (e.g. `house` -> `roboport`). The execution path falls back to a `destroy + create` flow when the engine can't fast-replace across prototype types, so the original entity is cleaned up correctly (camp, link anchor and power node) before the new entity is built and the original item is refunded into the house.

Version: 0.1.9
Date: 2026-06-04
  Features:
    - Lumberjacks now service upgrade-planner orders within their work area, mirroring how construction bots do it: the upgrade-target item is consumed from the linked house, the original entity is replaced in place (preserving recipe, modules, circuit wiring etc. via fast-replace), and the original item is refunded into the house. Upgrades are clustered with regular build jobs of the same item name to maintain efficient pathing.
  Fixes:
    - Placing or removing a single house no longer destroys all existing lumberjacks across every surface. The on-built/on-removed handlers now only register/clean up the affected house instead of doing a full network rebuild, fixing the "lumberjacks despawn whenever I place a new house" bug.

Version: 0.1.8
Date: 2026-06-04
  Optimizations:
    - Major performance pass aimed at supporting ~100 lumberjacks in the same network. Previously each lumberjack issued its own surface-wide tree, rock and ghost searches every few ticks, so cost grew quadratically with population.
    - Tree and rock searches are now performed once per connected network and shared across all lumberjacks in that network, with a 30-tick cache (180 ticks when no resources were found, so empty-forest networks short-circuit cheaply).
    - Build/deconstruction ghost searches are now also network-shared on a 120-tick TTL, so the per-camp build queue refresh no longer issues N find_entities_filtered calls per house.
    - Connected-houses graph is now cached across ticks (30-tick TTL) instead of recomputed every tick, with explicit invalidation when houses are built, mined or destroyed.
    - Harvesting workers no longer re-issue selected/direction/orientation/walking_state/mining_state writes every 4 ticks; the writes happen once when the target changes and are skipped while we are still mining the same tree, eliminating thousands of redundant LuaEntity writes per second.
    - Lumberjack camps are now indexed by state, so the per-tick on_tick loop iterates only the relevant buckets and samples long-interval states (sleeping, finished, waiting-for-space) every 5 ticks instead of every tick.

Version: 0.1.7
Date: 2026-06-03
  Fixes:
    - Fixed a non-recoverable crash when mining a regrown managed tree after extended gameplay; the planted-tree regrowth restart path now calls the sapling module helper correctly.

Version: 0.1.6
Date: 2026-06-02
  Features:
    - Holding the house item in the cursor now previews the network the same way the outpost item does: a circle around the cursor shows the house's AI radius, and lines are drawn from the cursor to existing outposts and houses within link range.
    - Lumberjacks now perform deconstruction on entities within a linked house's work area: items marked for deconstruction (red X) are mined and deposited in the house, mirroring how construction robots service deconstruction orders.
  Changes:
    - The cursor preview connection lines now reach exactly as far as each house/outpost's own square AI range, instead of twice that range.
    - Pressing Q (smart-pipette) over a placed house now retrieves the house item from inventory the same way it works for every other building.
    - Hovering a lumberjack no longer auto-opens its inventory; press the regular open-gui key (E by default) over a lumberjack to view its inventory.
  Fixes:
    - Lumberjacks now preserve all stored ghost data when building from blueprints/ghosts: recipes on assemblers, modules, item-requests, circuit connections, fluid filters, and the input/output direction on underground belt pairs are all carried over instead of being lost.
    - Houses placed before this version now also get a hidden link anchor on the next reconciliation pass, so cursor preview lines correctly draw to all existing houses regardless of placement order.

Version: 0.1.5
Date: 2026-06-02
  Changes:
    - Renamed lumbermills to outposts across items, entities, and UI text.
    - Converted outposts from container entities to roboport-based network nodes so they no longer expose storage.
    - Moved outpost network statistics into the selected-entity panel area on the right side of the screen.
  Features:
    - Holding an outpost or house item in the cursor now previews the full surface network: existing outposts within link range are connected by lines and their work areas are highlighted, helping plan placement.
    - Outposts and houses now consume electricity from the power network: each outpost draws as much as an assembling-machine-2 (150 kW) and each house draws as much as a beacon (480 kW).
    - Outposts and houses now appear as separate entries in the Electric network info window with their own icons, so consumption per building type is visible in the statistics.
    - Outposts now show the standard "Consumes electricity" tooltip with maximum/minimum consumption and a green electricity bar when hovered, matching vanilla electric buildings.
    - Hidden outpost link anchor entities are now reliably destroyed when an outpost is mined, deconstructed, or killed by enemies, instead of lingering on the surface.
    - The "no power" alert icon is now also shown on outposts (previously only houses) and is rendered at the same size as the standard Factorio no-power overlay used by assemblers, boilers, and other vanilla buildings.

Version: 0.1.3
Date: 2026-06-01
  Features:
    - Lumberjacks now pick up and deposit any items they carry into the house, including marble paving, plank decking, gravel, and other mod-crafted goods.
    - Lumberjacks now build floor tile ghosts (marble paving, plank decking, lawn grass, pool tiling, and more) in addition to entity ghosts.
  Changes:
    - Replaced the hidden electric beacon used for power alerts with a scripted no-power icon driven directly by the actual house power state.
    - The funkis-house "Zzzz..." indicator now only appears when the lumberjack is not present in the world (hidden inside the house or not yet spawned).
  Fixes:
    - Fixed inserters being unable to deliver items to funkis-houses caused by a hidden power-node entity blocking inserter targeting.
    - Fixed all houses showing a "no power" alert even when their collision overlapped a powered electric pole supply area.
    - Fixed a crash on tree harvesting caused by an inventory iteration mismatch with the Factorio 2.0 inventory API.

Version: 0.1.2
Date: 2026-06-01
  Features:
    - Added lumberjack support for detecting and building nearby entity ghosts.
    - Added planted tree regrowth loops so managed trees regrow from the same spot after being chopped down.
  Changes:
    - Rebalanced wood-house and funkis-house recipes to use 4 higher-tier inputs each.
    - Added steel requirements to selected higher-tier construction items used in house crafting.
    - Extended connected wood-house and funkis-house networks to share combined AI work and build ranges.
  Fixes:
    - Improved lumberjack recovery when movement gets blocked by nearby objects.
    - Reduced passive AI update frequency for better performance with many houses.

Version: 0.1.1
Date: 2026-05-31
  Features:
    - Added funkis houses that spawn and house autonomous lumberjacks.
    - Added linked wood houses that extend lumberjack work areas.
    - Added powered house networks and house-crafted wood houses.
  Changes:
    - Renamed the published mod identity to Woodcutter AI.
    - Added admin-only helper commands for starter-kit and house-network sync in multiplayer.
    - Improved electricity statistics support for house power usage.
  Fixes:
    - Improved lumberjack path recovery when movement gets blocked.
    - Fixed hidden house power consumers to use house icons in electricity statistics.