NPC Logistics

v1.1.8 (2026-07-02) — The Woodcutter Update

• Woodcutter role: workers equipped with an axe (any tier) sustainably
  harvest trees within 24 blocks of the jobsite. Supports Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Cherry, and Mangrove.
  • Minimum-reserve rule: only cuts when more than 3 trees remain in range — never clear-cuts the forest.
  • Tree heuristic: requires a vertical (axis-Y) trunk ≥ 4 logs tall with
    leaves directly above the top log, distinguishing natural trees from
    player-built log walls and cabin pillars.
  • Felling: logs broken top-down and added directly to inventory; no
    floor-pickup pass needed for the logs themselves.
  • Replanting: navigates to the stump and places one matching sapling
    before leaving.
  • Sapling pickup: before each new tree, scans the 24-block area for
    sapling item entities (leaf-decay drops from the previous fell). Navigates
    to each one and collects it; breaks low-hanging leaf blocks to clear the
    path if needed.
  • Gap planting: after depositing, physically walks to open ground spots
    within 12 blocks of the jobsite and plants any spare saplings (beyond the
    one held in reserve) one at a time. Expansion rate controlled by
    deposit-chest stock.
  • Nav timeout: unreachable trees are skipped and excluded for the
    remainder of the cycle (5-second timeout); unreachable sapling drops
    similarly excluded to prevent retry loops.