Homestead V3 NeoForge -- Family Hotfix v4
==========================================

WHY YOU'RE GETTING THIS
-----------------------
The Homestead server was upgraded to NeoForge 21.1.227 + Create 6.0.10 (plus
the encased drills/saws and a few new Create gadgets). Your game is still on the
old version, so you CAN'T JOIN THE SERVER until you run this update. After this,
you'll match the server again and get the new Create stuff + the usual cozy look.


  *** STEP 0 -- DO THIS FIRST (required, one time) ***
  ----------------------------------------------------
  Bump the NeoForge loader to 21.1.227 in CurseForge:

    1. Open CurseForge -> Minecraft -> your "Homestead V3 NeoForge" instance.
    2. Open the instance's options (the gear / "..." menu).
    3. Find "Loader" (a.k.a. Modloader / Game Version).
    4. Change NeoForge from 21.1.209 to 21.1.227 and let it reinstall.
    5. Fully CLOSE Minecraft.

  The hotfix below will STOP and warn you if it sees you skipped this -- because
  the new Create 6.0.10 will crash the game on the old loader. If you're not sure
  how to do Step 0, ping Drew first; it's a 30-second click but it has to be done.


WHAT THIS HOTFIX DOES (after Step 0)
------------------------------------
  NEW -- matches the upgraded server:
  - Create 6.0.10           (was 6.0.8)
  - Create Encased 1.8.1    (was 1.7.2) -- encased drills/saws/fans/deployers
  - Create: Extra Gauges    -- extra stress/speed readouts
  - Create: Deployer API    -- required by Extra Gauges
  - Create: Shuffle Filter  -- per-slot logistics filter
  - Create: Enchantable Machinery -- Efficiency/Fortune/Silk Touch on drills+saws
  - Iris Flywheel Compat    -- shaders + Create render together without glitches
  - Armor Hider             -- matches the server's armor display

  ALSO (the "Cute n Cozy" look + client features, unchanged from before):
  - Resource packs: Overgrown Flowery GUI, Icons, Fancy Crops, Mahi's Better Sky
  - Iris Shaders + Sodium (+ Extras / Options API / Reese's Options)
  - ImmediatelyFast, 3D Skin Layers, GJEB brightness, Freecam, LambDynamicLights
  - Cosmetic Armor Reworked (2nd set of cosmetic armor slots, synced via server)

It removes the OLD Create 6.0.8 + Create Encased 1.7.2 for you automatically.


HOW TO RUN (Windows -- easy way)
--------------------------------
1. Make sure you finished STEP 0 and Minecraft is CLOSED.
2. Extract the entire hotfix zip somewhere (Desktop is fine).
3. Double-click "Run-FamilyHotfix.bat".
4. Confirm when it shows the V3 instance it found.
5. Launch Minecraft V3 and rejoin the server.

The .bat just runs the PowerShell installer with the right execution-policy flag
so Windows doesn't block it. No admin needed. Safe to run more than once --
it hash-skips anything already correct.


ALTERNATIVE (PowerShell direct)
-------------------------------
1. Make sure STEP 0 is done and Minecraft is CLOSED.
2. Right-click "Apply-V3-FamilyHotfix.ps1" -> "Run with PowerShell".
   If Windows blocks it: right-click -> Properties -> tick "Unblock" -> OK.

PREVIEW (no changes)
--------------------
  .\Apply-V3-FamilyHotfix.ps1 -DryRun

MANUAL OVERRIDE
---------------
  .\Apply-V3-FamilyHotfix.ps1 -InstancePath "C:\full\path\to\Homestead V3 NeoForge"
  .\Apply-V3-FamilyHotfix.ps1 -Force   (skip the prompts -- only if you KNOW the loader is 21.1.227)


ROLLBACK
--------
The script backs up your mods folder, resourcepacks folder, AND options.txt to:
  <instance>\mods-backups\pre-family-hotfix-<timestamp>\
To undo: copy the backed-up files back into place (with Minecraft closed). The
NeoForge loader can be set back to 21.1.209 in CurseForge the same way as Step 0.


QUESTIONS
---------
Ping Drew on Discord.
