Homestead V3 NeoForge -- Client Extras Hotfix
==============================================

WHAT THIS DOES
--------------
Adds 12 client-only mods to a V3 NeoForge install (the v0.4.0-Alpha pack
mirrors only what's on the server; these are graphics + QoL mods that
don't need to be server-side):

  Iris Shaders          Shader loader -- drop Complementary Reimagined etc.
  Sodium                Renderer perf
  Sodium Extras         Sodium QoL features
  Sodium Options API    Library for Sodium addons
  Reese's Sodium Options Better Sodium settings GUI
  Iris Flywheel Compat  Iris + Create's Flywheel rendering compatibility
  ImmediatelyFast       More rendering perf
  3D Skin Layers        Skin visuals (3D hats, jackets, etc.)
  GJEB                  Brightness slider boost beyond vanilla
  Freecam               Detach the camera and fly around (client-only)
  LambDynamicLights     Held/dropped torches and glowing items emit light
  Create: Dynamic Lights Create blaze burners / lit blocks emit dynamic light

None of these go on the server. Safe to add to any V3 install.

HOW TO RUN (Windows)
--------------------
1. Extract the entire hotfix zip somewhere (Desktop is fine).
2. Make sure Minecraft is CLOSED.
3. Right-click "Apply-V3-ClientExtras.ps1" -> "Run with PowerShell".
   (If Windows blocks it: right-click -> Properties -> "Unblock" -> OK.)
4. Confirm when it shows the mods folder it found.
5. Restart Minecraft -- enjoy shaders + dynamic lights.

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

MANUAL OVERRIDE
---------------
  .\Apply-V3-ClientExtras.ps1 -ModsFolder "C:\full\path\to\mods"
  .\Apply-V3-ClientExtras.ps1 -Force  (skip y/N prompt)

ROLLBACK
--------
The script always backs up your current mods folder to:
  <instance>\mods-backups\pre-v3-clientextras-<timestamp>\

Restore by copying the .jar files from that backup folder back over the
mods folder.

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