agrarian/dev/HANDOFF.md

Agrarian Codex Handoff

Project State

Active repo:

/var/www/root_builds/agrarian

Unraid Build Support Box

Unraid host being built to support Agrarian game/build work:

Host: DevBox
IP: 192.168.5.8
SSH user: root

Do not store the plaintext Unraid password in this handoff file.

SMB / Windows share troubleshooting completed 2026-05-11:

• The initially supplied IP 192.168.4.8 was wrong/unreachable.
• Correct IP 192.168.5.8 is reachable by SSH.
• Samba is running and listening on ports 139 and 445.
• WSD discovery is running via wsdd2 on ports 3702 and 5355.
• NetBIOS is disabled, so old Windows Network browsing is not expected to work; modern Windows should use WSD or direct UNC paths.
• Workgroup is WORKGROUP.
• The issue was that all shares had SMB export disabled with shareExport="-", leaving /etc/samba/smb-shares.conf empty.
• After fixing share export, Samba lists these shares: appdata, backups, domains, isos, projects, system, and IPC$.

Verification command:

ssh root@192.168.5.8 'smbclient -L //127.0.0.1 -N -m SMB3'

Windows direct access path for build work:

\\192.168.5.8\projects

Security follow-up: at verification time the exported shares were public and writeable. That is convenient for setup, but appdata, domains, and system should be locked down or hidden after the Windows workflow is confirmed.

Ubuntu-Codex VM repair completed 2026-05-11:

• VM name: Ubuntu-Codex.
• It was running in libvirt but showing the OVMF UEFI shell instead of booting.
• The vdisk was blank/uninstalled: /mnt/cache/domains/Ubuntu-Codex/vdisk1.img, raw 50 GiB.
• The attached Ubuntu ISO was corrupt/sparse. Kernel extraction produced zeroed data, and GRUB reported invalid magic number / you need to load the kernel first.
• Bad ISO preserved at: /mnt/cache/isos/ubuntu-24.04.4-live-server-amd64.iso.bad-sparse.
• Fresh Ubuntu Server ISO downloaded from Ubuntu releases and verified against SHA256SUMS as OK.
• VM config changed to:
  • BIOS boot instead of OVMF/pure EFI.
  • 4 GiB RAM.
  • 4 vCPU, 2 cores x 2 threads.
  • CD-ROM boot order 1, vdisk boot order 2.
• Previous VM XML backup: /boot/config/Ubuntu-Codex.before-bootfix-20260511.xml.
• Final verification: VM reaches the Ubuntu Server installer language screen.
• After installation, eject/remove the ISO or set vdisk first so it boots into the installed OS.

Windows 11 ISO refresh completed 2026-05-11:

• Existing Win11_25H2_English_x64_v2.iso was sparse/incomplete: logical size 7.9 GiB, actual disk use about 406 MiB.
• Bad copy preserved at: /mnt/cache/isos/Win11_25H2_English_x64_v2.iso.bad-sparse.
• Fresh Microsoft-hosted ISO downloaded to: /mnt/cache/isos/Win11_25H2_English_x64_v2.iso.
• Verified SHA256: 768984706b909479417b2368438909440f2967ff05c6a9195ed2667254e465e3.
• File ownership/permissions normalized for Unraid share access: nobody:users, mode 0666.

VirtIO driver ISO refresh completed 2026-05-11:

• Existing virtio-win-0.1.285.iso was sparse/incomplete: logical size 754 MiB, actual disk use about 94 MiB.
• Bad copy preserved at: /mnt/cache/isos/virtio-win-0.1.285.iso.bad-sparse.
• Fresh Fedora virtio-win stable ISO downloaded to: /mnt/cache/isos/virtio-win-0.1.285.iso.
• Verified byte size 789645312 and representative Windows 11 amd64 driver files under vioscsi, viostor, NetKVM, and Balloon.
• Verified SHA256: e14cf2b94492c3e925f0070ba7fdfedeb2048c91eea9c5a5afb30232a3976331.
• File ownership/permissions normalized for Unraid share access: nobody:users, mode 0666.

Windows-Builder VM created on Unraid 2026-05-12:

• VM name: Windows-Builder.
• Intended role: Windows build/Unreal development VM.
• No GPU passthrough yet; initial graphics is VNC/QXL.
• Machine/firmware: Q35 (pc-q35-9.2) with OVMF pure EFI.
• CPU/RAM: 8 vCPU with topology 4 cores x 2 threads, 8 GiB RAM.
• Disk: 100 GiB raw VirtIO disk at /mnt/cache/domains/Windows-Builder/vdisk1.img.
• Attached Windows ISO: /mnt/cache/isos/Win11_25H2_English_x64_v2.iso.
• Attached VirtIO ISO: /mnt/cache/isos/virtio-win-0.1.285.iso.
• Network: bridged to br0 with VirtIO NIC.
• TPM 2.0 emulator enabled for Windows 11 installer compatibility.
• UUID: 4244a763-91ae-4745-b417-224d42e9fb20.
• MAC: 52:54:00:17:ec:5d.
• Verified VM starts successfully. VNC display was :1 / TCP 5901 at creation time.

Windows-Builder boot fix 2026-05-12:

• User saw the OVMF mapping table / UEFI shell instead of Windows setup.
• Found the VM definition had drifted to bad install values: max memory about 14 GiB, current memory 1 GiB, and no TPM.
• Backups saved on Unraid:
  • /boot/config/Windows-Builder.before-bootfix-20260512.xml
  • /boot/config/Windows-Builder.VARS.before-bootfix-20260512.fd
• Re-defined VM with 8 GiB current/max RAM, 8 vCPU, OVMF/Q35, TPM 2.0, VNC/QXL, Windows ISO boot order 1, VirtIO disk boot order 2, and a five-second OVMF boot menu.
• Reset OVMF vars from /usr/share/qemu/ovmf-x64/OVMF_VARS-pure-efi.fd.
• Started VM, sent a boot key during the Windows DVD prompt, and verified by screenshot that Windows 11 Setup reached the language selection screen.

Windows-Builder RDP/QEMU tools update 2026-05-13:

• Installed local headless RDP tooling on the Codex host: freerdp2-x11, xvfb, xdotool, and imagemagick.
• Used headless RDP to connect to 192.168.5.12 as local admin nathan.
• Extracted qemu-ga-x86_64.msi and virtio-win-guest-tools.exe from the VirtIO ISO on Unraid and staged them through RDP drive redirection.
• Copied installers into C:\Users\nathan\Downloads.
• Installed QEMU Guest Agent from an elevated Windows command prompt.
• Verified Windows service QEMU-GA is running.
• Verified from Unraid:
  • virsh domifaddr Windows-Builder --source agent reports 192.168.5.12/22.
  • guest agent responds to guest-info, version 110.0.2.
  • active NIC is Red Hat VirtIO Ethernet Adapter, status Up, MAC 52-54-00-17-EC-5D, link speed 10 Gbps.
  • RDP/SMB/RPC remain reachable on 192.168.5.12.
• Also ran virtio-win-guest-tools.exe /S from elevated prompt to install the bundled VirtIO guest tools package.

Ubuntu-Codex VM network fix 2026-05-13:

• Initial SSH to nathan@192.168.5.10 failed with No route to host.
• From Unraid, the VM was running with VirtIO NIC model but no guest IPv4.
• Runtime NIC MAC was 34:c9:3d:2d:09:74, conflicting with the Unraid host wireless-derived MAC pattern and unsuitable for a VM.
• XML backups saved on Unraid:
  • /boot/config/Ubuntu-Codex.before-netfix-20260513.xml
  • /boot/config/Ubuntu-Codex.persistent.before-netfix-20260513.xml
• Changed persistent VM NIC MAC to 52:54:00:a5:cf:63.
• Mounted the guest vdisk offline via qemu-nbd; logs confirmed Ubuntu already had virtio_net in use, so there is no separate Linux VirtIO network driver package like on Windows.
• Added /etc/netplan/99-static-enp1s0.yaml with static 192.168.5.10/22, gateway 192.168.4.1, DNS 192.168.4.1 and 1.1.1.1.
• Disabled cloud-init network rewrites with /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg.
• Installed qemu-guest-agent; Unraid can now report guest IPs through the agent.
• Verified SSH works, enp1s0 is up at 192.168.5.10/22, ethtool -i enp1s0 reports driver virtio_net, and a 20-packet ping test had 0% loss.
• Passwordless sudo enabled for nathan via /etc/sudoers.d/90-nathan-nopasswd.
• Verified with visudo -cf /etc/sudoers.d/90-nathan-nopasswd and sudo -n true.

Ubuntu-Codex DevBox SMB name-resolution fix 2026-05-13:

• User reported CIFS mount path //DevBox/projects failed before mounting with could not resolve address for DevBox.
• Did not mount the share.
• Cause: Ubuntu was only using /etc/hosts plus DNS for host lookup; DNS did not know DevBox. Unraid has NetBIOS disabled and WSD enabled, which is fine for Windows discovery but not enough for Linux bare-name CIFS resolution.
• Backed up Ubuntu hosts file to: /etc/hosts.bak.20260513-devbox-resolution.
• Added: 192.168.5.8 DevBox devbox DevBox.local devbox.local.
• Verified getent hosts DevBox, ping DevBox, and SMB port 445 via hostname. Share was not mounted.

Agrarian Earth-scale tile streaming design update 2026-05-15:

• Completed the roadmap item to create the Earth-scale terrain/tile streaming design document.
• Repo path: /mnt/projects/AgrarianGameBulid/Docs/Terrain/EarthScaleTileStreamingDesign.md
• Content captured:
  • 1 km x 1 km Earth-scale tile architecture for an eventual 510-520 million possible tile world.
  • Ground Zero MVP tile identity: gz_us_ca_pacifica_utm10n_e544_n4160.
  • Coordinate strategy: registry maps real-world coordinates to logical tiles; Unreal uses tile-local metric coordinates and World Partition placement.
  • Projection, UTM-zone, dateline, and polar handling approach.
  • Tile adjacency/stitching, package versioning, immutable publication, and save-data separation rules.
  • MVP static HTTP tile delivery protocol using http://maps.agrariangame.com:18080.
  • Decision: the LAN-hosted Agrarian-TileServer VM is acceptable for MVP and internal closed testing; move public delivery to an external cloud/CDN path before broader public testing.
  • Client cache layout, cache retention, redownload/revalidation behavior, single-tile import pipeline, biome/resource inference pipeline, QA gates, and World Partition requirements.
• Roadmap updated:
  • Marked the Earth-scale terrain/tile streaming design document complete.
  • Marked related Phase 0.7 design decisions complete.
  • Immediate next item is creating the economy and AGR design document.

Agrarian economy and AGR design update 2026-05-15:

• Completed the roadmap item to create the economy and AGR design document.
• Repo path: /mnt/projects/AgrarianGameBulid/Docs/EconomyAndAgrDesignDocument.md
• Content captured:
  • Economy progression from survival barter to specialization, settlements, regional trade, and later AGR utility.
  • MVP economy scope: secure barter/direct trade, ownership transfer, server-side validation, transaction records, and persistence.
  • AGR MVP boundary: design/placeholder only; no token transfers, wallet requirement, paid survival advantage, marketplace, or real-money utility in the first playable MVP.
  • Wallet/account direction: defer custodial vs non-custodial choice; do not store wallet secrets in the Unreal client, saves, logs, config, or repo.
  • Testnet/devnet, confirmation, in-game ledger, anti-abuse, fairness, legal, compliance, and testing gates.
• Roadmap updated:
  • Marked the economy and AGR design document complete.
  • Marked related AGR design/planning items complete.
  • Immediate next item is creating art direction, UX/HUD direction, coding standards, Blueprint standards, and asset/folder naming standards.

Agrarian art/UX/code/asset standards update 2026-05-15:

• Completed the roadmap item to create art direction, UX/HUD direction, coding standards, Blueprint standards, and asset/folder naming standards.
• Repo path: /mnt/projects/AgrarianGameBulid/Docs/ArtUxCodeAndAssetStandards.md
• Content captured:
  • Grounded visual/art direction for real terrain, survival materials, Ground Zero, character presentation, and startup/demo UX.
  • HUD/UX priorities for survival, interaction, inventory, crafting, building, weather, and player-facing copy.
  • Content/Agrarian folder standards and Unreal asset naming prefixes.
  • Data asset and save/persistence standards.
  • C++ and Blueprint standards for server authority, replication, categories, testing, and prototype content.
• Added .gitkeep placeholders for missing Agrarian content folders including Audio, Characters, Environment, Items, Materials, Prototypes, Systems, UI, Developer, Blueprint subfolders, and DataAsset subfolders.
• Roadmap updated:
  • Marked the standards item complete.
  • Marked the corresponding Phase 0.3 and 0.4 folder/naming checklist items complete.
  • Immediate next item is defining what qualifies as the 6-month MVP and what is explicitly excluded.

Agrarian six-month MVP definition update 2026-05-15:

• Completed the roadmap item to define what qualifies as the six-month MVP and what is explicitly excluded.
• Repo paths:
  • /mnt/projects/AgrarianGameBulid/Docs/SixMonthMvpDefinition.md
  • /mnt/projects/AgrarianGameBulid/Docs/MvpSurvivalReadinessCriteria.md
• Content captured:
  • Six-month MVP statement and acceptance checklist.
  • Target test audience and player count: minimum 2-player proof, target 4-player closed-test smoke group, stretch 8-player test if stable.
  • Required pillars for startup/entry, Ground Zero map, survival loop, time/weather, multiplayer, persistence, UI/UX, and build/operations.
  • Explicit exclusions including full Earth-scale world, complete farming/livestock, family/generation systems, full economy/AGR utility, wallet linking, public Steam/Epic launch, vehicles, final art/audio, and public anti-cheat/moderation suite.
  • Acceptable first-pass biome/resource accuracy for Ground Zero.
• Roadmap updated:
  • Marked Version 0.01 Foundation Baseline complete.
  • Advanced current version to 0.1 Foundational Survival MVP.
  • Immediate next item is deciding first-person, third-person, or hybrid camera.
• Milestone build rule:
  • Fresh Windows Development packaged build completed successfully after the 0.01 milestone closed.
  • Output archive: /mnt/projects/AgrarianGameBulid/Builds/WindowsDevelopment
  • Build command: UNRAID_PASSWORD=... /home/nathan/bin/winbuilder cmd 'set AGRARIAN_NO_PAUSE=1 && pushd \\DevBox\projects\AgrarianGameBulid && Scripts\PackageWindowsDevelopment.bat'
  • Smoke launch used the packaged AgrarianGame.exe with -nullrhi, -nosound, and an explicit log path: /mnt/projects/AgrarianGameBulid/Saved/Logs/PackagedSmoke-20260515-001.log
  • Smoke result: process was stopped after 60 seconds because it did not auto-exit in headless mode, but the log confirms UEngine::Browse, LoadMap, and Load map complete for /Game/Agrarian/Maps/L_GroundZeroTerrain_Test.

Agrarian camera perspective decision update 2026-05-15:

