XenoFactions

# Pull request: make Builder NPC GUI opening race-safe

- Made the client construct the fixed 63-slot Builder NPC container from GUI-open coordinates even when Depot assignment, tile, or entity synchronization is late.
- Kept placeholder containers open client-side while preserving strict real-Builder, Depot, range, and faction validation on the server.
- Added debug-only GUI lifecycle diagnostics and structural checks for the vanilla 45-slot player-to-63-slot Builder window transition.

# Pull request: fix Builder NPC container synchronization

- Unified Builder inventory sizing and container slot boundaries around the persistent 27-slot worker inventory.
- Added shared Depot assignment resolution and a 27-slot client synchronization inventory for the short entity-tracking race during GUI opening.
- Hardened Builder shift-click bounds and server interaction validation while retaining the complete status and control screen.

# Pull request: fix Builder navigation and schematic preview alignment

- Enabled the Forge 1.7.10 `EntityLiving` AI lifecycle so vanilla navigation and movement helpers physically move Builder NPCs exactly once per tick.
- Configured swimming/water traversal, broadened feet-position searches, added direct reach actions, bounded distinct path retries, and movement/path diagnostics.
- Aligned inventory-style preview geometry to exact world block cubes and documented the normalized local origin shared by preview and construction.

# Pull request: fix Builder reach-based construction and movement stalls

- Replaced exact-target navigation with collision-safe reachable work positions and a bounded movement watchdog with alternate-path retries.
- Added pre-site bulk material fetching, remaining-quantity requests, automatic temporary-state recovery, and placement-only consumption.
- Added precise break, placement, territory, unsupported-block, and path failure diagnostics to persistent jobs and both Builder status screens.
- Documented the four-block work reach and that Builders currently require no tools.

# Pull request: fix Builder Depot coordinate editing and preview placement

- Initialized new and unselected legacy Builder plans near their owning Depot while preserving deliberately selected world-origin plans.
- Made absolute world-coordinate fields editable and debounce-persistent, with Depot reset and per-axis adjustment controls.
- Moved persistent previews into camera-relative world rendering and made final native jobs consume the same server-owned plan.
- Added placement diagnostics, loading feedback, localization, and Builder planning documentation.

# Pull request: live-refresh native Builder schematics

- Added one server-owned native schematic library rooted at Forge’s `config/schematics/` directory, with snapshot-based live reload and actionable load diagnostics.
- Synchronized native schematic metadata and stable IDs to the Builder selector, including automatic polling and a manual Refresh control.
- Removed numeric underscore filename parsing while preserving strict schematic validation and persistent job copies.
- Documented arbitrary native filenames, the runtime directory, and live refresh behavior.

# Builder GUI redesign

- Split Builder worker status/control from Builder Depot planning, materials, and queue management.
- Added page-aware inventory slots, safe two-way Depot shift-click merging, real GUI buttons, searchable schematic selection, localized state text, and coordinate-qualified client snapshots.
- Documented the new Builder screens and selection workflow.

# Pull request: add the Builder city start flow

- Granted one Builder Contract to a founder only after successful XF city creation, with a safe full-inventory drop fallback.
- Restored the existing Builder machine as an obtainable, craftable Builder Depot and connected contracts to faction-authorized persistent Builder assignment.
- Persisted the two-way depot, faction, Builder, dimension, city-job association and safely paused jobs on Builder death or depot removal.
- Documented that the XF city remains the Town Hall equivalent and no additional Town Hall is required.

# Pull request: fix Builder NPC Forge 1.7.10 compilation

- Resolved the shared Builder job database through Forge 1.7.10's server-side dimension manager and made unavailable or client-world lookups fail safely.
- Restored the Minecraft item import used by the Builder's existing door and bed material mappings.