======================================================================
 GAMEVAULTX.CLOUD - CastleMiner Z ESP + Aimbot + Visuals
 Free build - no keys, no activation, nothing to buy. Just works.
======================================================================

WHAT THIS IS
  A mod for CastleMiner Z (Steam, latest patch) that gives you:
    - ESP boxes around players, all mobs, and the dragon
    - Skeleton wireframes (humanoids + dragons) inside the boxes
    - World tracer line + distance + name above every entity's head
    - AIMLOCK crosshair: teal by default, turns RED while locked
    - FOV ring (orange circle) showing the aimlock's acquisition zone
    - Ring arrows: arrows + live distance pinned to the FOV ring,
      pointing at players, mobs, and the dragon you can't see yet
    - EXTERNAL CONTROL PANEL (GameVaultX Control.exe) - a desktop
      window with every toggle: VISUALS / AIM / COLOR sections
    - AIM LOCK (F10) - smooth-tracks your mouse onto the nearest
      enemy, F11 cycles to the next target

  Works in singleplayer and multiplayer. Totally client-side,
  no license check, no keys, no watermarks. Settings save to disk
  and hot-reload while you play.

FILES IN THIS FOLDER
  !Mods\CMZESP.dll               <- the esp/aimlock mod itself
  !Mods\ModLoaderExtensions.dll  <- required helper (auto-loads CMZESP)
  ModLoader.dll                  <- the mod loader framework
  ModLoader.ini                  <- loader config (auto-launch, remember games)
  CastleMinerZ.exe.config        <- .NET config override (required)
  Update&Launch.bat              <- one-click install + launch
  GameVaultX Control.exe         <- EXTERNAL settings panel (run anytime,
                                        even while the game is open - it
                                        hot-reloads into the game live)
  source\                        <- full C# source if you want to modify it

INSTALL (friends)
  1. Extract the whole folder anywhere (keep the !Mods folder intact).
  2. Close CastleMinerZ if it's running.
  3. Double-click "Update&Launch.bat". It copies everything into
     your Steam CastleMiner Z folder and starts the game.
     If it can't find the game, edit the bat and set:
       set GAMEDIR=C:\Program Files (x86)\Steam\steamapps\common\CastleMiner Z
     then run it again.
  4. Start "GameVaultX Control.exe" - every setting is a click or a
     slider. Changes apply to the game LIVE (the config file next to
     the mod hot-reloads every second or so).
  5. You'll see the magenta "ESP OK" self-test box in the first second.

  Manual install instead: copy ModLoader.dll, ModLoaderExtensions.dll,
  CastleMinerZ.exe.config and !Mods\CMZESP.dll into your game folder,
  and GameVaultX Control.exe anywhere you like.

CONTROLS (in-game hotkeys, still work while panel is external)
  F5                 toggle player boxes
  F6                 toggle mob boxes
  F7                 toggle dragon box
  F8                 cycle: boxes -> tracers only -> names only -> off
  F9                 toggle skeleton wireframes
  F10                AIM LOCK on/off (same switch as right-mouse click)
  F11                cycle aimlock target (nearest -> next -> next)
  F4                 open/close the IN-GAME menu (mouse-clickable:
                     toggles, sliders + color steppers; every click
                     writes the same shared config as the panel)
  Chat               /esp color R G B - custom ESP color

OVERLAY NOTES
  Crosshair: always drawn at screen center; teal = scanning,
  red = aimlock actively locked on a target.
  FOV ring: orange circle around the crosshair - anything inside the
  ring is inside the aimlock's acquisition zone. Ring arrows hug the
  ring (one color per category: teal players, red mobs, orange dragon)
  with a live distance readout.
  All layers can be switched off in-game (F4 menu) or in the external panel.

AIM LOCK NOTES
  - RIGHT MOUSE CLICK is the aimbot switch: one click arms it, another
    click disarms it (F10 does the same). While armed, it aims at the
    nearest target INSIDE the orange FOV ring only - nothing outside the
    ring is ever locked, so it never yanks you around.
  - DEFAULT: mouse-only aim ("Move head cam directly" = OFF). The aimbot
    moves the physical mouse and the game's own input turns the view - it
    NEVER writes your head camera directly, so no teleporting/lurching.
  - Want the old aggressive direct-camera aim back? Tick "Move head cam
    directly" in the F4 menu / control panel, or set aimhead=1 in config.
  - The crosshair turns red while locked. F11 force-cycles the lock to
    the next target (even off-ring).
  - "Aim speed" slider tunes how hard it pulls (45% = default).
  - Prefer F10-only control? Set aimrmb=0 in CMZESP.config (or untick
    "RMB click = aimbot switch" in the F4 menu / control panel). F10
    always works as a backup either way.

THE EXTERNAL PANEL
  Run GameVaultX Control.exe:
    VISUALS  - players / mobs / dragon / show-ESP-on-ME / boxes / skeletons /
             tracers / names
    AIM      - aimlock toggle, crosshair, FOV ring, ring arrows,
               FOV size slider (50-300px), aim speed slider (5-95%)
    COLOR    - red / green / blue sliders + live color swatch
  It reads + writes the same CMZESP.config file the mod uses, so the
  panel and in-game hotkeys never fight - last write wins, both sides
  auto-refresh. Tip: pin it next to your game window on a second
  monitor and tweak live.

"Show ESP on ME" (panel) / "Self ESP" (in-game F4 menu) draws the magenta
  self-test box/skeleton/tracer around your own character (proof the 3D
  pipeline is alive). Uncheck to hide it.

PRESETS  - PRO / FULL / STEALTH / MIN / AIMBOT one-click profiles.
           Slots 1/2/3: left-click to load, right-click to save current.
           Custom saves live in "GameVaultX Presets.txt" next to the panel.
           Changes sync instantly (no polling - file watcher).

EXTERNAL RENDERER - REMOVED FOR GOOD
- The ESP renders 100% IN-GAME: boxes, skeletons, tracers, names,
  FOV ring, crosshair, ring arrows. Zero extra apps, zero windowed-
  mode requirements, works in fullscreen too.
- The old shared-memory overlay (GVX ESP Overlay.exe) is gone and no
  longer ships. Do not expect it; do not need it.
- The panel's external-renderer toggle is gone too - nothing to turn
  on or off. F10 aimlock works regardless.
- In-game menu: press F4 for the clickable ESP settings panel.

TROUBLESHOOTING
  Nothing appears: check <game folder>\!Logs\ModLoader.log for any
  "CMZESP:" line and paste it to whoever sold you this.
  Antivirus sometimes flags mod dlls with generic "hacktool"
  heuristics - add an exclusion and restore from quarantine. The mod
  is unsigned because it hooks the game; that's normal for mods.

REBUILDING FROM SOURCE (tinkerers)
  Open source\CMZESP.csproj in Visual Studio, x86 + Release, build.
  Output: source\bin\x86\Release\!Mods\CMZESP.dll - copy over the
  game's copy.

  GameVaultX - free, no keys, no locks, no BS.