• Completed the roadmap item to decide first-person, third-person, or hybrid camera.
• Decision: hybrid camera with third person as the default view and an optional first-person toggle that players can switch back from.
• Repo path: /mnt/projects/AgrarianGameBulid/Docs/CameraPerspectiveDecision.md
• Roadmap updated:
  • Marked the camera decision complete in 1.1 Core Player Foundation.
  • Added Implement first/third-person camera toggle as the next roadmap implementation item.
  • Immediate next item is implementing the first/third-person camera toggle.

Agrarian roadmap aging/care-quality update 2026-05-15:

• User asked where the roadmap tracks character aging, lifetime care quality, stat effects based on care received, and visual skin/body aging.
• Updated /mnt/projects/AgrarianGameBulid/AGRARIAN_DEVELOPMENT_ROADMAP.md.
• Added near-term guardrails:
  • Phase 1.2 Character Stats: reserve long-term care history fields for nutrition, illness, injury, sleep, shelter, stress, workload, and treatment quality.
  • Phase 1.13 Persistence MVP: save long-term character care history placeholders without applying aging gameplay yet.
• Expanded Phase 4.1 Aging And Lifespan with lifetime care quality model, lifetime care tracking, stat impacts, childhood/development care effects, and long-term consequences/benefits from poor or good care.
• Added Phase 4.5 Character Visual Aging And Condition for visual age stages, skin aging, hair aging, body/posture aging, care-quality appearance, MetaHuman/material/mesh strategy, morph/material parameters, replication, persistence, and UI/profile presentation.
• Immediate next roadmap item remains Implement first/third-person camera toggle.

Unraid DevBox network discovery fix 2026-05-13:

• Fixed discovery on Unraid because Windows and Ubuntu clients could not reach DevBox by name.
• Backups on Unraid:
  • /boot/config/ident.cfg.bak.20260513-discovery
  • /boot/config/avahi-daemon.conf.bak.20260513-discovery
  • /boot/config/go.bak.20260513-discovery
• Enabled NetBIOS in /boot/config/ident.cfg: USE_NETBIOS="yes".
• Restarted Samba; verified nmbd is running and UDP 137/138 are listening.
• Fixed Avahi runtime publishing:
  • host-name=DevBox
  • allow-interfaces=br0
  • publish-workstation=yes
  • use-ipv6=no
• Restarted Avahi; it now advertises DevBox.local instead of DevBox-4.local.
• Added a boot-time block to /boot/config/go so the Avahi runtime changes are re-applied after reboot.
• Verified from Windows VM:
  • Resolve-DnsName DevBox returns DevBox.local and IPv4 192.168.5.8.
  • Test-NetConnection DevBox -Port 445 succeeds.
  • Test-NetConnection DevBox.local -Port 445 succeeds.
• Verified from ubuntu-codex: hostname resolution and TCP 445 work for DevBox and DevBox.local.
• Caveat: arbitrary Linux clients using bare //DevBox/... still need DNS or /etc/hosts for the single-label name, or they should use DevBox.local with mDNS enabled.

Active branch:

2.0

The 2.0 branch is intended to become the main development line after final build validation. The worktree may contain build-generated files after local compiles; do not commit generated build output.

Current Build Baseline

Validated locally during the final pre-main pass:

env JOBS=8 ./contrib/build-linux.sh
env JOBS=8 ./contrib/build-linux-wallet.sh
./contrib/smoke-test-daemon.sh
./contrib/smoke-test-wallet.sh
./contrib/smoke-test-qt.sh

Expected successful artifacts:

src/agrariand
src/agrarian-cli
src/agrarian-tx
src/qt/agrarian-qt

Additional validation completed during this pass:

ALLOW_ROOT_BUILD_MENU=1 AGRARIAN_MENU_CHOICE=windows-daemon WORKDIR=/var/www/root_builds/agrarian BRANCH=2.0 JOBS=8 ./contrib/agrarian-build-menu.sh
ALLOW_ROOT_BUILD_MENU=1 AGRARIAN_MENU_CHOICE=windows-qt WORKDIR=/var/www/root_builds/agrarian BRANCH=2.0 JOBS=8 ./contrib/agrarian-build-menu.sh
ALLOW_ROOT_BUILD_MENU=1 AGRARIAN_MENU_CHOICE=linux-arm64-daemon WORKDIR=/var/www/root_builds/agrarian BRANCH=2.0 JOBS=8 ./contrib/agrarian-build-menu.sh
ALLOW_ROOT_BUILD_MENU=1 AGRARIAN_MENU_CHOICE=linux-arm64-qt WORKDIR=/var/www/root_builds/agrarian BRANCH=2.0 JOBS=8 ./contrib/agrarian-build-menu.sh

The ARM64 daemon cross-build produced ARM aarch64 ELF binaries. The ARM64 Qt target correctly refused to run on x86_64 and remains native-only.

Build Menu

Use the menu for fresh-machine testing:

curl -L https://raw.githubusercontent.com/pacificao/agrarian/2.0/contrib/agrarian-build-menu.sh -o agrarian-build-menu.sh
chmod +x agrarian-build-menu.sh
BRANCH=2.0 ./agrarian-build-menu.sh

For controlled root-only environments only:

ALLOW_ROOT_BUILD_MENU=1 BRANCH=2.0 ./contrib/agrarian-build-menu.sh

The menu now includes Linux, Windows, and ARM64 targets. ARM64 daemon cross-build from x86_64 is supported. ARM64 Qt is native-only for now.

Network Notes

Mainnet P2P port:

51336

Seed nodes currently use:

node1.agrariancoin.com
node2.agrariancoin.com
node3.agrariancoin.com
node4.agrariancoin.com
node5.agrariancoin.com

The daemon has been used to test peer visibility with another node at dev.barnealogy.com. Recheck connectivity after major consensus or network changes.

Important Decisions

• Keep Berkeley DB at 4.8.30 for 2.0 wallet compatibility.
• Do not upgrade to BDB 18.x in this release.
• Treat a SQLite wallet backend as a future migration project with backup, migration, and rollback documentation.
• For now, Linux validation is the fastest correctness loop, but Windows builds must pass before release.
• Do not assume Linux success guarantees Windows success; cross-build and Qt plugin/link behavior can fail independently.

Known Warning Areas

• std::random_shuffle deprecation warnings remain.
• Some vendored dependency warnings remain.
• Some old Boost/LevelDB warning noise remains.
• Cleanup should be correctness-driven, not broad cosmetic churn before release.

Safe Cleanup Pattern

Before committing, stage intentional source/doc/script files first, then revert unstaged build output:

git add <intentional files>
git restore .
git clean -nd

Only run git clean -fd after reviewing the dry-run output.

Ubuntu-Codex DevBox Project Mount / GitHub Setup - 2026-05-13

• On ubuntu-codex (192.168.5.10), mounted Unraid //DevBox/projects at /mnt/projects.
• Persistent mount added to /etc/fstab using guest/public SMB access: //DevBox/projects /mnt/projects cifs guest,uid=nathan,gid=nathan,file_mode=0775,dir_mode=0775,vers=3.1.1,noserverino,_netdev,nofail,x-systemd.automount,x-systemd.idle-timeout=600 0 0
• The projects share is public on Unraid, so no SMB password is needed for this mount.
• Installed git-lfs on ubuntu-codex and ran git lfs install.
• GitHub SSH access on ubuntu-codex was configured with a GitHub-only SSH identity copied from the working local Codex host key. Do not write private key material or passwords into handoff files.
• A newly generated Ubuntu-Codex-specific GitHub key was preserved as ~/.ssh/id_ed25519_ubuntu_codex_generated; it is not active unless added to GitHub later and referenced in ~/.ssh/config.
• Cloned the private Unreal project repo: git@github.com:pacificao/AgrarianGameBuild.git
• Clone target, matching the requested path spelling: /mnt/projects/AgrarianGameBulid
• Verification:
  • git status --short --branch returned clean main...origin/main.
  • git fetch --dry-run origin succeeded.
  • git push --dry-run origin HEAD succeeded with Everything up-to-date.
  • Git LFS hooks under .git/hooks are executable after changing CIFS file_mode to 0775.

Windows-Builder Tooling Setup - 2026-05-13

• Target toolchain for Agrarian Game build VM:
  • Unreal Engine 5.7
  • Visual Studio Community 2026
• Previously installed/verified:
  • VirtIO guest tools
  • QEMU guest agent
  • VirtIO network driver
• Installed Visual Studio Community 2026 from Microsoft stable 18.x bootstrapper:
  • Install path: C:\Program Files\Microsoft Visual Studio\2026\Community
  • Verified devenv.exe exists.
  • Verified MSVC toolchain exists at: C:\Program Files\Microsoft Visual Studio\2026\Community\VC\Tools\MSVC\14.51.36231
  • Workloads requested:
    • Microsoft.VisualStudio.Workload.NativeDesktop
    • Microsoft.VisualStudio.Workload.NativeGame
    • --includeRecommended for recommended SDK/tooling components.
• Installed Epic Games Launcher from official Epic MSI:
  • MSI cached on Unraid: /mnt/user/isos/EpicGamesLauncherInstaller.msi
  • Launcher verified at: C:\Program Files\Epic Games\Launcher\Portal\Binaries\Win64\EpicGamesLauncher.exe
• Git was intentionally skipped on Windows for now because ubuntu-codex manages the repository on /mnt/projects / \\DevBox\projects.
• Remaining manual/interactive step:
  • Log into Epic Games Launcher on Windows-Builder and install Unreal Engine 5.7. Epic does not provide a normal unauthenticated silent installer for launcher-managed Unreal Engine installs.

Windows-Builder disk expansion on 2026-05-13:

• User increased VM virtual disk from 100GB to 250GB.
• Windows Disk Management could not extend C: because the Windows Recovery partition was immediately after C:.
• Inside Windows:
  • Disabled WinRE with reagentc /disable.
  • Removed Disk 0 Partition 4, the small Recovery partition.
  • Extended C: to the supported maximum.
  • Re-enabled WinRE with reagentc /enable.
• Final state:
  • C: NTFS size: 268207894528 bytes, roughly 249.8GB.
  • Free space immediately after expansion: 206745464832 bytes, roughly 192.6GB.
  • WinRE status: enabled, now located under partition 3 / C:.

Agrarian Game Build Lane And Input Setup - 2026-05-13/14

• Current Unreal project checkout: /mnt/projects/AgrarianGameBulid
• Windows share path: \\DevBox\projects\AgrarianGameBulid
• Windows-Builder P: drive: P: is mapped to \\DevBox\projects for the Windows nathan user. P:\AgrarianGameBulid\AgrarianGame.uproject was verified.
• Persistent Windows mapping support:
  • Scheduled task: MapDevBoxProjectsPLogon
  • Script: C:\Temp\map-p-drive.cmd
  • Log: C:\Temp\map-p-drive.log
• Codex Windows helper: /home/nathan/bin/winbuilder
  • Uses Unraid QEMU guest agent to run Windows commands.
  • Requires UNRAID_PASSWORD in the environment.
  • Do not write the password into scripts or handoff files.
• Codex Unreal build helper: /home/nathan/bin/agrarian-build-editor
  • Verified successful after latest input asset changes.

Repo commit completed:

744b3c3 Add interact input assets

That commit includes:

• Scripts/RunUnrealPython-Windows.bat
• Scripts/setup_interact_input.py
• Scripts/verify_interact_input.py
• Content/Input/Actions/IA_Interact.uasset
• updated Content/Input/IMC_Default.uasset
• updated Content/ThirdPerson/Blueprints/BP_ThirdPersonCharacter.uasset
• updated AGRARIAN_DEVELOPMENT_ROADMAP.md

Completed roadmap item:

• Created IA_Interact.
• Bound IA_Interact to E.
• Bound IA_Interact to Gamepad_FaceButton_Left.
• Assigned IA_Interact to BP_ThirdPersonCharacter.InteractAction.
• Verified the saved assets with a fresh Unreal command-mode load using Scripts/verify_interact_input.py.
• Verified AgrarianGameEditor Win64 Development still builds through the Codex headless Windows build lane.

Next roadmap item:

• Create item definition assets for wood, stone, fiber, food, meat, hide, and primitive structure parts.

Agrarian Item Definition Assets - 2026-05-13/14

Completed the item definition asset roadmap item.

Added scripts:

• Scripts/setup_item_definitions.py
• Scripts/verify_item_definitions.py

Created data assets under:

/Game/Agrarian/DataAssets/Items

Created item definitions:

• DA_Item_Wood / wood
• DA_Item_Stone / stone
• DA_Item_Fiber / fiber
• DA_Item_Food / food
• DA_Item_Meat / meat
• DA_Item_Hide / hide
• DA_Item_PrimitiveFrame / primitive_frame
• DA_Item_PrimitiveWallPanel / primitive_wall_panel
• DA_Item_PrimitiveRoofPanel / primitive_roof_panel

Verification:

• Scripts/verify_item_definitions.py passed in Unreal command mode from a fresh editor load.
• /home/nathan/bin/agrarian-build-editor succeeded after the new assets.

Roadmap:

• AGRARIAN_DEVELOPMENT_ROADMAP.md now marks the item definition asset task complete.

Git:

• These item definition changes are not committed yet as of this handoff note.

Next roadmap item:

• Create recipe data assets for campfire, primitive shelter, basic tool, and bandage.

Agrarian Recipe Data Assets - 2026-05-13/14

Completed the recipe data asset roadmap item.

Added scripts:

• Scripts/setup_recipe_definitions.py
• Scripts/verify_recipe_definitions.py

Created recipe data assets under:

/Game/Agrarian/DataAssets/Recipes

Created recipes:

• DA_Recipe_Campfire / campfire
• DA_Recipe_PrimitiveShelter / primitive_shelter
• DA_Recipe_BasicTool / basic_tool
• DA_Recipe_Bandage / bandage

Verification:

• Scripts/verify_recipe_definitions.py passed in Unreal command mode from a fresh editor load.
• /home/nathan/bin/agrarian-build-editor succeeded after the new assets.

Roadmap:

• AGRARIAN_DEVELOPMENT_ROADMAP.md now marks the recipe data asset task complete.
• Primitive tool, campfire, shelter, and bandage recipe line items are marked complete under Primitive Crafting.
• Added a follow-up item to create item definition assets for craft result items: campfire, primitive shelter, basic tool, and bandage.

Git:

• These item and recipe asset changes are not committed yet as of this handoff note.

Next roadmap item:

• Create item definition assets for craft result items, then create Blueprint child actors for wood resource, campfire, primitive shelter, and first wildlife species.

Agrarian Crafted Result Items And Playable Blueprints - 2026-05-13/14

Completed the next roadmap item after recipe data assets.

Extended item definition scripts:

• Scripts/setup_item_definitions.py
• Scripts/verify_item_definitions.py

Added crafted result item definitions:

• DA_Item_Campfire / campfire
• DA_Item_PrimitiveShelter / primitive_shelter
• DA_Item_BasicTool / basic_tool
• DA_Item_Bandage / bandage

Added Blueprint helper scripts:

• Scripts/setup_playable_blueprints.py
• Scripts/verify_playable_blueprints.py

Created Blueprint child actors:

• /Game/Agrarian/Blueprints/Resources/BP_WoodResourceNode
• /Game/Agrarian/Blueprints/Structures/BP_Campfire
• /Game/Agrarian/Blueprints/Structures/BP_PrimitiveShelter
• /Game/Agrarian/Blueprints/Wildlife/BP_RabbitWildlife

