LumenFall Fixes 1.1.1
Minecraft 1.20.1 / Forge 47.x

BASE
====
Built directly from the exact known-working LumenFall Fixes 1.0.1.

ORIGINAL 1.0.1 FIXES PRESERVED
==============================
- Artifacts 9.5.19 null-player login packet guard.
- Wings Reborn Refitted 2.1.4 MC 1.20.1 eye-height/camera compatibility.

BOYMOD FIXES NOW LIVE HERE
==========================
You should use the ORIGINAL boymod-1.0.jar. No modified Boyfriend JAR is needed.

Missing Boyfriend textures:
- boymod itself randomly selects 0..40 but ships only 0..30.
- This LumenFall JAR supplies boyfriend31.png through boyfriend40.png under the
  boymod asset namespace.
- boyfriend31..39 are the nine supplied skins.
- boyfriend40 uses a valid existing Boyfriend skin as a fallback.

Villager LoveCraft appearances:
- Vanilla villagers keep their normal entity logic, profession, AI and trades.
- Their renderer is changed to boymod's slim humanoid renderer so 64x64 player
  skins use correct UVs.
- Each villager's UUID deterministically selects one of 90 appearances:
  * boyfriend0..40 (41)
  * girlfriend0..46 (47)
  * girlfriend_dollar_store_princess
  * girlfriend_roger
- The same villager keeps the same appearance after unload/reload/restart.

REQUIRES
========
- original boymod 1.0+
- LoveCraft / cringymod 2.2+

NOT INCLUDED
============
No Hanging Spider, LunarMobs texture, Accessories, AllTheLeaks/TIL,
Monster Hunter Villager or Starborn experimental patches.


CURIOS ENTITY SLOT SUPPORT
==========================
When Curios is installed, this jar now assigns common Curios slot types to:
- boymod:boyfriend
- cringymod:girlfriend
- humancompanions:knight
- humancompanions:archer
- humancompanions:arbalist
- humancompanions:axeguard

Registered slots:
- back
- body
- belt
- bracelet
- charm
- curio
- hands
- head
- necklace
- ring

IMPORTANT
=========
This enables real Curios inventories on those entities at the data level.
Curios 1.20+ supports all LivingEntity types, but these mods still do not have a dedicated Curios management GUI.
This is the entity-slot compatibility layer only.


VILLAGER VANILLA AMBIENT SOUND FILTER
=====================================
Only Minecraft's stock entity.villager.ambient "huh/hrmm" event is suppressed.
Different/custom SoundEvents supplied by Fantasy Factions or other mods are preserved.
This does NOT mute villager hurt, death, trade yes/no, celebrate, or profession work sounds.


HUMAN COMPANIONS + BETTER COMBAT / JEG
=======================================
Targeted versions:
- Human Companions 1.7.6
- Better Combat 1.9.0+1.20.1
- Just Enough Guns 0.14.4

Guns:
- Put a JEG GunItem in a tamed Human Companion's normal 27-slot inventory.
- LumenFall mirrors that gun into the companion's main hand.
- A real JEG GunAttackGoal is installed at priority 1, above Human Companions'
  built-in priority-2 sword/axe/bow/crossbow goals.
- Firing, projectiles, damage, sounds, burst behavior and reload timing remain
  JEG's own implementation.
- Remove the gun from the companion inventory to let its normal class weapon
  take over again.
- Guns use a two-handed aiming pose instead of the generic item pose.

Better Combat animations:
- Better Combat's own player animation stack cannot attach natively to a
  TamableAnimal. LumenFall therefore bridges Better Combat's WeaponRegistry and
  the exact 1.9.0 attack-animation keyframes supplied by the installed build
  onto Human Companions' PlayerModel/HumanoidModel.
- The companion cycles through the Better Combat attack array for its equipped
  melee weapon when its normal AI swings.
- Better Combat held-weapon pose clips are also applied where the weapon
  declares one.
- This is visual animation compatibility only; Human Companions keeps its own
  targeting, cooldowns and damage logic.

No Human Companions, Better Combat, or JEG original jar is modified.


1.1.5 METADATA FIX
==================
Human Companions 1.7.6 reports its Forge version as 1.20.1-1.7.6.
The 1.1.4 metadata incorrectly required [1.7.6,1.7.7), causing Forge to reject
the exact supported jar before startup. 1.1.5 uses the exact reported version.
No Human Companions gun/Better Combat implementation code changed.


LOVECRAFT JEG GUN SUPPORT
=========================
- Tamed Boyfriend and Girlfriend entities now treat JEG GunItem stacks as valid hand weapons.
- Right-click them with a JEG gun to equip it using their existing weapon interaction.
- Sneak + empty hand uses their existing weapon-removal path.
- While a gun is held, JEG's real GunAttackGoal is installed at priority 1.
- Their existing sword/axe behavior is unchanged when no gun is equipped.
- JEG remains optional; the compatibility helper uses reflection and becomes a no-op if JEG is absent.


1.1.24 ISOLATED FEATURE RESTORE
================================
- Stable base: 1.1.23.
- Restores only the old 1.1.7 BF/GF FollowOwnerGoal speed multiplier: 1.0x -> 1.5x.
- No other post-1.1.6 gameplay features are restored.


1.1.25 ISOLATED RESTORE: LOVECRAFT COMPANION INVENTORY
=====================================================
- Stable 1.1.24 baseline retained.
- Restores only the historical 1.1.8 BF/GF companion inventory feature.
- Shift + right-click a tamed Boyfriend/Girlfriend with an empty hand to open the 6-row inventory.
- Equipment and Curios entries remain live mirrors; remaining slots are persistent storage.
- No other post-1.1.8 gameplay features are restored in this build.


1.1.26 LOVECRAFT BETTER COMBAT ANIMATIONS
==========================================
- Boyfriend/Girlfriend companions now reuse the existing Human Companions Better Combat weapon-pose and attack-sequence animation bridge.
- Existing targeting, damage, follow, inventory, JEG behavior, and both confirmed lag fixes are unchanged.


1.1.33 - RESTORED BLESSINGS + CELESTIAL HEARTSEED VISUAL
=========================================================
- Restores the four permanent stackable Wiccan companion blessings from the original 1.1.11 implementation.
- Blessings stack Regeneration / Resistance / Swiftness / Strength from I through X on owned tamed allies and persist through reloads.
- Restores the Celestial Heartseed seed-like item model override while preserving its existing glint.
- The skipped global enchantment VIII/anvil rework is NOT included.


1.1.35 additions:
- Faunify Silk Moth light-source scan throttle (~2 idle scans/sec per goal).
- Wayward Lantern duplicate forced-chunk load dedupe; unloads remain untouched.
- Wiccan blessing items are added to the vanilla Ingredients/Search creative contents for JEI/creative discoverability.

1.1.36
- Added cached validation/fallback for Villager Patrols male/female imported LoveCraft/Boymod skin textures.
- Missing/invalid imported villager textures now fall back to a native Villager Patrols skin and log the bad path once.


1.1.38 additions:
- Respawning Animals may never force-despawn name-tagged/custom-named, persistenceRequired, Lunar-tamed, vanilla-tamed, or owned mobs.
- LunarMobs custom tames are marked persistent at tame time.
- Starborn/Celestialborn LunarLifetime expiry is skipped for tamed, named, or persistent entities; temporary untamed summons still expire normally.
- Wiccan blessing visibility now injects directly into Forge's BuildCreativeModeTabContentsEvent instead of relying on reflective listener registration.
