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.