Verification:

• Scripts/verify_item_definitions.py passed in Unreal command mode from a fresh editor load.
• Scripts/verify_playable_blueprints.py passed in Unreal command mode from a fresh editor load.
• /home/nathan/bin/agrarian-build-editor succeeded after the new assets.

Roadmap:

• AGRARIAN_DEVELOPMENT_ROADMAP.md now marks crafted result item definitions and first playable Blueprint child actors complete.

Git:

• These item, recipe, and Blueprint asset changes are not committed yet as of this handoff note.

Next roadmap item:

• Place the wood resource node, campfire, primitive shelter, and rabbit wildlife Blueprint in the test map.

Codex Local Session Config - 2026-05-13/14

Local Codex config was updated at:

/home/nathan/.codex/config.toml

Current important setting:

sandbox_mode = "danger-full-access"

Reason:

• The current session repeatedly hit: bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted
• New/resumed trusted sessions should avoid the broken Linux sandbox wrapper while keeping normal approval prompts active.
• This is not the full approval/sandbox bypass mode.

Security note:

• Do not store plaintext passwords, private SSH keys, Mailgun/API secrets, or Unraid/Windows login passwords in handoff files.

Agrarian Test Map Placements - 2026-05-13/14

Completed the next roadmap item after playable Blueprint child actors.

Added editor automation helper:

• Source/AgrarianGame/AgrarianEditorAutomationLibrary.h
• Source/AgrarianGame/AgrarianEditorAutomationLibrary.cpp

Purpose:

• Exposes SpawnActorInEditorWorld for Unreal Python setup scripts.
• Bypasses Unreal's viewport-backed editor placement path, which crashed in command-mode -NullRHI while spawning actors.
• Source/AgrarianGame/AgrarianGame.Build.cs adds UnrealEd only for editor builds.

Added placement scripts:

• Scripts/setup_test_map_placements.py
• Scripts/verify_test_map_placements.py

Placed actors in /Game/ThirdPerson/Lvl_ThirdPerson:

• AGR_WoodResourceNode_01
• AGR_Campfire_01
• AGR_PrimitiveShelter_01
• AGR_RabbitWildlife_01

Verification:

• Scripts/verify_test_map_placements.py passed in Unreal command mode from a fresh editor load.
• /home/nathan/bin/agrarian-build-editor succeeded after the map placement and helper code changes.

Roadmap:

• Test map placement item is complete.
• Near-term placement/test items for wood resource, campfire, primitive shelter, and rabbit wildlife are complete.

Git:

• These map placement and helper-code changes are not committed yet as of this handoff note.

Next roadmap item:

• Run the first full gather -> inventory -> craft -> place shelter -> save/load loop.

Agrarian Playable Loop Smoke Test - 2026-05-13/14

Completed the next roadmap item after test map placement.

Updated editor automation:

• Extended Source/AgrarianGame/AgrarianEditorAutomationLibrary.h
• Extended Source/AgrarianGame/AgrarianEditorAutomationLibrary.cpp

Added verification script:

• Scripts/verify_playable_loop_smoke.py

What the smoke test covers:

• Loads /Game/ThirdPerson/Lvl_ThirdPerson.
• Finds placed AGR_WoodResourceNode_01.
• Spawns a test BP_ThirdPersonCharacter.
• Gathers wood through the real interactable resource node path.
• Seeds only currently-unobtainable primitive shelter ingredients.
• Crafts primitive_shelter through UAgrarianCraftingComponent.
• Places BP_PrimitiveShelter through UAgrarianBuildingPlacementComponent.
• Captures persistent actor state from UAgrarianPersistentActorComponent.
• Restores captured primitive shelter actors from saved state data.

Verification:

• /home/nathan/bin/agrarian-build-editor succeeded after helper changes.
• Scripts/verify_playable_loop_smoke.py passed in Unreal command mode: PASS: gathered wood 0->2, crafted primitive_shelter, placed shelter, saved 2 persistent actor(s), restored 2 actor(s).

Roadmap:

• Gather -> inventory -> craft -> place shelter -> save/load data smoke loop is complete.
• Added follow-up item to make primitive shelter ingredients naturally obtainable in normal play.
• Added follow-up item for a later PIE/server persistence test using UAgrarianPersistenceSubsystem with a live GameInstance.

Git:

• These playable-loop smoke test changes are not committed yet as of this handoff note.

Next roadmap item:

• Test wildlife damage/death/harvest loop.

Agrarian Wildlife Damage/Harvest Smoke Test - 2026-05-14

Completed the next roadmap item after the playable loop smoke test.

Added verification script:

• Scripts/verify_wildlife_loop.py

What the smoke test covers:

• Loads /Game/ThirdPerson/Lvl_ThirdPerson.
• Finds placed AGR_RabbitWildlife_01.
• Spawns a test BP_ThirdPersonCharacter.
• Applies nonlethal wildlife damage and verifies the rabbit enters fleeing state.
• Applies lethal wildlife damage and verifies the rabbit is dead.
• Harvests the dead rabbit.
• Verifies meat and hide are added to the character inventory.
• Verifies the rabbit cannot be harvested twice.

Verification:

• Scripts/verify_wildlife_loop.py passed in Unreal command mode: PASS: wildlife damage/death/harvest verified health 12.0->11.0->0, meat 0->1, hide 0->1.

Roadmap:

• Wildlife damage/death/harvest loop is complete.
• Wildlife damage task is complete.

Git:

• These wildlife smoke test changes are not committed yet as of this handoff note.

Next roadmap item:

• Make all primitive shelter ingredients obtainable through normal play.

Agrarian Natural Primitive Shelter Ingredient Loop - 2026-05-14

Completed the next roadmap item after wildlife damage/death/harvest testing.

Added recipe assets:

• DA_Recipe_PrimitiveFrame
• DA_Recipe_PrimitiveWallPanel
• DA_Recipe_PrimitiveRoofPanel

Added gather path:

• BP_FiberResourceNode
• Placed AGR_FiberResourceNode_01 in /Game/ThirdPerson/Lvl_ThirdPerson

Updated existing playable assets:

• Wood resource node now has enough harvests for a full primitive shelter loop.
• Rabbit wildlife now yields 2 hide so one rabbit satisfies the shelter recipe.

Updated automation:

• Added RunNaturalShelterLoopSmokeTest to UAgrarianEditorAutomationLibrary.
• Updated Scripts/verify_playable_loop_smoke.py so it no longer seeds missing shelter ingredients. It gathers wood, gathers fiber, harvests hide, crafts primitive frame/wall/roof parts, crafts primitive_shelter, places it, and verifies save/restore state.

Verification:

• Scripts/verify_recipe_definitions.py passed.
• Scripts/verify_playable_blueprints.py passed.
• Scripts/verify_test_map_placements.py passed.
• Scripts/verify_playable_loop_smoke.py passed: PASS: naturally gathered wood=26 fiber=24 hide=2, crafted parts 2/4/2, crafted and placed primitive_shelter, saved 2 persistent actor(s), restored 2 actor(s).
• Scripts/verify_wildlife_loop.py passed after the hide-yield change: PASS: wildlife damage/death/harvest verified health 12.0->11.0->0, meat 0->1, hide 0->2.

Roadmap:

• Natural primitive shelter ingredients are complete.
• Fiber resource is complete.
• Primitive shelter structure part recipes are complete.

Git:

• These natural shelter loop changes are not committed yet as of this handoff note.

Next roadmap item:

• Add a PIE/server persistence test that exercises UAgrarianPersistenceSubsystem with a live GameInstance.

Agrarian Live GameInstance Persistence Automation - 2026-05-14

Completed the next roadmap item after the natural primitive shelter ingredient loop.

Added native Unreal automation:

• Source/AgrarianGame/AgrarianPersistenceAutomationTest.cpp
• Test name: Agrarian.PersistenceSubsystem.LiveGameInstance

Updated editor automation:

• Added RunPersistenceSubsystemSmokeTest to UAgrarianEditorAutomationLibrary.
• The smoke test uses the live UAgrarianPersistenceSubsystem, a temporary save slot named AgrarianAutomationPersistence, registers the primitive_shelter actor class, saves a spawned shelter, reloads the save, restores the actor, verifies the counts, and deletes the temporary save slot.

Verification:

• /home/nathan/bin/agrarian-build-editor passed.
• Unreal automation passed with: Automation RunTests Agrarian.PersistenceSubsystem.LiveGameInstance
• Result: PASS: live persistence subsystem saved 1 actor(s), restored 1 actor(s), world now has 1 persistent actor(s).

Implementation note:

• The first test used /Game/ThirdPerson/Lvl_ThirdPerson; the subsystem check passed, but command-mode PIE marked the test failed because that world-partition map emits a handled editor viewport ensure in headless mode. The final test creates a blank transient editor map before starting PIE so the result reflects the persistence subsystem only.

Roadmap:

• Live GameInstance persistence test is complete.

Git:

• These persistence automation changes are not committed yet as of this handoff note.

Next roadmap item:

• Decide whether to keep the current template variants or remove unused starter variants.

Agrarian Earth-Scale Terrain And Tile Roadmap Direction - 2026-05-14

The roadmap was updated with the long-term terrain/tile direction before moving to the next implementation task.

User direction captured:

• Agrarian should eventually support real-world terrain at very large scale.
• Terrain tile unit is 1 km x 1 km.
• Full Earth-scale coverage implies roughly 510-520 million possible tiles.
• Tiles should be generated and added over many years, not all at once.
• Tiles should be served from a server, cached locally, scrubbed when unused for a configured amount of time, and redownloaded if a player returns.
• Terrain height, ocean depth, mountains, hills, rivers, biomes, and natural resources should be derived from real-world data where practical.
• Travel should use believable real-world pacing for humans, animals, boats, tractors, cars, horses, etc., modified by age, condition, strength, endurance, terrain, fatigue, carried weight, hunger/thirst, and injury.
• Need to choose one "Ground Zero" 1 km x 1 km MVP tile and use it to prove automated terrain import, tile tracking, stitching, and World Partition placement.

Roadmap changes:

• Reordered the roadmap so Phase 0 comes before Version .01 / 0.01.
• Added Phase 0.7 Earth-Scale Terrain Architecture.
• Added Ground Zero MVP tile tasks to Phase 0.5, Phase 1.4, and near-term actions.
• Added tile registry/database tasks for a future 510-520 million tile registry.
• Added real terrain, bathymetry, river/coastline, biome, natural resource, cache, streaming, scrubber, and tile QA tasks.
• Immediate next item is now: Choose Ground Zero 1 km MVP tile and define first tile registry schema.

Verification:

• Documentation-only update; no build/test run required.

Agrarian Ground Zero Tile And Registry Schema - 2026-05-14

Completed the roadmap item to choose the Ground Zero 1 km MVP tile and define the first tile registry schema.

Ground Zero:

• Location: Linda Mar / San Pedro Valley edge in Pacifica, California.
• Tile ID: gz_us_ca_pacifica_utm10n_e544_n4160
• Projection for prototype: WGS84 / UTM zone 10N
• Bounds:
  • Easting: 544000-545000
  • Northing: 4160000-4161000
• Nominal center:
  • Latitude: 37.5925
  • Longitude: -122.4995
• Working biome: coastal_california_scrub_woodland

Files added:

• Docs/Terrain/GroundZeroTile.md
• Docs/Terrain/TileRegistrySchema.md
• Data/Tiles/tile_registry.schema.json
• Data/Tiles/ground_zero_tiles.json
• Data/Tiles/tile_registry.sql

Registry seed:

• Includes the Ground Zero tile plus all eight adjacent placeholder neighbors.
• Tracks candidate source categories for elevation, hydrography, bathymetry, and land cover.
• Separates terrain tile registry state from player-made world persistence.

Validation:

• JSON syntax validated for both registry files.
• Sanity check verified 9 tiles, 1 km tile size, and Ground Zero neighbor references.
• SQL schema executed successfully in an in-memory SQLite database.

Roadmap:

• Ground Zero selection is complete.
• First tile registry schema is complete.
• MVP tile metadata/registry prototype is complete.

Next roadmap item:

• Prototype real terrain import for the selected MVP tile.

Agrarian Ground Zero Terrain Import Prototype - 2026-05-14

Completed the roadmap item to prototype real terrain import for the selected MVP tile.

Added:

• Scripts/prototype_ground_zero_terrain.py
• Docs/Terrain/TerrainImportPrototype.md

Generated:

• Data/Terrain/Generated/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_elevation_samples_33.csv
• Data/Terrain/Generated/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_heightmap_33.r16
• Data/Terrain/Generated/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_terrain_metadata.json

Generation result:

• Source: USGS Elevation Point Query Service.
• Sample grid: 33 x 33.
• Sample count: 1,089.
• Spacing: 31.25 m.
• Elevation range: 3.458832026m to 96.11089325m.
• USGS reported raster ID: 65833.
• USGS reported resolution: 1m.

Validation:

• Terrain metadata JSON parses cleanly.
• Tile registry JSON parses cleanly after generation.
• CSV has 1 header row plus 1,089 sample rows.
• R16 size is 2,178 bytes, matching 33 * 33 * 2.
• Ground Zero tile registry status is now generated with generation_version=1.

Roadmap:

• Real terrain import prototype is complete.
• Real elevation terrain base is marked in progress.

Next roadmap item:

• Define acceptable real terrain accuracy and final DEM/lidar source requirements for the MVP tile.

Agrarian Terrain Accuracy And Source Requirements - 2026-05-14

Completed the roadmap item to define acceptable real terrain accuracy and final DEM/lidar source requirements for the Ground Zero MVP tile.

Added:

• Docs/Terrain/TerrainAccuracyRequirements.md

Updated:

• Data/Tiles/ground_zero_tiles.json
  • Keeps USGS Elevation Point Query Service as the confirmed prototype source.
  • Adds USGS 3DEP 1-meter DEM / Seamless 1-Meter DEM as the MVP target elevation source.
  • Adds NOAA/NCEI coastal DEM or Coastal Relief Model as the MVP coastal or bathymetry target source if the tile area requires it.

Requirements now defined:

• Tier 0 current prototype.
• Tier 1 MVP required accuracy.
• Tier 2 preferred post-MVP accuracy.
• Final ground elevation source priority.
• Coastal and bathymetry source priority.
• Unreal import metadata requirements.
• MVP terrain acceptance tests.
• Known gaps in the current 33 x 33 point-sampled prototype.

Validation:

• python3 -m json.tool Data/Tiles/ground_zero_tiles.json passed.

Roadmap:

• Real terrain accuracy requirements are complete.
• Bathymetry/ocean-depth handling requirements are complete.
• Real-world terrain source evaluation is complete.

Next roadmap item:

• Acquire or extract the final USGS 3DEP DEM/lidar source for the Ground Zero tile.

Agrarian USGS 3DEP DEM Acquisition And Extraction - 2026-05-14

Completed the roadmap item to acquire/extract the final USGS 3DEP DEM/lidar source for the Ground Zero tile.

Installed free geospatial packages on pacificao-dev:

• gdal-bin
• python3-gdal
• python3-rasterio

Added:

• Scripts/acquire_ground_zero_dem.py
• Scripts/extract_ground_zero_dem_subset.py
• Docs/Terrain/DemAcquisition.md

