Kingdoms: Villager Retaliation!

Added

• Story sharing: villagers can now react to discovered structures and biomes with profession-specific Share a Story dialogue
• Datapack-driven story discovery via story_structures and story_biomes
• Built-in vanilla structure/biome story data, including separate baby share_story lines
• Story sharing progress advancements:
  • Once Upon a Time
  • Story Keeper
  • Village Chronicler
  • Legend Trader
• Shared story target tracking, location-aware cooldowns, and duplicate-prevention logic
• Cartographer map report dialogue: discover a map target, return to the cartographer, and report it
• Story hint discovery/report dialogue with HUD notifications for found rumored places
• New dialogue/report flows:
  • gift_advice_followup
  • gear_report
  • recruitment_followup
  • combat_survival_report
  • village_defense_report
  • apology
  • cured_recognition
  • village_event_report
  • share_story
• First-village-interaction dialogue support
• Village event dialogue for sandstorms and snowstorms
• Cured-villager memory, including dialogue placeholders for the cured villager’s name
• Recruitment memory tracking: villagers remember follow distance, biome, safe/injured dismissal, betrayal, boat trips, swimming, and ocean crossings
• Gift advice can now be unreliable based on reputation, with follow-up dialogue after the player tests the advice
• Villagers can keep liked/loved gifts as keepsakes or store them in persistent inventory
• Villagers can borrow usable combat weapons from their inventory during retaliation
• Gift return/stolen gift tracking, reputation penalties, gifted-item tooltips, and the Changed My Mind advancement
• High-reputation gift return dialogue using new gift_given lines
• Emerald blocks, emerald ore, and deepslate emerald ore gift preferences
• Ambient world-text indicators for villager conversations
• Vanilla chat/command input support while the villager interaction UI is open
• Config options for separating villager chat messages and speaker groups
• Optional health and armor display in the reputation debug overlay
• Combat config toggles for hostile mob targeting, retaliation, standing ground, creeper fleeing, and weapon pickup
• VillageMembership system for village-aware reputation, gossip, events, and advancement checks
• Initial wiki documentation for dialogue, notifications, gifts, story discovery, JSON references, pack development, villager names, and resource-pack models

Improved

• Dialogue content expanded heavily across professions, moods, events, recruitment memories, apologies, survival reports, village defense, and story sharing
• Dialogue files can now be split into nested profession files such as professions/farmer/share_stories.json
• Profession-specific dialogue/message selection now has better priority handling
• Villager display names are resolved more reliably in dialogue and synced to clients when custom names exist
• Gift knowledge is persisted when villagers learn whether a gift was liked or disliked
• Chat formatting was refined with cleaner villager speaker labels and configurable spacing
• Story hint placement now tracks structure IDs and handles unreliable vertical hints more safely
• Village defense, cured-villager events, and other memories are scoped more cleanly to village context
• Debug/readme documentation expanded for pack makers and translators

Performance And Reliability

• Added resource warmup/clear hooks for dialogue, gifts, notifications, story resources, and villager names
• Added cache and throttling for bell searches, dangerous structure scans, discovery scans, client cache pruning, and reputation/combat checks
• Batched discovery reporting to reduce repeated saved-data and structure lookups
• Added reputation snapshots to avoid repeated reputation/level calculation
• Refactored shared JSON parsing into common helpers for safer datapack loading
• Improved villager inventory persistence, death drops, and borrowed weapon return handling
• Restricted unsafe main-hand inventory access to prevent duplicate drops or unintended item removal
• Fixed cleanup paths for villagers leaving the level during combat/survival tracking