MCA x Minecolonies Integration

[1.0.1] - 2026-11-09

🏷️ Name Tags & Indicators

• Fixed Missing Citizen Nameplates: Fixed an issue where citizen name tags, job titles, and MineColonies status icons (e.g., sickness, hunger, missing tools) above citizen heads disappeared when using MCA models.
• HUD Indicator Optimization: Shadowed and re-invoked RenderBipedCitizen.renderNameTag directly inside CitizenRendererMixin, respecting both MCA's nameTagDistance/showNameTags settings and MineColonies' visible status distance checks.
• Smart GUI Name Tag Culling: Automatically hides 3D floating nametags when rendering citizen avatars inside dialogue and customization GUIs (InteractScreen, VillagerEditorScreen, LimitedVillagerEditorScreen, etc.) to prevent nametags from clipping over UI elements.

💖 Heart & Dialogue Balance

• Fixed Instant 50-Heart Jump: Completely resolved the critical issue where chatting once with a Citizen immediately jumped hearts from 0 to 50:
  • Corrected stranger memory initialization in VillagerBrain so newly met citizens start at 0 hearts instead of defaulting to 50.
  • Aligned hearts and fatigue increments with MCA Reborn's balanced reward formulas across dialogue options (chat, joke, story, flirt, compliment).
  • Synced hearts and interaction fatigue bidirectionally between CitizenMCAData and VillagerBrain.Memories per-player.

🤖 AI, Movement & Task Synchronization

• Fixed Follow / Stay AI Conflicts:
  • Added persistent moveState (MOVE, FOLLOW, STAY) saved into citizen NBT.
  • Sided execution now pauses MineColonies' state machine AI (citizenData.setPaused(true)) when ordered to Stay or Follow, preventing job AI (Builder, Miner, Guard, etc.) from pulling citizens away while following the player.
  • Resuming work (Move freely or Go home) automatically unpauses the citizen (citizenData.setPaused(false)).
• Persistent AI Across Chunk Reloads: Citizens under Stay or Follow orders maintain their state across world saves, server restarts, and chunk unloading.

👶 Growth, Maturation & Gender Sync

• Bidirectional Child-to-Adult Maturation:
  • Accelerated child growth (via Golden Apples, Cake, Cookies, Apples) and natural age ticking now update citizen.setIsChild(false), DATA_IS_CHILD, citizen.getCitizenData().setIsChild(false), VillagerLike.AGE_STATE, and invoke refreshDimensions() concurrently.
  • Children grown into adults can now be immediately assigned to colony jobs and workplaces without desync or invalid worker states.
• Full Gender Synchronization:
  • Potion of Femininity and Potion of Masculinity now sync both MineColonies citizen data (citizenData.setGender) and MCA genetics (Genetics.setGender), updating voice lines, registry data, and 3D slim/classic models simultaneously.

👗 Appearance, Hairstyles & Dye Priority

• Uniform vs. Custom Style Layering:
  • Fixed an issue where loading chunks forced customized=true and prevented citizens from adopting MineColonies job uniforms.
  • Citizens now properly wear job-specific MCA outfits mapped from MineColonies professions (miner, guard, farmer, weaponsmith, etc.) unless customized via the Villager Editor.
  • Children correctly cycle through stage-appropriate outfits (baby \(\rightarrow\) toddler \(\rightarrow\) child).
• Styling Item Fixes:
  • Dyes (DyeItem): Now update data.setHairColor and vl.setHairDye simultaneously.
  • Comb / Shears: Cycles hairstyle and immediately updates hair textures without being blocked by stale custom paths.
  • Needle & Thread: Cycles clothing styles and clears stale editor overrides so uniform changes show immediately.

🧠 Personality & Mood Bridge

• Personality Mapping:
  • Added CitizenMCAData.getMCAPersonality() to cleanly bridge all 15 MCA personality types (FRIENDLY, FLIRTY, PLAYFUL, SERIOUS, SHY, BRAVE, etc.).
  • Synced citizen personality directly into VillagerBrain, ensuring speech dialogue options and gift taste preferences align with actual citizen traits.
• Colony Happiness \(\leftrightarrow\) MCA Mood Sync:
  • Mapped MineColonies citizen happiness (0.0 - 10.0) to MCA VillagerBrain mood levels (-15 to +15).
  • Successful dialogue interactions and accepted gifts now grant small saturation boosts to citizens (increaseSaturation), improving overall colony happiness.

🌳 Family Tree & Marriage Safety

• Colony Partner Marriage Safeguard:
  • Players can no longer propose with Engagement/Wedding Rings to citizens already married within the Colony (citizenData.getPartner() != null).
• FamilyTree Registration:
  • Added CitizenRelationshipHelper.syncColonyFamilyTree(...) to sync MineColonies spouses and children into MCA Reborn's FamilyTree / FamilyTreeNode.
  • Opening the Family Tree item displays citizen lineage and colony marriages accurately.
• Birth & Genetic Inheritance:
  • Enhanced ReproductionManager via mixin: newborn colony children automatically register in the MCA Family Tree and inherit skin tone (melanin, hemoglobin), hair color, and features from their parents.

💾 Respawn & Recall Data Persistence

• Citizen Data Backup:
  • Added colony-keyed backup caches (COLONY_CITIZEN_BACKUP and COLONY_TRACKED_BACKUP) indexed by colonyId:citizenId.
  • If a citizen entity is reconstructed (such as during church resurrection, Town Hall recall, or unstuck respawns), MCA appearance, genetics, and relationship memories are restored automatically instead of being wiped.

🖥️ Client & Server GUI Alignment

• Server-Authoritative Editor:
  • CitizenClientScreens.openCustomizationScreen now directs to LimitedVillagerEditorScreen, ensuring appearance changes send C2S sync packets to the server.
  • CitizenDialogueScreen.init() redirects to native MCA InteractScreen, eliminating client-only visual desyncs.