Source products:

• USGS 1 Meter 10 x54y416 CA_CaliforniaGaps_B23
• USGS 1 Meter 10 x54y417 CA_CaliforniaGaps_B23
• Dataset: Digital Elevation Model (DEM) 1 meter
• Publication date: 2025-08-20
• Format: GeoTIFF

Ground Zero sits on a 3DEP 10 km tile boundary, so both products are required.

Files:

• Data/Terrain/Sources/gz_us_ca_pacifica_utm10n_e544_n4160/USGS_1M_10_x54y416_CA_CaliforniaGaps_B23.tif
• Data/Terrain/Sources/gz_us_ca_pacifica_utm10n_e544_n4160/USGS_1M_10_x54y417_CA_CaliforniaGaps_B23.tif
• Data/Terrain/Sources/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_tnm_1m_dem_product.json
• Data/Terrain/Extracted/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_1m_dem_subset.tif
• Data/Terrain/Extracted/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_1m_dem_subset_metadata.json

Validation:

• gdalinfo reports extracted subset size 1000 x 1000.
• Pixel size is 1.0m x 1.0m.
• CRS is EPSG:26910 / NAD83 UTM zone 10N.
• Bounds are E 544000-545000, N 4160000-4161000.
• Metadata JSON parses cleanly.
• Tile registry source metadata validates with status=source_data_found, coverage_status=confirmed, and local source folder populated.

Roadmap:

• USGS 3DEP DEM acquisition/extraction is complete.

Next roadmap item:

• Convert the extracted 1-meter DEM subset into an Unreal Landscape-ready heightmap and import plan.

Agrarian Unreal-Ready Ground Zero Heightmap - 2026-05-14

Completed the roadmap item to convert the extracted 1-meter DEM subset into an Unreal Landscape-ready heightmap and import plan.

Added:

• Scripts/convert_ground_zero_dem_to_unreal_heightmap.py
• Docs/Terrain/UnrealLandscapeImportPlan.md

Generated:

• Data/Terrain/Unreal/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_unreal_1009.r16
• Data/Terrain/Unreal/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_unreal_1009_preview.pgm
• Data/Terrain/Unreal/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_unreal_heightmap_metadata.json

Notes:

• Optional PNG output was skipped because Pillow is not installed.
• The .r16 is the Unreal import target.

Import settings:

• Heightmap resolution: 1009 x 1009
• X scale: 99.2063492063492 cm
• Y scale: 99.2063492063492 cm
• Z scale: 18.22824631817639 cm
• Elevation range: 3.176246404647827m to 96.50486755371094m
• Z offset guidance: 3.176246404647827m

Validation:

• Metadata JSON parses cleanly.
• R16 byte size is 2,036,162, matching 1009 * 1009 * 2.
• Metadata confirms 1009 x 1009 resolution and expected Unreal scale values.

Roadmap:

• Unreal Landscape-ready heightmap/import plan is complete.

Next roadmap item:

• Import the Ground Zero R16 heightmap into an Unreal terrain test map.

Agrarian Ground Zero Unreal Terrain Map Import - 2026-05-14

Completed the roadmap item to import the Ground Zero R16 heightmap into an Unreal terrain test map.

Corrected final import settings:

• Heightmap encoding: unreal_landscape_midpoint_32768_sea_level
• Heightmap resolution: 1009 x 1009
• X scale: 99.2063492063492 cm
• Y scale: 99.2063492063492 cm
• Z scale: 100.0 cm
• Z offset: 0.0 m
• Elevation range: 3.176246404647827m to 96.50486755371094m

Added:

• UAgrarianEditorAutomationLibrary::ImportLandscapeHeightmapIntoEditorWorld
• Unreal Landscape module dependency
• Scripts/setup_ground_zero_terrain_map.py
• Scripts/verify_ground_zero_terrain_map.py

Generated/saved:

• /Game/Agrarian/Maps/L_GroundZeroTerrain_Test
• Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap

Validation:

• UNRAID_PASSWORD=... /home/nathan/bin/agrarian-build-editor succeeds.
• setup_ground_zero_terrain_map.py imports AGR_GroundZero_Landscape.
• verify_ground_zero_terrain_map.py passes.
• Verified landscape scale is (99.206352, 99.206352, 100.0).
• Verified X/Y bounds extent is about 50000 cm, so the terrain spans 100000 cm / 1000 m.
• Verified bounds origin is centered near XY zero.

Operational note:

• Unreal Build Accelerator hung during the first compile attempt, so Scripts/BuildEditor-Windows.bat now passes -NoUBA.

Roadmap:

• Ground Zero R16 terrain map import is complete.
• Terrain base and 1 km scale verification are complete.

Next roadmap item:

• Add first-pass water depth/shoreline handling if applicable.

Agrarian Ground Zero Investor Demo Package - 2026-05-14

Completed the first Windows Development packaged investor demo setup.

What changed:

• Project default game and editor startup map now point to the Ground Zero terrain test map: /Game/Agrarian/Maps/L_GroundZeroTerrain_Test.L_GroundZeroTerrain_Test.
• Packaging settings cook the Ground Zero map and keep the original ThirdPerson map available as a fallback/reference.
• Added repeatable packaging wrapper: Scripts/PackageWindowsDevelopment.bat.
• Added Ground Zero demo setup script: Scripts/setup_ground_zero_demo_map.py.
• The setup script placed demo-ready actors on the real Ground Zero terrain: player start, wood node, fiber node, campfire, primitive shelter, rabbit, directional light, skylight, and fog.
• Added splash asset: Content/Splash/Splash.bmp.
• Added investor demo notices: Docs/Legal/InvestorDemoNotices.md.

Build output:

• Packaged executable: Builds/WindowsDevelopment/AgrarianGame.exe.
• Larger runtime executable: Builds/WindowsDevelopment/AgrarianGame/Binaries/Win64/AgrarianGame.exe.
• Packaged output size was about 1.1G.
• Builds/ is now ignored so packaged artifacts are not accidentally committed.

Verification:

• Windows-Builder packaging completed with BUILD SUCCESSFUL.
• Smoke launched the packaged executable with -nullrhi -nosound -unattended.
• Runtime log confirmed browse/load into: /Game/Agrarian/Maps/L_GroundZeroTerrain_Test?Name=Player.
• Runtime log confirmed the game mode remained BP_ThirdPersonGameMode_C.
• Runtime log exited cleanly after the smoke command.

Next roadmap item:

• Use the packaged demo as the investor baseline, then continue with Ground Zero visual/gameplay polish: shoreline/water if needed, biome-appropriate resources, simple HUD/debug display, and first playable survival tuning.

Agrarian Investor Demo Launch Fix - 2026-05-14

User reported the investor package would not open/run.

Diagnosis:

• The packaged build itself was valid, but the normal graphics launch path crashed when started through the Unraid/QEMU guest-agent helper.
• Failure in runtime log: DXGI_ERROR_NOT_CURRENTLY_AVAILABLE during swapchain creation.
• The same issue occurred with both D3D12 and D3D11 when launched as SYSTEM through QEMU guest agent.
• query user on Windows-Builder showed the nathan Windows session was disconnected, so this headless QEMU launch is not representative of a real interactive desktop demo.

Fix implemented:

• Kept the main project default DX12-first in Config/DefaultEngine.ini.
• Added Windows package override: Config/Windows/WindowsEngine.ini with DefaultGraphicsRHI=DefaultGraphicsRHI_DX11.
• The packaged investor build now defaults to DX11 compatibility mode while still cooking both D3D12 SM6 and D3D11 SM5 shader formats.
• Added:
  • Scripts/InstallWindowsDemoLaunchers.bat
  • Start Agrarian Demo.cmd
  • Start Agrarian Demo - DX12.cmd
  • Start Agrarian Demo - Compatibility DX11.cmd
  • Install Prerequisites.cmd
  • README-Investor-Demo.txt
• The package includes Microsoft VC++ runtime installer at: Engine/Extras/Redist/en-us/vc_redist.x64.exe.

Rebuilt package:

• Output: Builds/WindowsDevelopment.
• Package size remains about 1.1G.
• Rebuild completed successfully after clearing an old locked package artifact.

Important demo instruction:

• Investors should keep/copy the entire WindowsDevelopment folder together and start with Start Agrarian Demo.cmd.
• If the demo does not open, run Install Prerequisites.cmd, then Start Agrarian Demo - Compatibility DX11.cmd.
• Start Agrarian Demo - DX12.cmd is included for DX12-specific testing.

Agrarian Startup Movie And Demo Notice - 2026-05-14

Added the first investor-facing launch sequence.

Startup movie:

• Installed free ffmpeg on this machine to generate the movie.
• Added movie asset: Content/Movies/AgrarianStudioIntro.mp4.
• Duration: 6.0 seconds.
• Resolution: 1280 x 720.
• The first and primary line is the motto: What survives after you are gone?
• The movie also shows:
  • AGRARIAN STUDIO
  • Investor Demo v0.01 - Beta Prototype
  • Copyright (c) 2026 Agrarian Studio. All rights reserved.
• Configured startup movie in Config/DefaultGame.ini: +StartupMovies=AgrarianStudioIntro.

In-game demo notice:

• Added runtime UI classes:
  • UAgrarianDemoNoticeWidget
  • AAgrarianDemoNoticeActor
• setup_ground_zero_demo_map.py now places AGR_DemoNoticeActor in the Ground Zero map.
• Notice shows motto, Investor Demo v0.01, beta prototype/non-distribution language, and copyright for the first few seconds of gameplay.

Packaging/build notes:

• Added *.mp4 to Git LFS attributes.
• Updated Scripts/PackageWindowsDevelopment.bat so package builds compile targets explicitly with Build.bat ... -NoUBA, then run UAT with -skipbuild. This avoids the UAT/UBA hang seen during packaging.
• Rebuilt the Windows Development investor package successfully.
• Verified packaged movie exists at: Builds/WindowsDevelopment/AgrarianGame/Content/Movies/AgrarianStudioIntro.mp4.
• Headless -nullrhi smoke test loaded the Ground Zero map and exited cleanly.

Agrarian Ground Zero Water/Shoreline Pass - 2026-05-14

Completed the next roadmap item:

• Add first-pass water depth/shoreline handling if applicable.

Added:

• Scripts/analyze_ground_zero_water.py
• Docs/Terrain/GroundZeroWaterShoreline.md
• Data/Terrain/Analysis/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_water_shoreline_analysis.json

Result:

• The current Ground Zero tile does not contain ocean water or shoreline inside the 1 km tile bounds.
• DEM minimum elevation is about 3.16 m.
• Sea-level or below samples: 0.
• Near-sea-level samples at <= 2.0 m: 0.
• Low coastal samples at <= 5.0 m: 57,812 / 1,000,000.
• North and west edges contain the lowest coastal-influenced terrain.

Decision:

• Do not place an ocean plane in the current Ground Zero tile.
• Do not fake bathymetry in this tile.
• Keep NOAA/NCEI bathymetry/coastal DEM work for west/southwest neighbor tiles when coastal/ocean tiles come into scope.
• Add a gameplay freshwater source in a later map pass.

Roadmap:

• Marked first-pass water depth/shoreline handling complete.
• Immediate next item is first-pass hill, mountain, river, stream, lake, and coastline/absence handling from the Ground Zero terrain data.

Agrarian Ground Zero Landform Pass - 2026-05-14

Completed the next roadmap item:

• Add first-pass hill, mountain, river, stream, lake, and coastline handling if present in Ground Zero.

Added:

• Scripts/analyze_ground_zero_landforms.py
• Docs/Terrain/GroundZeroLandforms.md
• Data/Terrain/Analysis/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_landform_analysis.json

Result:

• Hills are present in the Ground Zero tile.
• Mountains are not present; max elevation is 96.51 m, p95 elevation is 54.57 m.
• Steep slopes are present; max slope is 53.62 deg, p95 slope is 26.95 deg.
• River, confirmed stream, lake, and coastline are not present from this DEM-only pass.
• DEM shape suggests drainage/freshwater search candidates, but those need hydrography validation before being treated as real streams.
• First-pass walkable/buildable terrain: 83.42%.
• First-pass difficult/slow-travel terrain: 16.58%.
• Possible drainage/freshwater search zone: 17.30%.

Decision:

• Use the landform analysis for first-pass movement modifiers, buildability, resource placement, and foliage density.
• Do not add fake mountains, lakes, rivers, streams, or coastline inside the current tile.
• Validate freshwater candidates against a real hydrography source later.

Roadmap:

• Marked first-pass hill/mountain/river/stream/lake/coastline handling complete.
• Immediate next item is to verify neighboring tile edge coordinates against the registry before multi-tile stitching.

Agrarian Ground Zero Neighbor Edge Verification - 2026-05-14

Completed the next roadmap item:

• Verify neighboring tile edge coordinates against the registry before multi-tile stitching.

Added:

• Scripts/verify_ground_zero_neighbor_edges.py
• Docs/Terrain/GroundZeroNeighborEdges.md
• Data/Terrain/Analysis/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_neighbor_edge_verification.json

Result:

• Verification passed.
• Verified tile count: 9.
• Found neighbor count: 8.
• Missing neighbors: 0.
• All tiles use exact 1000 m x 1000 m UTM bounds.
• All tile IDs match their minimum UTM kilometer coordinates.
• North, south, east, and west neighbors share exact full 1 km edges with Ground Zero.
• Northeast, southeast, southwest, and northwest neighbors touch Ground Zero at corners only.

Decision:

• The registry is ready for coordinate-based neighbor stitching around Ground Zero.
• This only verifies registry bounds and adjacency. Elevation seam continuity still needs neighbor DEM extraction/generation before real stitched terrain.

Roadmap:

• Marked neighbor edge coordinate verification complete.
• Immediate next item is the Ground Zero foliage pass.

Agrarian Ground Zero Foliage Pass - 2026-05-14

Completed the next roadmap item:

• Add foliage pass.

Added:

• AAgrarianFoliagePatch
• Scripts/verify_ground_zero_foliage.py
• Docs/Terrain/GroundZeroFoliagePass.md

Updated:

• Scripts/setup_ground_zero_demo_map.py
• Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap

Result:

• Ground Zero now has one deterministic first-pass foliage actor: AGR_GroundZeroFoliage_FirstPass.
• The actor uses hierarchical instanced static mesh components for first-pass rendering efficiency.
• Foliage instance counts:
  • Trees: 42
  • Shrubs: 96
  • Grass clumps: 180
• Placement is terrain-height-aware and avoids the player start, demo structures, resource nodes, and wildlife spawn.

Validation:

• UNRAID_PASSWORD=... /home/nathan/bin/agrarian-build-editor succeeded.
• Scripts/RunUnrealPython-Windows.bat Scripts/setup_ground_zero_demo_map.py succeeded.
• Scripts/RunUnrealPython-Windows.bat Scripts/verify_ground_zero_foliage.py succeeded and confirmed 42 trees, 96 shrubs, and 180 grass clumps.

Roadmap:

• Marked foliage pass complete.
• Immediate next item is biome-appropriate natural resources based on Ground Zero.

Agrarian Ground Zero Biome Resource Pass - 2026-05-14

Completed the next roadmap item:

• Add biome-appropriate natural resources based on Ground Zero.

