Merge pull request #54 from xefensor/feature/village-storage-knowledge

Add shared village storage and ambient sightings

Author: xefensor

ASSET_CREDITS.md

@@ -8,6 +8,7 @@ This record complements [`LICENSE`](LICENSE) and [`LICENSE-ASSETS.md`](LICENSE-A
 | --- | --- | --- |
 | Jesse Schramm | Extinguished-torch textures | Included |
 | Xefensor | Gameplay screenshots dated 2026-07-18 | Repository documentation |
+| Xefensor | Runtime-generated horizon-figure skin encoded from a developer-supplied and approved visual source | Included; 2026-08-19 |
 | Xefensor, with drawing instruction and review from Codex | Hand-drawn Aender Sand texture created in Krita | Original replacement included; 2026-08-14 |
 | OpenAI image generation, directed and processed by Codex | Aender wood-family placeholder textures: planks, stripped log, sapling, door, trapdoor, signs, boats, and derived model atlases | AI-generated placeholder; 2026-07-22 |
 | OpenAI image generation, directed and processed by Codex | Aender Chronolith block and Aender Eye/Gale Core spawn-egg placeholder textures | AI-generated placeholder; 2026-07-22 |

CHANGELOG.md

@@ -11,6 +11,7 @@ Each release should be readable in two passes:
 
 ### Player-Facing
 
+- Villagers now share persistent knowledge of food, emeralds, and every other item they have observed in accessible village chests and barrels. Once a store is known, other villagers can go directly to the right container instead of repeating a nearby block search; player, hopper, and Villager inventory changes refresh active-village knowledge, while the physical container is still checked before use.
 - Villagers now keep their body and head aimed at an extinguished torch throughout both magical and Flint-and-Steel relighting. After a successful relight, they continue directly to other eligible nearby torches, handling up to eight per maintenance run before taking a break. Other stationary Retold interactions with a concrete subject now visibly face it as well, including golem construction, communal storage and livestock tending, feeding, desperate barrier breaking, Polar Bear warnings, and Spider web placement.
 - Healthy Wolves, Foxes, Cats, Ocelots, Dolphins, Spiders, and Cave Spiders now defend themselves after being attacked. This includes tamed Wolves, while tame-owner safety and the rule that badly wounded wild predators flee instead of fighting remain intact.
 - Stage 1 Zombie and Skeleton families now coordinate only at short range. In Stage 2 their existing awareness and same-family target sharing expand, and a stable minority of nearby Zombie-family and Skeleton-family mobs can answer one another when they hear or see a fight. Stage 2 also adds about 25% of each existing tagged Undead entry's natural-spawn weight without changing vanilla mob caps, placement checks, or pack sizes. This escalation changes population composition and convergence rather than attack stats.
@@ -44,6 +45,7 @@ Each release should be readable in two passes:
 
 ### Technical
 
+- Added `RetoldVillageStorageKnowledge`, a server-authoritative SavedData index of observed chest/barrel positions, slot capacity, and exact item stacks. Chunk-indexed lookups feed the existing communal food, Farmer deposit, livestock-tending, and golem-emerald search paths before a budgeted world scan. A narrow block-entity change hook refreshes known or village-local storage without polling; every target is loaded, accessible, and physically revalidated, and stale entries are repaired or removed. Focused shared-knowledge, food-route, Farmer-route, livestock, golem-currency, and Villager TPS coverage passes.
 - Added `RetoldActionFacing` as the shared body/head/look-control contract for stationary Retold actions. Magical torch casts and Villager golem work receive continuous presentation updates only while the Villager is actively using its subject; movement, pursuit, combat, migration, and free-flight behavior retain ordinary look control so body rotation does not fight navigation. Successful torch work now reuses the indexed, budgeted search to start the next eligible nearby torch immediately, capped at eight relights per interruptible run. Focused facing regressions pass for torch relighting, golem construction, feeding, and weak-barrier breaking.
 - Added `RetoldUndeadStagePressure` to stage-gate Zombie- and Skeleton-family notice/share radii and bounded cross-family assistance. Stage 2 responders use cached scans and sight, stable one-in-three sampling, source-aware `FACTION_ASSIST` targets, and existing combat/movement ownership. `RetoldUndeadSpawnPressure` mirrors already-present entries from the additive `retold:stage_2_undead_spawn_pressure` entity-type tag with a rounded 25% bonus weight while vanilla retains selection, caps, placement, and pack rules. Both exact Stage 1/Stage 2 tests pass, and all forty affected Stage 2 50-mob phases remain below 50 ms/tick; Zombie hunt/targeting was the 6.046 ms/tick peak.
 - Added a data-driven Soul Sand Valley Wither Skeleton biome spawn with weight 1 and pack size 1. An exact registry-backed GameTest guards the biome boundary and spawn parameters; no repeated AI work or profile registration changed.

ROADMAP.md

@@ -4,6 +4,7 @@ This concise public roadmap may change as features are designed and tested. Deta
 
 ## Now
 
+- Focus the next development pass on Villager and village systems: verify the implemented communal storage, farming, livestock, reputation, Iron Golem construction, torch-maintenance, and trade-stock loops in natural villages, then design the next coherent village-society slice.
 - Verify and refine the initial Stage 2 cartographer explorer-map path for finding Air Temples in fresh and upgraded worlds.
 - Continue tuning and testing the Gale Core encounter while migrating the Air reward toward the intended Heavy Core sacrifice.
 - Verify Aender portals, terrain regeneration, stabilizers, and progression in fresh worlds, upgraded worlds, dedicated servers, and multiplayer.
@@ -22,7 +23,6 @@ See [`docs/element-ritual.md`](docs/element-ritual.md) for the current ritual, a
 
 ## Later
 
-- Naturally verify the completed village-property reputation loop, including tended livestock, trade-price effects, witnesses, and Iron Golem hostility in multiplayer and existing villages.
 - Tool, armor, ore, station, enchanting, and combat progression reworks.
 - Stage 3 piglin or pigman cooperation.
 - Nether portal environmental effects and broader world-reactivity work.