Added:

• BP_StoneResourceNode
• Scripts/verify_ground_zero_resources.py
• Docs/Terrain/GroundZeroResourcePass.md

Updated:

• Scripts/setup_playable_blueprints.py
• Scripts/verify_playable_blueprints.py
• Scripts/setup_ground_zero_demo_map.py
• Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap

Result:

• Ground Zero now has biome-appropriate natural resource nodes for the selected coastal California scrub/woodland tile.
• Resource node counts:
  • Wood: 4
  • Fiber: 5
  • Stone: 4
• Wood nodes are placed in scrub/woodland and hillside areas.
• Fiber nodes are placed in grassland, scrub, and drainage-candidate areas.
• Stone nodes are placed on slope, exposed-terrain, and valley-edge areas.
• Freshwater intentionally remains separate because the next roadmap item is Add water source.

Validation:

• Scripts/RunUnrealPython-Windows.bat Scripts/setup_playable_blueprints.py succeeded and created/configured BP_StoneResourceNode.
• Scripts/RunUnrealPython-Windows.bat Scripts/verify_playable_blueprints.py succeeded.
• Scripts/RunUnrealPython-Windows.bat Scripts/setup_ground_zero_demo_map.py succeeded.
• Scripts/RunUnrealPython-Windows.bat Scripts/verify_ground_zero_resources.py succeeded and confirmed 4 wood, 5 fiber, and 4 stone nodes.

Roadmap:

• Marked biome-appropriate natural resources complete.
• Immediate next item is to add a water source.

Agrarian Ground Zero Freshwater Source - 2026-05-14

Completed the next roadmap item:

• Add water source.

Added:

• AAgrarianWaterSource
• BP_FreshWaterSource
• Scripts/verify_ground_zero_water_source.py
• Docs/Terrain/GroundZeroWaterSource.md

Updated:

• Scripts/setup_playable_blueprints.py
• Scripts/verify_playable_blueprints.py
• Scripts/setup_ground_zero_demo_map.py
• Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap

Result:

• Ground Zero now has one gameplay freshwater source: AGR_GZ_FreshWaterSource_01.
• The water source uses /Game/Agrarian/Blueprints/World/BP_FreshWaterSource.
• It restores 45.0 thirst/water through UAgrarianSurvivalComponent::AddWater.
• Placement is in the drainage-candidate area and is a gameplay source, not a confirmed real hydrography feature.

Validation:

• UNRAID_PASSWORD=... /home/nathan/bin/agrarian-build-editor succeeded.
• Scripts/RunUnrealPython-Windows.bat Scripts/setup_playable_blueprints.py succeeded.
• Scripts/RunUnrealPython-Windows.bat Scripts/verify_playable_blueprints.py succeeded.
• Scripts/RunUnrealPython-Windows.bat Scripts/setup_ground_zero_demo_map.py succeeded.
• Scripts/RunUnrealPython-Windows.bat Scripts/verify_ground_zero_water_source.py succeeded.

Roadmap:

• Marked water source complete.
• Immediate next item is weather exposure zones if needed.

Agrarian Time And Real Weather Planning - 2026-05-14

Roadmap-only planning update before the next implementation item.

Added time/progression philosophy:

• Default target clock: 4 real hours = 1 in-game day.
• The world should not feel artificially sped up; the player gets better through skills, tools, infrastructure, cooperation, and knowledge.
• Skills should improve efficiency, yield, quality, reliability, survival odds, and capacity more than they shorten natural biological time.
• Crops, livestock, spoilage, disease, healing, tree growth, seasons, and other long-running systems use the Agrarian calendar.
• Early survival should remain difficult and hands-on, with hunting, gathering, fishing, scavenging, and primitive crafting available while domestication and farming mature over meaningful calendar time.

Added real-weather roadmap plan:

• Add a Ground Zero real-world weather provider adapter by latitude/longitude.
• Use Open-Meteo as the first global MVP source.
• Use NOAA/NWS as a US fallback or enrichment source where useful.
• Cache weather snapshots server-side; clients should not call public weather APIs directly.
• Map real weather inputs into Agrarian states: temperature, precipitation, wind, cloud cover, humidity, pressure, visibility, and weather code.
• Keep deterministic fallback weather simulation when external data is unavailable.

Agrarian Roadmap Reordering - 2026-05-14

Reworked the roadmap structure so it flows in order:

• Project North Star and time/progression philosophy.
• Current milestone status: Version 0.01 Foundation Baseline.
• Phase 0 foundation and guardrails.
• Phase 1 foundational survival MVP.
• Later gameplay/civilization phases.
• Cross-cutting technical tracks.
• Six-month calendar, MVP definition of done, and earliest next actions.

Removed the duplicated standalone Version .01 / 0.01 block that previously sat below 0.7, which made the roadmap look like it jumped backward in time. Version 0.01 is now summarized near the top as the active milestone, while workstream sections like 0.1, 0.2, and 0.7 remain inside Phase 0.

Updated the near-term next actions to restart from the earliest missed foundation items before continuing deeper gameplay/weather work.

Immediate next item:

• Create protected main branch.

Also added a new Storefront Development Distribution track covering Steam and Epic development-build launch planning, including Steamworks/Epic portal checklists, internal/investor/closed-test/public channels, build metadata, store branch naming, entitlement/account-linking requirements, and release checklists.

Note: gh is not installed and no GitHub token is available in the local environment, so GitHub branch protection cannot be applied from this host yet without adding/authenticating tooling or doing it through the GitHub UI.

Agrarian GitHub Branch Protection Check - 2026-05-14

Installed and authenticated GitHub CLI as pacificao.

Confirmed:

• Repo: pacificao/AgrarianGameBuild
• Visibility: private
• Local GitHub CLI permission: ADMIN
• Remote main branch exists.

Branch protection result:

• GitHub API returned HTTP 403.
• Message: Upgrade to GitHub Pro or make this repository public to enable this feature.
• No branch protection changes were applied.
• No billing, repository visibility, deletion, or paid setting changes were made.

Roadmap update:

• Marked Create protected main branch as blocked.
• Immediate next foundation item is deciding whether to create/use a long-lived dev branch.

Agrarian Repository Storage Guardrails - 2026-05-14

Completed storage guardrail work to keep GitHub free-tier viable as long as possible.

Added:

• Docs/RepositoryStoragePolicy.md
• Scripts/audit_repo_storage.sh

Policy:

• GitHub is for source, configs, scripts, docs, metadata, and curated project assets.
• Raw DEM/lidar/GIS datasets, packaged builds, generated terrain tile packages, DerivedDataCache, and large source-art archives stay on DevBox or future object storage.
• Git stores manifests, checksums, provenance, import scripts, and small curated samples when needed.

Cleanup:

• Removed two raw USGS DEM .tif files from Git tracking and local unpushed Git history.
• The raw files remain locally on DevBox under Data/Terrain/Sources/....
• Added ignore rules for raw terrain/source archives.
• Re-added the GitHub remote after git filter-repo removed it.

Audit result:

• Git object database pack after cleanup: about 5.65 MiB.
• Largest tracked non-LFS file: about 4.3 MB.
• Largest LFS object: about 21 MB.
• Generated/local folders remain large on DevBox, which is expected: Intermediate, Saved, Builds, and Binaries.

Branch decision:

• Decided not to create/use a long-lived dev branch yet.
• Current approach: main plus short-lived task branches until team size or release channels require a staging branch.
• Immediate next foundation item is finishing branch naming conventions.

Agrarian Branch Naming And Tile-Serving MVP Roadmap - 2026-05-14

Completed branch naming conventions for the current lightweight workflow.

Added:

• Docs/BranchingConventions.md

Policy:

• main remains the only long-lived development branch for now.
• Do not create a long-lived dev branch yet.
• Use short-lived task branches named type/short-description.
• Allowed branch prefixes are feature/, fix/, docs/, ops/, test/, asset/, and experiment/.
• Keep raw terrain datasets, generated builds, DerivedDataCache, and large archives out of every Git branch.

Roadmap update:

• Marked branch naming conventions complete in version 0.01 Foundation Baseline.
• Split commit message conventions into the next separate foundation item.
• Added near-term MVP map-tile serving server work to Phase 0.7 and Near-Term Next Actions:
  • Launch a small Ubuntu/Linux cloud VM for map-tile serving.
  • Publish a tiny Ground Zero tile manifest/package.
  • Prove lookup, download, local cache, redownload, and immediate-neighbor metadata flow.
  • Add cost controls and runbook notes so MVP testing stays free or near-free.

Immediate next roadmap item:

• Finish commit message conventions.

Agrarian Commit Message Conventions - 2026-05-14

Completed commit message conventions for Version 0.01 Foundation Baseline.

Added:

• Docs/CommitMessageConventions.md

Policy:

• Use concise, plain-English, imperative commit subjects.
• Keep subjects specific, capitalized, and usually under 72 characters.
• Prefer one commit per roadmap item or tight implementation slice.
• Add commit bodies for non-obvious reason, tradeoff, validation, operational impact, build impact, networking, tile delivery, or save compatibility.
• Never include secrets, passwords, tokens, private keys, or credentials in commit messages.
• Avoid vague messages such as updates, misc, changes, work, or wip.

Roadmap update:

• Marked commit message conventions complete.
• Immediate next roadmap item is defining backup expectations for NAS and the repository.

Agrarian Backup Expectations - 2026-05-14

Completed the roadmap item to define backup expectations for NAS and repository.

Added:

• Docs/BackupExpectations.md

Backup policy:

• GitHub is not enough by itself; it protects source history, not all local terrain source data, generated build outputs, VM state, or deleted local files.
• DevBox remains the primary working storage for the Unreal project.
• Linastorage is the first backup target for project snapshots, VM backups, and deleted-file recovery.
• Back up /mnt/projects/AgrarianGameBulid / \\DevBox\projects\AgrarianGameBulid incrementally during active development when changes exist.
• Recommended project cadence:
  • every 2 hours during active development if changes exist
  • daily, weekly, and monthly retained snapshots
  • manual pre-change snapshots before major Unreal, plugin, terrain, migration, or build-pipeline changes
• Retention target:
  • frequent snapshots: 7 days
  • daily snapshots: 30 days
  • weekly snapshots: 12 weeks
  • monthly snapshots: 12 months
  • important deleted files recoverable for at least 30 days, preferably 90 days for major assets/source data/investor-demo material
• Backup method should stage locally or on DevBox first, write manifests and checksums, copy to Linastorage under .incomplete-*, verify on the NAS, then atomically rename the completed snapshot.
• VM backups must cover Windows-Builder, Ubuntu-Codex, VM XML/NVRAM, Unraid flash/config, and related helper scripts.
• Do not copy live VM disk images directly without quiescing. Use Unraid VM backup tooling, QEMU guest-agent freeze/thaw, or a powered-down maintenance backup.
• Restore testing is required:
  • weekly single-file restore
  • monthly repo snapshot restore/list check
  • monthly VM backup readability check
  • quarterly fuller restore drill

Roadmap update:

• Marked backup expectations, VM snapshot cadence, and Unraid share backup policy as documented.
• Added follow-on implementation items:
  • Implement Linastorage incremental project backup job.
  • Implement quiesced VM backup job for Windows-Builder and Ubuntu-Codex.
  • Add recurring restore-test log for project and VM backups.
• Immediate next roadmap item is implementing the Linastorage incremental project backup job.

Agrarian Linastorage Project Backup Job - 2026-05-14

Completed the roadmap item to implement the Linastorage incremental project backup job.

Repo files added/updated:

• Scripts/agrarian_project_backup.sh
• Operations/systemd/agrarian-project-backup.service
• Operations/systemd/agrarian-project-backup.timer
• Docs/Ops/AgrarianProjectBackupRunbook.md

Installed on this host:

• Script: /usr/local/sbin/agrarian-project-backup
• Service: /etc/systemd/system/agrarian-project-backup.service
• Timer: /etc/systemd/system/agrarian-project-backup.timer

Active backup implementation:

• Uses restic, installed from Ubuntu packages.
• Repository: /mnt/backups/linastorage/backups/agrarian-game/project/restic-repository
• State files: /mnt/backups/linastorage/backups/agrarian-game/project/state
• Password file: /root/.backup-secrets/agrarian-project-restic.password
• Do not copy or write the restic password into handoff files or the repo.
• Timer runs every 2 hours with randomized delay.
• Script records a source signature and skips scheduled runs when no project changes are detected.
• Retention:
  • keep all snapshots within 7 days
  • keep daily snapshots for 30 days
  • keep weekly snapshots for 12 weeks
  • keep monthly snapshots for 12 months

Important implementation note:

• First attempt used rsync --link-dest, but Linastorage over SMB does not support the hard-link operations required for that model.
• Restic replaced rsync because it stores encrypted, deduplicated chunks as normal files and works with the SMB target.
• A one-time legacy rsync snapshot remains under the old snapshots/ directory as a temporary safety copy; active backups are restic.

Verification completed:

• First restic snapshot: e7ec1ce7, processed about 825 MiB, stored about 566 MiB.
• Incremental snapshot after script/runbook changes: 208d7710, stored about 5 KiB.
• Final incremental snapshot after lock handling change: 3d77f1d2, stored about 8 KiB.
• Restored AGRARIAN_DEVELOPMENT_ROADMAP.md from restic latest with restic dump and verified it matched the live file with diff.
• Final dry run returned: No project changes detected since latest restic backup; skipping.
• Timer is enabled and active; next trigger was scheduled after verification.

Roadmap update:

• Moved the private-repo GitHub protected main branch item out of 0.01 foundation and into the release/build pipeline as a paid-plan/revenue-timed hardening item.
• Marked Linastorage incremental project backup job complete.
• Immediate next roadmap item is implementing quiesced VM backup jobs for Windows-Builder and Ubuntu-Codex.

Agrarian Unraid VM Backup Job - 2026-05-14

Completed the roadmap item to implement quiesced VM backup jobs for Windows-Builder and Ubuntu-Codex.

Repo files added/updated:

• Scripts/agrarian_vm_backup_unraid.sh
• Operations/unraid/agrarian-vm-backup.cron
• Docs/Ops/AgrarianVmBackupRunbook.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Installed on Unraid DevBox:

• Persistent script: /boot/config/custom/agrarian-vm-backup.sh
• Runtime script copy: /usr/local/sbin/agrarian-vm-backup
• Persistent cron: /boot/config/plugins/dynamix/agrarian-vm-backup.cron
• Loaded cron entry in /etc/cron.d/root

Backup behavior:

• Weekly safe check runs Sunday at 03:15.
• Scheduled/default mode skips running VMs and publishes no empty snapshot.
• Manual maintenance mode: /usr/local/sbin/agrarian-vm-backup --shutdown-running
• Maintenance mode gracefully shuts down selected running VMs, backs them up, and starts VMs again unless --no-start-after is used.
• Captures VM XML, NVRAM when present, compressed qcow2 disk images via qemu-img convert -O qcow2 -c, selected Unraid VM/share config, manifest, and SHA256 checksums.
• Snapshot root: /mnt/user/backups/agrarian-game/vms/snapshots
• Retention: deletes snapshots older than 120 days.

Verification completed:

• Local script syntax passed with bash -n.
• Unraid safe dry run saw both VMs running, skipped both, and published no snapshot.
• Unraid maintenance dry run for Ubuntu-Codex showed the intended shutdown, XML export, and qcow2 conversion path without actually stopping the VM.
• update_cron loaded the weekly cron entry successfully.

Important operational note:

• A real full VM backup was not run during implementation because Windows-Builder and Ubuntu-Codex were active. Run the maintenance command during a planned window to create the first disk-image snapshots.

Roadmap update:

• Marked quiesced VM backup job complete.
• Immediate next roadmap item is creating repeatable dedicated server build instructions.

Agrarian Dedicated Server And Tile Delivery Build Lanes - 2026-05-14

Completed the roadmap item to create repeatable dedicated server build instructions, and included a fast static cloud map-tile delivery package path.

Repo files added/updated:

• Source/AgrarianGameServer.Target.cs
• Scripts/BuildLinuxDedicatedServer-Windows.bat
• Scripts/build_ground_zero_tile_delivery_package.sh
• Operations/cloud-map-tile-server/bootstrap_ubuntu_tile_server.sh
• Docs/Ops/DedicatedServerBuildRunbook.md
• Docs/Ops/MapTileDeliveryServerRunbook.md
• .gitignore
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Dedicated server lane:

• Added Unreal target AgrarianGameServer with TargetType.Server.
• Windows-Builder command: Scripts\BuildLinuxDedicatedServer-Windows.bat
• Expected output: Builds\LinuxServerDevelopment
• Expected log: Saved\BuildLogs\BuildLinuxDedicatedServer.log
• Server package cooks /Game/Agrarian/Maps/L_GroundZeroTerrain_Test.
• Requires Epic's Unreal 5.7 Linux cross-compile toolchain on Windows-Builder before the actual Linux package can build.

Map-tile delivery lane:

• Build command from the repo on Linux: Scripts/build_ground_zero_tile_delivery_package.sh
• Output archive: BuildArtifacts/TileDelivery/agrarian-ground-zero-tile-delivery.tar.gz
• Static package includes:
  • manifest.json
  • ground_zero_tiles.json
  • tile registry schema
  • Ground Zero Unreal heightmap, metadata, landform analysis, water/shoreline analysis, and neighbor edge verification
  • SHA256SUMS
• BuildArtifacts/ is ignored and should not be committed.
• Bootstrap command on a fresh Ubuntu tile server: sudo Operations/cloud-map-tile-server/bootstrap_ubuntu_tile_server.sh /path/to/agrarian-ground-zero-tile-delivery.tar.gz
• Bootstrap installs nginx and serves /health, /manifest.json, /ground_zero_tiles.json, and versioned tile package files.

Verification completed:

• Bash syntax passed for both Linux scripts.
• Ground Zero tile delivery package built successfully from current repo data.
• sha256sum -c SHA256SUMS passed for the generated static tile package.
• Archive listing confirmed the manifest, registry, schema, and Ground Zero tile files are included.
• Dedicated server Windows batch script was reviewed but not executed here, because the Linux Unreal cross-compile toolchain state must be checked on Windows-Builder.

Roadmap update:

• Marked repeatable dedicated server build instructions complete.
• Marked one-command Linux dedicated server build wrapper complete.
• Added and marked complete the static Ground Zero tile-delivery package and Ubuntu nginx bootstrap script item.
• Immediate next roadmap item is finishing required plugin documentation.

Agrarian Required Plugin Documentation - 2026-05-14

Completed the roadmap item to finish required plugin documentation.

Repo files added/updated:

• Docs/RequiredPlugins.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Current enabled plugins in AgrarianGame.uproject:

• StateTree
• GameplayStateTree
• ModelingToolsEditorMode

Decision captured:

• Keep StateTree and GameplayStateTree for version 0.01 because the compiled template AI code under Variant_Combat and Variant_SideScrolling still depends on StateTreeModule, GameplayStateTreeModule, and UStateTreeAIComponent.
• Keep ModelingToolsEditorMode enabled as an editor workflow plugin for terrain, mesh, and prototype world-building work.
• Do not add Steam, Gameplay Ability System, Marketplace, or machine-specific editor-helper plugins until a roadmap item needs them.
• Revisit StateTree dependencies during the template-variant cleanup item.

Verification completed:

• AgrarianGame.uproject parsed successfully as JSON.
• Secret scan of the new plugin documentation returned no matches.

Roadmap update:

• Marked required plugin documentation complete.
• Immediate next roadmap item is confirming the project opens cleanly from a fresh checkout.

Agrarian Fresh Checkout Open Verification And Character Selection Roadmap - 2026-05-14

Completed the foundation baseline item to confirm the project opens cleanly from a fresh checkout, and added the requested MVP character-selection landing page requirement to the roadmap.

Roadmap additions:

• Phase 1.14 MVP UI And UX now includes a post-splash/startup landing page.
• The landing page should let the player choose a realistic young adult male or female character with average proportions for the MVP.
• The first playable MVP definition of done now includes the startup flow reaching that character selection landing page and allowing the male/female character choice before entering the world.

Fresh checkout used:

• Path: /mnt/projects/AgrarianFreshCheckout-20260514-133248
• Commit checked out: 0173b34
• Clone source: git@github.com:pacificao/AgrarianGameBuild.git

Verification completed:

• Fresh clone completed with Git LFS content filtered.
• git lfs fsck passed.
• Fresh clone git status --short was clean before Unreal generated files.
• Windows-Builder built the fresh checkout with: Scripts\BuildEditor-Windows.bat
• Build result: AgrarianGameEditor Win64 Development succeeded.
• Windows-Builder opened the fresh checkout through command-mode Unreal with: Scripts\RunUnrealPython-Windows.bat Scripts\verify_ground_zero_terrain_map.py
• Ground Zero map loaded successfully.
• Map check reported 0 Error(s), 0 Warning(s).
• Verification script reported the expected 1 km terrain bounds and exited cleanly.

Operational note:

• The fresh checkout was left in place for reference. Unreal generated Binaries/, Intermediate/, and Saved/ inside that checkout during the validation.

Roadmap update:

• Marked fresh-checkout project open verification complete.
• Immediate next roadmap item is deciding whether to keep current Unreal template variants or remove unused starter variants.

Agrarian Template Variant Decision - 2026-05-14

Completed the roadmap item to decide whether to keep current Unreal template variants or remove unused starter variants.

Repo files added/updated:

• Docs/TemplateVariantDecision.md
• Docs/RequiredPlugins.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Decision:

• Remove or quarantine unused starter variants during the next content organization cleanup:
  • Variant_Combat
  • Variant_Platforming
  • Variant_SideScrolling
• Keep ThirdPerson temporarily because the current player Blueprint, interaction setup, and automation still use it.
• Keep shared mannequin/animation content only where current Agrarian assets still reference it.
• Recheck and remove StateTree / GameplayStateTree plugin and module dependencies after the unused variant code/content is removed.

Reason:

• The starter variants add compile time, plugin dependencies, packaging noise, and make the project look like a generic Unreal template.
• Actual source/content deletion is intentionally deferred to the next roadmap item so content redirects, maps, external actors, and smoke tests can be handled in one focused editor-aware cleanup pass.

Verification completed:

• Reviewed source/config/content references for Variant_*, ThirdPerson, StateTree, and GameplayStateTree.
• Secret scan of the new decision doc and plugin doc returned no matches.

Roadmap update:

• Marked the template variant decision complete.
• Immediate next roadmap item is organizing Content/Agrarian/ folders and moving/removing starter/prototype assets into clearly named locations.

Agrarian Starter Variant Content Cleanup - 2026-05-14

Completed the roadmap item to organize Content/Agrarian/ folders and remove unused starter/prototype assets.

Repo files updated:

• AGRARIAN_DEVELOPMENT_ROADMAP.md
• AgrarianGame.uproject
• Config/DefaultEditor.ini
• Config/DefaultEditorPerProjectUserSettings.ini
• Docs/RequiredPlugins.md
• Docs/TemplateVariantDecision.md
• Source/AgrarianGame/AgrarianGame.Build.cs

Removed:

• Source/AgrarianGame/Variant_Combat
• Source/AgrarianGame/Variant_Platforming
• Source/AgrarianGame/Variant_SideScrolling
• Content/Variant_Combat
• Content/Variant_Platforming
• Content/Variant_SideScrolling
• Matching World Partition external actor/object folders for those variants.

Build/config cleanup:

• Removed StateTreeModule and GameplayStateTreeModule from AgrarianGame.Build.cs.
• Removed explicit StateTree and GameplayStateTree plugin entries from AgrarianGame.uproject.
• Updated editor defaults so the simple map and content browser path now point at Agrarian/Ground Zero locations instead of the old ThirdPerson template folder.

Intentional leftovers:

• Content/ThirdPerson remains because the current player Blueprint, interaction setup, and automation still depend on it.
• Content/LevelPrototyping remains because current scripts/prototype Blueprints still reference simple cube/cylinder meshes.
• Replace those with Agrarian-specific character selection/player assets and project-native prototype meshes in a later cleanup.

Verification completed:

• Windows-Builder built AgrarianGameEditor Win64 Development successfully through Scripts\BuildEditor-Windows.bat.
• Windows-Builder loaded L_GroundZeroTerrain_Test through command-mode Unreal with Scripts\RunUnrealPython-Windows.bat Scripts\verify_ground_zero_terrain_map.py.
• Ground Zero map check reported 0 Error(s), 0 Warning(s).
• AgrarianGame.uproject parsed successfully as JSON.
• Source/config/project stale-reference scan found no remaining runtime references to the removed variant source/content or removed module dependencies. Remaining matches are explanatory docs only.
• Secret scan of updated roadmap/docs found no secrets.

Roadmap update:

• Marked the starter variant content cleanup complete.
• Immediate next roadmap item is launching the near-term MVP map-tile serving cloud VM and proving Ground Zero tile lookup/download/cache flow.

Agrarian MVP Tile Server Launch - 2026-05-14

Completed the roadmap item to launch the near-term MVP map-tile serving VM and prove Ground Zero tile lookup/download/cache/redownload.

Current endpoint:

• Host VM: Agrarian-TileServer on Unraid DevBox
• VM IP: 192.168.5.14
• Port: 18080/tcp
• Base URL: http://192.168.5.14:18080

Published from:

• /srv/agrarian/tile-delivery/public

Live endpoints verified:

• http://192.168.5.14:18080/health
• http://192.168.5.14:18080/manifest.json
• http://192.168.5.14:18080/ground_zero_tiles.json
• http://192.168.5.14:18080/tiles/gz_us_ca_pacifica_utm10n_e544_n4160/v0/...

Implementation notes:

• Built the static tile package on Unraid from the local project share because building it through the CIFS-mounted repo path stalled.
• Created a dedicated Agrarian-TileServer Ubuntu VM on Unraid from the Ubuntu Noble cloud image.
• Installed nginx inside Agrarian-TileServer.
• Configured nginx to listen on the uncommon local MVP port 18080.
• Published the Ground Zero tile-delivery package under /srv/agrarian.
• Added Scripts/verify_tile_delivery_client.sh for repeatable client proof.
• Updated Docs/Ops/MapTileDeliveryServerRunbook.md with the current endpoint, verification path, cost-control note, and dedicated-VM follow-up.

Verification completed:

• curl http://192.168.5.14:18080/health returned ok.
• Manifest returned successfully from http://192.168.5.14:18080/manifest.json.
• Scripts/verify_tile_delivery_client.sh http://192.168.5.14:18080 passed.
• Client verification downloaded the manifest, registry, SHA256SUMS, schema, and Ground Zero terrain package files.
• Client verification confirmed neighbor_count=8.
• Client verification deleted and redownloaded the heightmap, then revalidated checksums.

Operational follow-up:

• The service is now isolated inside Agrarian-TileServer; Unraid is only the hypervisor/storage host.
• Ubuntu-Codex is not serving the tile endpoint.
• Decide later whether public testing uses this LAN-hosted VM or an external cloud host.

Roadmap update:

• Marked the near-term MVP map-tile serving VM item complete.
• Immediate next roadmap item is defining MVP day/night length, survival pressure target, success loop, failure conditions, and closed-test readiness criteria.

Additional DNS/public endpoint note, 2026-05-15:

• maps.agrariangame.com now resolves to the same public IP as dev.agrariangame.com: 208.79.250.18.
• Public tile endpoint verified: http://maps.agrariangame.com:18080
• Public client verification passed against http://maps.agrariangame.com:18080, including manifest, registry, checksum validation, 8 neighbor entries, and heightmap redownload.

Agrarian MVP Survival And Readiness Criteria - 2026-05-15

Completed the roadmap item to define MVP day/night length, survival pressure target, success loop, failure conditions, first playable internal milestone, and closed-test readiness criteria.

Repo files updated:

• Docs/MvpSurvivalReadinessCriteria.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md
• Source/AgrarianGame/AgrarianGameState.h

Decision:

• Day/night should mimic the real Earth region represented by the loaded map tile, like weather.
• For Ground Zero, the server-authoritative world clock should follow real local time pacing for the Ground Zero region.
• Time acceleration remains allowed for tests and debug tools, but it is not the default player-facing world clock.
• Player progression should come from skills, tools, shelter, storage, knowledge, cooperation, and infrastructure rather than speeding up the sky clock.

Code alignment:

• Changed the default GameHoursPerRealMinute from the old accelerated value to real-time pacing (1.0f / 60.0f).
• Relaxed the editor clamp so real-time pacing is valid.

Verification completed:

• Searched docs/source to remove the old 4 real hours = 1 in-game day default.
• Windows-Builder built AgrarianGameEditor Win64 Development successfully through Scripts\BuildEditor-Windows.bat.

Roadmap update:

• Marked the MVP survival/readiness criteria item complete.
• Immediate next roadmap item is creating the core design document.

Correction on 2026-05-15:

• Restored 4 real hours = 1 in-game day as the MVP gameplay calendar target.
• Clarified that real-region day/night is the presentation/solar/weather context, not a replacement for the MVP gameplay calendar pace.
• GameHoursPerRealMinute was restored to 0.1f.
• Windows-Builder rebuild passed after the correction.

Agrarian Core Design Document - 2026-05-15

Completed the roadmap item to create the core design document.

Repo files updated:

• Docs/CoreDesignDocument.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Content captured:

• Core identity: persistent generational civilization simulator.
• Motto/design question: "What survives after you are gone?"
• Design pillars: civilization is built, legacy matters, world remembers, frontier always exists, knowledge progression, real place/believable pace, hard beginnings/earned ease.
• MVP experience and first loop.
• Long-term world model and Earth-scale tile direction.
• Time/weather split: 4 real hours = 1 in-game day for MVP gameplay calendar, with day/night presentation and weather grounded in the represented region.
• Survival, progression, multiplayer/society, economy/AGR principles.
• Non-goals and design risks.
• Current design decisions, including maps.agrariangame.com:18080 and Agrarian-TileServer.

Roadmap update:

• Marked the core design document complete.
• Immediate next roadmap item is creating the technical design document.

Agrarian Technical Design Document - 2026-05-15

Completed the roadmap item to create the technical design document.

Repo files updated:

• Docs/TechnicalDesignDocument.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Content captured:

• Current Unreal 5.7 C++ / Blueprint architecture baseline.
• Server-authoritative runtime model and client responsibilities.
• Gameplay system boundaries for GameState, survival, inventory, crafting, interaction, resource actors, buildables, and persistence.
• Time/environment target: 4 real hours = 1 in-game day, with real-region day/night presentation and weather context.
• MVP tile delivery architecture and endpoint: http://maps.agrariangame.com:18080.
• Data contracts for Unreal Data Assets, JSON metadata, and save data.
• Persistence, multiplayer, build automation, infrastructure, source control, security, and testing gates.
• Open technical questions for the next design passes.

Roadmap update:

• Marked the technical design document complete.
• Immediate next roadmap item is creating the multiplayer/networking design document.

Agrarian Multiplayer And Networking Design - 2026-05-15

Completed the roadmap item to create the multiplayer/networking design document.

Repo files updated:

• Docs/MultiplayerNetworkingDesign.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Content captured:

• MVP networking goal for at least two players on the same server.
• Network model: listen server acceptable for quick internal testing; dedicated server remains preferred closed-test target.
• Server-authority rules for survival, inventory, crafting, resources, wildlife, world time/weather, build placement, persistence, spawn/respawn, and active tile/package version.
• Client responsibilities and replication scope.
• RPC validation rules and examples.
• Join, spawn, respawn, disconnect, and reconnect MVP behavior.
• Tile delivery split: tile server delivers static files, gameplay server owns authoritative world/tile state.
• Missing tile handling, network relevancy, latency expectations, security baseline, dedicated server direction, and testing gates.

Additional roadmap items marked complete because this document defines them:

• Confirm listen server vs dedicated server for MVP.
• Define server authority over streamed terrain tiles.
• Define server response when a client requests a missing tile.
• Add player join flow.
• Add player spawn flow.

Roadmap update:

• Marked the multiplayer/networking design document complete.
• Immediate next roadmap item is creating the persistence design document.

Agrarian Persistence Design Document - 2026-05-15

Completed the roadmap item to create the persistence design document.

Repo files updated:

• Docs/PersistenceDesignDocument.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Content captured:

• Persistence principles: save meaningful state, version long-lived records, keep external metadata external, and make the server own writes.
• MVP persistence scope: player identity, survival snapshot, inventory snapshot, placed structures, resource depletion where needed, world time/weather state, active Ground Zero tile ID, and active tile package version.
• Save data vs external tile metadata boundary.
• Player identity, survival, inventory, world state, placed object, resource depletion, tile reference, and container record shapes.
• Save timing, load-on-server-start flow, migration rules, storage backend options, backup/recovery, security, and testing gates.

Roadmap update:

• Marked the persistence design document complete.
• Marked only the design/scope decisions complete in 1.13 Persistence MVP; implementation tasks such as saving player identity, stats, inventory, world time, weather state, containers, save interval, load-on-start, and tile registry persistence remain open.
• Immediate next roadmap item is creating the Earth-scale terrain/tile streaming design document.

Agrarian First/Third-Person Camera Toggle - 2026-05-15

Completed the roadmap item to implement the hybrid camera toggle.

Repo files updated:

• Source/AgrarianGame/AgrarianGameCharacter.h
• Source/AgrarianGame/AgrarianGameCharacter.cpp
• Content/Input/Actions/IA_ToggleCamera.uasset
• Content/Input/IMC_Default.uasset
• Content/ThirdPerson/Blueprints/BP_ThirdPersonCharacter.uasset
• Scripts/setup_camera_toggle_input.py
• Scripts/verify_camera_toggle_input.py
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Behavior:

• Third person remains the default view.
• Press V or gamepad right thumbstick to toggle first-person view.
• First-person view uses a zero-length spring arm with a head-height camera offset, disables camera collision, and hides the local owner's mesh.
• Toggling back restores the third-person boom distance and mesh visibility.

Verification:

• Windows editor build completed successfully with Scripts\BuildEditor-Windows.bat.
• Unreal Python verification completed successfully with Scripts\verify_camera_toggle_input.py, confirming the input action, keyboard/gamepad mappings, and Blueprint assignment.

Roadmap update:

• Marked Implement first/third-person camera toggle complete.
• Immediate next roadmap item is Implement sprinting.

Agrarian Sprinting - 2026-05-15

Completed the roadmap item to implement sprinting.

Repo files updated:

• Source/AgrarianGame/AgrarianGameCharacter.h
• Source/AgrarianGame/AgrarianGameCharacter.cpp
• Content/Input/Actions/IA_Sprint.uasset
• Content/Input/IMC_Default.uasset
• Content/ThirdPerson/Blueprints/BP_ThirdPersonCharacter.uasset
• Scripts/setup_sprint_input.py
• Scripts/verify_sprint_input.py
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Behavior:

• Hold LeftShift or gamepad left thumbstick to sprint.
• Default walk speed is 500; sprint speed is 750.
• Sprinting spends stamina only on the server and only while moving.
• Sprint intent replicates to clients and updates movement speed on replication.
• Sprinting automatically stops when stamina falls below MinSprintStamina.

Verification:

• Windows editor build completed successfully with Scripts\BuildEditor-Windows.bat.
• Unreal Python setup completed successfully with Scripts\setup_sprint_input.py.
• Unreal Python verification completed successfully with Scripts\verify_sprint_input.py, confirming the input action, keyboard/gamepad mappings, and Blueprint assignment.

Roadmap update:

• Marked Implement sprinting complete.
• Immediate next roadmap item is Define real-world baseline walking speed.

Agrarian Baseline Walking Speed - 2026-05-15

Completed the roadmap item to define real-world baseline walking speed.

Repo files updated:

• Docs/MovementAndTimeScaleBaseline.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Decision:

• Keep the MVP calendar target of 4 real hours = 1 in-game day.
• Do not multiply player movement speed by the calendar time scale.
• Baseline adult walking speed is 1.4 m/s, or 140 Unreal units/s.
• MVP tuning may allow up to about 1.6 m/s for a brisk walk if the first playable build feels too sluggish.
• A flat 1 km tile edge-to-edge walk should take about 12 real minutes at baseline pace.

Rationale:

• Real terrain and 1 km tiles need real physical movement to feel grounded.
• Calendar compression should affect day/night rhythm, survival pressure, weather, sleep, crop growth, and long-term simulation, not the physical speed of the player body.
• Long travel consuming daylight is intentional; roads, carts, mounts, boats, vehicles, shelter, storage, and settlement planning should become meaningful progression systems.

Roadmap update:

• Marked Define real-world baseline walking speed complete.
• Immediate next roadmap item is Define real-world baseline running speed.

Agrarian Baseline Running Speed - 2026-05-15

Completed the roadmap item to define real-world baseline running speed.

Repo files updated:

• Docs/MovementAndTimeScaleBaseline.md
• Source/AgrarianGame/AgrarianGameCharacter.h
• Content/ThirdPerson/Blueprints/BP_ThirdPersonCharacter.uasset
• Scripts/setup_movement_baseline.py
• Scripts/verify_movement_baseline.py
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Decision:

• Keep movement measured in real distance per real second.
• Do not multiply running or sprinting by the 4 real hours = 1 in-game day calendar.
• Sustainable adult running target is 3.0 m/s, or 300 Unreal units/s.
• The current MVP sprint input is a short burst at 5.5 m/s, or 550 Unreal units/s.
• The default walk speed was aligned to the walking baseline at 140 Unreal units/s.
• Sprint stamina cost was raised to 28 per second so early characters cannot sprint across a full 1 km tile without rest or progression.

Verification:

• Windows editor build completed successfully with Scripts\BuildEditor-Windows.bat.
• Unreal Python movement baseline verification completed successfully with Scripts\verify_movement_baseline.py, confirming Blueprint defaults.

Roadmap update:

• Marked Define real-world baseline running speed complete.
• Immediate next roadmap item is Connect movement speed to age, condition, strength, endurance, hunger, thirst, injury, carried weight, and terrain.

Agrarian Movement Modifiers - 2026-05-15

Completed the roadmap item to connect movement speed to age, condition, strength, endurance, hunger, thirst, injury, carried weight, and terrain.

Repo files updated:

• Source/AgrarianGame/AgrarianGameCharacter.h
• Source/AgrarianGame/AgrarianGameCharacter.cpp
• Source/AgrarianGame/AgrarianInventoryComponent.h
• Source/AgrarianGame/AgrarianInventoryComponent.cpp
• Scripts/setup_movement_baseline.py
• Scripts/verify_movement_baseline.py
• Docs/MovementAndTimeScaleBaseline.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Behavior:

• Character movement speed now uses base speed * movement modifier.
• Live modifiers include hunger, thirst, injury, carried inventory weight, and terrain multiplier.
• Replicated hooks were added for age, physical condition, strength, endurance, and terrain.
• Inventory now exposes GetTotalWeight().
• Strength raises effective carry thresholds.
• Endurance improves movement resilience and reduces sprint stamina cost.
• Terrain multiplier is available through SetTerrainMovementMultiplier().
• Movement modifier is clamped between 0.15 and 1.35.

Verification:

• Windows editor build completed successfully with Scripts\BuildEditor-Windows.bat.
• Unreal Python movement baseline setup and verification completed successfully with Scripts\setup_movement_baseline.py and Scripts\verify_movement_baseline.py.

Roadmap update:

• Marked the movement-modifier item complete.
• Immediate next roadmap item is Implement crouching if needed.

Agrarian Crouch And Prone Stances - 2026-05-15

Completed the roadmap item to implement crouching and prone movement stances.

Repo files updated:

• Source/AgrarianGame/AgrarianGameCharacter.h
• Source/AgrarianGame/AgrarianGameCharacter.cpp
• Content/Input/Actions/IA_Crouch.uasset
• Content/Input/Actions/IA_Prone.uasset
• Content/Input/IMC_Default.uasset
• Content/ThirdPerson/Blueprints/BP_ThirdPersonCharacter.uasset
• Scripts/setup_stance_input.py
• Scripts/verify_stance_input.py
• Docs/MovementAndTimeScaleBaseline.md
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Behavior:

• C toggles crouch and gamepad Right Shoulder maps to crouch.
• Z toggles prone and gamepad Left Shoulder maps to prone.
• Crouch uses a 0.55 movement multiplier.
• Prone uses a 0.25 movement multiplier.
• Sprint cannot start while crouched or prone.
• Entering prone exits crouch so only one low stance is active.
• Prone is replicated and uses the same movement modifier pipeline as hunger, thirst, injury, carried weight, terrain, and traits.

Verification:

• python3 -m py_compile passed for the stance setup and verify scripts.
• git diff --check passed for the touched text files.
• Windows editor build completed successfully with Scripts\BuildEditor-Windows.bat.
• Unreal Python stance setup and verification completed successfully with Scripts\setup_stance_input.py and Scripts\verify_stance_input.py.

Roadmap update:

• Marked Implement crouching and prone movement stances complete.
• Immediate next roadmap item is Implement interact prompt.

Agrarian Interaction Prompt - 2026-05-15

Completed the roadmap item to implement an interaction prompt.

Repo files updated:

• Source/AgrarianGame/AgrarianGameCharacter.h
• Source/AgrarianGame/AgrarianGameCharacter.cpp
• Source/AgrarianGame/AgrarianDebugHUD.h
• Source/AgrarianGame/AgrarianDebugHUD.cpp
• Source/AgrarianGame/AgrarianGameGameMode.cpp
• Scripts/setup_interaction_prompt.py
• Scripts/verify_interaction_prompt.py
• AGRARIAN_DEVELOPMENT_ROADMAP.md

Behavior:

• The local character now refreshes interactable focus each tick using the same visibility trace used by interaction.
• Focused interactables must implement AgrarianInteractable and pass CanInteract.
• Prompt text comes from GetInteractionText on the focused actor.
• The HUD draws [E] <prompt> near the center/lower-center of the screen.
• The prompt is independent of the dev HUD toggle so it can remain visible even when debug stats are hidden.
• BP_ThirdPersonGameMode is configured to use AgrarianDebugHUD.

Verification:

• git diff --check passed for touched text files.
• python3 -m py_compile passed for the setup and verify scripts.
• Windows editor build completed successfully with Scripts\BuildEditor-Windows.bat.
• Unreal Python setup and verification completed successfully with Scripts\setup_interaction_prompt.py and Scripts\verify_interaction_prompt.py.

Roadmap update:

• Marked Implement interact prompt complete.
• Immediate next roadmap item is Implement basic animation blueprint.

Agrarian 0.1.C Time, Weather, And Environment Pressure - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: dddac97 Add first pass sky lighting

Completed recent roadmap items:

• Store weather source, provider timestamp, tile coordinate, and applied in-game weather state for debugging and persistence
  • Commit: 26ddf8e Persist applied weather debug state
  • Added tile ID/coordinate fields to mapped weather inputs.
  • Added replicated FAgrarianWeatherDebugSnapshot.
  • Save files now hold mapped weather inputs and applied weather debug state.
• Add weather save/load support
  • Commit: 8625583 Add weather save load support
  • Added LoadCurrentWorld as the unified load path.
  • Weather/time restores before players and persistent world actors.
  • Admin load command now uses the combined load path.
  • Persistence smoke test verifies provider-backed weather metadata survives save/load.
• Connect shelter to weather protection
  • Commit: 0650806 Connect shelter to weather protection
  • Survival detects overlapping AAgrarianShelterActor protection volumes.
  • CurrentWeatherProtection replicates on the survival component.
  • Shelter protection reduces ambient exposure and cold damage.
  • Care-history ShelterQuality trends toward active protection.
  • Dev HUD shows shelter protection.
• Add first-pass sky and lighting
  • Commit: dddac97 Add first pass sky lighting
  • Added AAgrarianSkyLightingController.
  • Controller owns movable sun, skylight, and fog components.
  • Lighting reads replicated game time, active tile sunrise/sunset, weather state, and provider cloud cover.
  • Ground Zero map setup now places AGR_DemoSkyLightingController and removes legacy static demo sun/skylight/fog actors.
  • Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap was regenerated and saved with the new controller.

Verification:

• Windows editor build passed after each completed item.
• Unreal Python map setup passed for Scripts/setup_ground_zero_demo_map.py after adding the sky lighting controller.
• Relevant static verifiers and git diff --check passed:
  • Scripts/verify_weather_debug_persistence.py
  • Scripts/verify_weather_save_load_support.py
  • Scripts/verify_shelter_weather_protection.py
  • Scripts/verify_sky_lighting_controller.py

Roadmap state:

• Current version section: 0.1.C Time, Weather, And Environment Pressure
• Items remaining in 0.1.C: 1
• Immediate next roadmap item: Add audio cues for weather.

Agrarian Weather Audio Cues - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: 08a1df6 Add weather audio cues

Completed roadmap item:

• Add audio cues for weather
  • Added AAgrarianWeatherAudioController.
  • Controller owns ambient, rain, wind, and storm audio components.
  • It reads replicated weather state, provider wind speed, and day/night state from AAgrarianGameState.
  • It fades component volumes for clear, rain, cold wind, and storm states.
  • Sound assets are intentionally assignable slots; runtime is silent until placeholder or final audio loops are assigned.
  • Ground Zero setup now places AGR_DemoWeatherAudioController.
  • Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap was regenerated and saved with the controller.

Verification:

• python3 Scripts/verify_weather_audio_controller.py passed.
• python3 Scripts/verify_sky_lighting_controller.py passed.
• git diff --check passed.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.
• Unreal Python Ground Zero map setup passed through Scripts/setup_ground_zero_demo_map.py.

Roadmap state:

• Completed section: 0.1.C Time, Weather, And Environment Pressure
• Items remaining in 0.1.C: 0
• Next version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 11
• Immediate next roadmap item: Link Ground Zero tile coordinates to real-world weather lookup coordinates.

Agrarian Ground Zero Weather Lookup Coordinates - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: a7292bb Link Ground Zero weather lookup coordinates

Completed roadmap item:

• Link Ground Zero tile coordinates to real-world weather lookup coordinates
  • Added explicit weather_lookup_metadata to the Ground Zero tile registry entry.
  • Ground Zero weather lookup uses tile-center latitude 37.5925 and longitude -122.4995.
  • Weather lookup metadata records Open-Meteo primary routing, NOAA/NWS fallback eligibility, coordinate source, and lookup rule.
  • Updated the tile registry JSON schema and SQL prototype.
  • Updated Scripts/generate_tile_weather_manifest.py to read declared weather lookup metadata for future source-backed tiles.
  • Regenerated Data/Tiles/tile_weather_manifest.json.
  • Added Scripts/verify_ground_zero_weather_lookup_coordinates.py.
  • Updated docs and roadmap.

Verification:

• python3 Scripts/generate_tile_weather_manifest.py passed.
• python3 Scripts/verify_ground_zero_weather_lookup_coordinates.py passed.
• python3 Scripts/verify_weather_provider_adapter.py passed.
• AGRARIAN_SKIP_LIVE_WEATHER_CHECK=1 python3 Scripts/verify_open_meteo_mvp_source.py passed.
• AGRARIAN_SKIP_LIVE_WEATHER_CHECK=1 python3 Scripts/verify_noaa_nws_us_fallback.py passed.
• python3 -m py_compile Scripts/generate_tile_weather_manifest.py Scripts/verify_ground_zero_weather_lookup_coordinates.py Scripts/verify_weather_provider_adapter.py passed.
• git diff --check passed.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.

Roadmap state:

• Current version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 10
• Immediate next roadmap item: Replace grey-box environment presentation with an MVP natural environment pass: terrain material, grass, shrubs, bushes, trees, water-source visuals, and clearer Ground Zero biome dressing.

Agrarian Ground Zero Natural Environment Pass - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: 25ffbfc Add Ground Zero natural environment pass

Completed roadmap item:

• Replace grey-box environment presentation with an MVP natural environment pass
  • Added repeatable material generation in Scripts/setup_ground_zero_demo_map.py.
  • Created 8 Ground Zero material assets under Content/Agrarian/Materials/.
  • Applied the terrain material to the landscape.
  • Applied distinct tree, shrub, and dry grass materials to the foliage patch.
  • Applied wood, fiber, stone, and freshwater materials to placed resource/water actors.
  • Regenerated/saved Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap.
  • Added Docs/Terrain/GroundZeroNaturalEnvironmentPass.md.
  • Added Scripts/verify_ground_zero_natural_environment_pass.py.

Verification:

• python3 -m py_compile Scripts/setup_ground_zero_demo_map.py Scripts/verify_ground_zero_natural_environment_pass.py passed.
• git diff --check passed.
• Unreal Python Ground Zero setup passed.
• Unreal Python natural environment verifier passed: 8 materials, 1 landscape, 14 dressed resource/water actors.
• Unreal Python foliage verifier passed: 42 trees, 96 shrubs, 180 grass clumps.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.

Roadmap state:

• Current version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 9
• Immediate next roadmap item: Add first-pass environment asset variation so trees, bushes, grass, resource nodes, and water do not read as repeated placeholders.

Agrarian Ground Zero Environment Asset Variation - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: f78c552 Add Ground Zero environment asset variation

Completed roadmap item:

• Add first-pass environment asset variation so trees, bushes, grass, resource nodes, and water do not read as repeated placeholders
  • Added 11 repeatable labeled variation actors through Scripts/setup_ground_zero_demo_map.py.
  • Covered tree canopy/trunk pairs, rounded bushes, grass mats, rock slabs, and a visible freshwater surface.
  • Used multiple prototype mesh silhouettes, unique scale profiles, rotations, and the existing Ground Zero material families.
  • Regenerated/saved Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap.
  • Updated the Ground Zero natural environment and foliage docs.
  • Extended the natural environment verifier to require actor count, mesh variety, unique scales, and material-family coverage.

Verification:

• python3 -m py_compile Scripts/setup_ground_zero_demo_map.py Scripts/verify_ground_zero_natural_environment_pass.py passed.
• git diff --check passed.
• Unreal Python Ground Zero setup passed.
• Unreal Python natural environment verifier passed: 8 materials, 1 landscape, 14 dressed resource/water actors, 11 variation actors.
• Unreal Python foliage verifier passed: 42 trees, 96 shrubs, 180 grass clumps.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.

Roadmap state:

• Current version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 8
• Immediate next roadmap item: Replace LevelPrototyping cube/cylinder mesh dependencies in Agrarian setup scripts and prototype Blueprints with Agrarian-native placeholder environment meshes.

Agrarian Native Placeholder Meshes - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: b5d1359 Replace template meshes with native placeholders

Completed roadmap item:

• Replace LevelPrototyping cube/cylinder mesh dependencies in Agrarian setup scripts and prototype Blueprints with Agrarian-native placeholder environment meshes
  • Added five native placeholder static mesh assets under /Game/Agrarian/Environment/PlaceholderMeshes.
  • Updated playable Blueprint setup and Ground Zero setup scripts so active outputs use native Agrarian mesh paths.
  • Left template mesh references only as copy-source paths inside repeatable setup helpers.
  • Regenerated/saved the affected resource, structure, and water Blueprints.
  • Regenerated/saved Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap.
  • Added Scripts/verify_native_placeholder_meshes.py.
  • Updated the template decision doc, natural environment doc, and roadmap.

Verification:

• python3 -m py_compile Scripts/setup_ground_zero_demo_map.py Scripts/setup_playable_blueprints.py Scripts/verify_native_placeholder_meshes.py passed.
• git diff --check passed.
• Unreal Python playable Blueprint setup passed.
• Unreal Python Ground Zero setup passed.
• Unreal Python native placeholder verifier passed: 5 native mesh assets, 6 Blueprint meshes, foliage meshes, and environment variation meshes use native paths.
• Unreal Python natural environment verifier passed: 8 materials, 1 landscape, 14 dressed resource/water actors, 11 variation actors.
• Unreal Python foliage verifier passed: 42 trees, 96 shrubs, 180 grass clumps.
• Unreal Python player Blueprint verifier passed.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.

Roadmap state:

• Current version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 7
• Immediate next roadmap item: Add weather exposure zones if needed.

Agrarian Ground Zero Weather Exposure Zones - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: 8b0b5ff Add Ground Zero weather exposure zones

Completed roadmap item:

• Add weather exposure zones if needed
  • Added native replicated AAgrarianWeatherExposureZone actor with a box overlap volume, exposure multiplier, temperature offset, and stable zone id.
  • Updated UAgrarianSurvivalComponent so overlapping weather zones adjust ambient temperature exposure and cold damage after shelter/weather protection.
  • Updated the debug HUD to show current exposure multiplier and temperature offset.
  • Added three repeatable Ground Zero zones through Scripts/setup_ground_zero_demo_map.py: ridge exposure, coastal wind, and drainage cooling.
  • Regenerated/saved Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap.
  • Added Scripts/verify_weather_exposure_zones.py.
  • Updated the technical design document and roadmap.

Verification:

• python3 -m py_compile Scripts/setup_ground_zero_demo_map.py Scripts/verify_weather_exposure_zones.py passed.
• git diff --check passed.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.
• Unreal Python Ground Zero setup passed.
• Unreal Python weather exposure verifier passed: 3 zones with exposure multipliers and temperature offsets.
• Unreal Python natural environment verifier passed: 8 materials, 1 landscape, 14 dressed resource/water actors, 11 variation actors.
• Unreal Python foliage verifier passed: 42 trees, 96 shrubs, 180 grass clumps.
• Final Windows editor build passed through /home/nathan/bin/agrarian-build-editor.

Roadmap state:

• Current version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 6
• Immediate next roadmap item: Add landmark or ruin placeholder.

Agrarian Ground Zero Ruin Landmark Placeholder - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: 56f8ef9 Add Ground Zero ruin landmark placeholder

Completed roadmap item:

• Add landmark or ruin placeholder
  • Added a repeatable five-piece Ground Zero ruin cluster through Scripts/setup_ground_zero_demo_map.py.
  • The cluster includes a foundation slab, two wall fragments, a cairn marker, and a threshold/lintel piece.
  • The ruin uses Agrarian-native placeholder meshes and the Ground Zero stone material so it is visible in the MVP but easy to replace later.
  • Regenerated/saved Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap.
  • Added Scripts/verify_ground_zero_landmark_placeholder.py.
  • Updated the Ground Zero natural environment doc and roadmap.

Verification:

• python3 -m py_compile Scripts/setup_ground_zero_demo_map.py Scripts/verify_ground_zero_landmark_placeholder.py passed.
• git diff --check passed.
• Unreal Python Ground Zero setup passed.
• Unreal Python landmark placeholder verifier passed: 5 ruin actors, 3 mesh silhouettes.
• Unreal Python natural environment verifier passed: 8 materials, 1 landscape, 14 dressed resource/water actors, 11 variation actors.
• Unreal Python foliage verifier passed: 42 trees, 96 shrubs, 180 grass clumps.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.

Roadmap state:

• Current version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 5
• Immediate next roadmap item: Add spawn area with validation that the player spawns above sea level, above terrain by a safe offset, away from water, away from steep slopes, away from dense resource clusters, and with a known safe fallback coordinate.

Agrarian Ground Zero Safe Spawn Area - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: e50745d Validate Ground Zero safe spawn area

Completed roadmap item:

• Add spawn area with validation that the player spawns above sea level, above terrain by a safe offset, away from water, away from steep slopes, away from dense resource clusters, and with a known safe fallback coordinate
  • Added safe spawn candidate/fallback selection to Scripts/setup_ground_zero_demo_map.py.
  • Setup validates minimum elevation above sea level, maximum sampled terrain slope, minimum above-terrain Z offset, freshwater spacing, and resource-cluster spacing before saving the map.
  • AGR_DemoPlayerStart now uses the known safe fallback coordinate (-22000, -3500).
  • Added Scripts/verify_ground_zero_safe_spawn.py.
  • Regenerated/saved Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap.
  • Updated the technical design document and roadmap.

Verification:

• python3 -m py_compile Scripts/setup_ground_zero_demo_map.py Scripts/verify_ground_zero_safe_spawn.py passed.
• git diff --check passed.
• Unreal Python Ground Zero setup passed.
• Unreal Python safe-spawn verifier passed: location (-22000, -3500, 1148), terrain 9.28m, slope 1.94deg, above-terrain offset 220cm.
• Unreal Python natural environment verifier passed.
• Unreal Python foliage verifier passed.
• Unreal Python landmark placeholder verifier passed.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.
• Note: parallel Unreal verifier runs logged intermediate asset-registry cache write warnings because multiple editor processes started together; all verifiers completed successfully and the final editor build passed.

Roadmap state:

• Current version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 4
• Immediate next roadmap item: Add performance profiling markers.

Agrarian Performance Profiling Markers - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: 82463f3 Add Agrarian performance profiling markers

Completed roadmap item:

• Add performance profiling markers
  • Added Source/AgrarianGame/AgrarianPerformanceStats.h and Source/AgrarianGame/AgrarianPerformanceStats.cpp with STATGROUP_Agrarian.
  • Added stat Agrarian cycle counters and Unreal Insights CPU scopes for authoritative game-state time/weather ticking, survival ticking, sky-light refresh, weather-audio refresh, foliage instance mutation, and weather-provider request/parse/fallback work.
  • Added Scripts/verify_performance_profiling_markers.py.
  • Updated the technical design document and roadmap.

Verification:

• python3 -m py_compile Scripts/verify_performance_profiling_markers.py passed.
• python3 Scripts/verify_performance_profiling_markers.py passed.
• git diff --check passed.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.

Roadmap state:

• Current version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 3
• Immediate next roadmap item: Add navigation support for wildlife.

Agrarian Wildlife Navigation Support - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: 578220c Add wildlife navigation support

Completed roadmap item:

• Add navigation support for wildlife
  • Added NavigationSystem to the Agrarian module dependencies.
  • Wildlife now auto-possesses an AI controller when placed or spawned.
  • Wander targets are sampled from reachable nav points when nav data exists.
  • Chase and flee targets are projected onto navmesh.
  • Server-authoritative wildlife movement uses MoveToLocation.
  • Direct movement input remains as a fallback for early maps/tiles without nav data.
  • AI movement stops cleanly when wildlife dies.
  • Updated the wildlife loop verifier to find the current Ground Zero rabbit label.
  • Added Scripts/verify_wildlife_navigation_support.py.
  • Updated the technical design document and roadmap.

Verification:

• python3 -m py_compile Scripts/verify_wildlife_navigation_support.py Scripts/verify_wildlife_loop.py passed.
• python3 Scripts/verify_wildlife_navigation_support.py passed.
• git diff --check passed.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.
• Unreal Python wildlife loop verifier passed through Scripts/verify_wildlife_loop.py.

Roadmap state:

• Current version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 2
• Immediate next roadmap item: Add map boundaries or soft limits.

Agrarian Ground Zero Map Boundary - 2026-05-16

Current repo:

• /mnt/projects/AgrarianGameBulid
• GitHub remote: pacificao/AgrarianGameBuild
• Current branch: main
• Latest pushed commit: 65bcdf6 Add Ground Zero map boundary

Completed roadmap item:

• Add map boundaries or soft limits
  • Added native AAgrarianMapBoundaryVolume with a box volume, boundary ID, warning-zone test, clamp helper, and server-authoritative player clamp.
  • Placed AGR_GroundZeroMapBoundary around the loaded 1 km Ground Zero MVP tile in Content/Agrarian/Maps/L_GroundZeroTerrain_Test.umap.
  • Updated Scripts/setup_ground_zero_demo_map.py so regenerated Ground Zero maps automatically recreate the boundary volume.
  • Added Scripts/verify_map_boundary_source.py.
  • Added Scripts/verify_ground_zero_map_boundary.py.
  • Updated the technical design document and roadmap.

Verification:

• python3 -m py_compile Scripts/setup_ground_zero_demo_map.py Scripts/verify_map_boundary_source.py Scripts/verify_ground_zero_map_boundary.py passed.
• python3 Scripts/verify_map_boundary_source.py passed.
• git diff --check passed.
• Windows editor build passed through /home/nathan/bin/agrarian-build-editor.
• Unreal Python Ground Zero setup passed through Scripts/setup_ground_zero_demo_map.py.
• Unreal Python boundary verifier passed through Scripts/verify_ground_zero_map_boundary.py.

Roadmap state:

• Current version section: 0.1.D Single Biome MVP Map
• Items remaining in 0.1.D: 1
• Immediate next roadmap item: Add developer travel command.