HIDEWAY 2.1.1  -  tester build (stable channel, 2026-10-29)
======================================================================

What this is
  Hideway is a Fortnite overlay that runs on the game PC's second machine and reads the game over a DMA card (read-only), then draws on a transparent
  overlay. This folder is a ready-to-run build: you do NOT need the source code, a compiler or any developer tools.

What you need
  - Windows 10 or Windows 11, 64-bit. (Tested by the publisher on Windows 10 22H2; other versions are untested.)
  - The hardware the program is built for (DMA card, input device). Without it the program still starts; use  Hideway.exe --demo  to look around the interface
    with synthetic data (no license, no card).
  - A license key (or a KeyAuth account with an active subscription) from the publisher. You received it separately. Never post it anywhere.
  - Administrator rights (Windows asks once; the DMA transport needs them).
  - An internet connection (license check, update check).

First start
  1. Unzip/copy this folder somewhere you own (for example D:\Hideway). Do not run it from inside the zip. Keep HidewayLauncher.exe and the core folder together.
  2. Optional: check the download (see "Verify" below).
  3. Double-click HidewayLauncher.exe (the only program at the top of the folder; everything else is inside core\) and accept the Windows administrator
     prompt. The launcher is the front door for every Hideway game:
       - Library   one card per game ("Fortnite" today, more games soon). Launch checks the game's files against the publisher's signed manifest first
                   and starts it. "Verify files" re-checks on demand; "Restore the files" sends you to Updates when something was changed or deleted.
       - System    real checks of this PC (Windows, administrator, DMA runtime files, the DMA card's USB bridge, input device, updates) with one "Next:" line
                   for anything not green, and "Copy diagnostics" for support (no key, no user name inside).
       - Updates   signed releases only; installing needs your click and a bad update rolls back by itself. Settings and About complete it.
     You never need to start anything inside core\ by hand; the launcher starts the game for you.
  4. Sign in with ONE of:
       - your license key (type or paste it, then Activate; "Remember on this device" stores it encrypted for your Windows account only), or
       - the website: sign in on the Hideway website / customer panel and press the Web Loader button. The app must already be open on its sign-in screen.
         (It listens on 127.0.0.1 port 1337 only. If another program uses that port the sign-in screen tells you; the license key still works.)
  5. After signing in the overlay starts. INSERT opens the menu, END exits (both can be changed in MISC).

Is everything connected?  (READY CHECK)
  Open the DEBUG page: the READY CHECK card at the top lists DMA card, Fortnite, game data, camera, input device and offsets, each green / orange / red, with
  one "Next:" line for the first thing to fix. The same card also shows at the top of the AIMBOT page until everything is ready.
    DMA card  red      the card does not answer: accept the administrator prompt, use a USB 3 port on the motherboard, power the game PC, close other programs that use
                       the card (MemProcFS, other tools), check the FTDI driver in Device Manager. Hideway retries by itself every 2 seconds and reconnects if the
                       cable drops later.
    Fortnite  orange   the card works but the game is not running on the game PC yet: start Fortnite there and wait for the lobby.
    Game data red      the game is running but its structures were not found 90 s after it started: this Fortnite build is newer than the offsets in the all\ folder.
                       Update Hideway (CONFIG -> UPDATES).
    Input     red      aim or trigger is on but the input device is off or not connected: MISC -> INPUT DEVICE.
  The top bar says DMA OFFLINE (card), WAITING FOR FORTNITE (card ok, game not found) or DMA ONLINE.
  Black screen when you start? VISUALS -> HUD -> "Fuser mode" puts a pure-black window under the overlay for capture-card setups; switch it off if you do not
  use a capture card.
  Player names show the real display names when the game gives them; if they look anonymous the LIVE LOG (DEBUG) says which field is being read.

Updates
  The app checks for new signed releases by itself (CONFIG page -> UPDATES). A new version is downloaded in the background and checked against the
  publisher's signature and SHA-256 hashes; nothing is installed until you press "Restart to install". If the new version does not start, the previous one is
  restored automatically (or use "Restore previous version"). Your configs\ folder and license/remember data are never overwritten.
  The update address is in update_source.txt (one https line). While it is empty or starts with # automatic updates are off.

Verify this download (recommended)
  Open PowerShell in the core folder and run:
      powershell -ExecutionPolicy Bypass -File .\verify_package.ps1 -ExpectedFingerprint <fingerprint from the download page>
  It checks the publisher's signature on release.json and the SHA-256 of every file.

Testing checklist (please report what you see; no screenshots of your key)
  [ ] Hideway.exe starts and shows the sign-in screen
  [ ] a wrong key is refused with a message; your key signs in
  [ ] sign-in through the website button works (app open first)
  [ ] CONFIG -> UPDATES shows the installed version and a status line
  [ ] closing and reopening keeps you signed in only if you ticked "Remember"
  [ ] Sign out returns to the sign-in screen

If something goes wrong
  - hideway.log (next to Hideway.exe) is a plain-text log. It never contains keys or tokens. Send it with your report.
  - update\updater.log holds the installer's log after an update.
  - "Could not start" screen: read the line shown, press Retry. Most causes: no internet, wrong system clock (must be within 25 s), missing DMA hardware.
  - SmartScreen warning: the programs are not Authenticode-signed yet. Verify the download as above before choosing "Run anyway".
  - An update was interrupted (power cut): start Hideway again, it restores the previous version by itself. If Hideway.exe will not start at all, run
    HidewayUpdater.exe --recover.

Privacy
  The app contacts: KeyAuth (license check) and the release host in update_source.txt (update check). It sends your license key to KeyAuth only, plus a
  hardware identifier KeyAuth uses to lock a license to one PC (your Windows account SID). Nothing else is uploaded. Settings stay on your PC.

Contents of this folder
  HidewayLauncher.exe (top level)         starts core\HidewayLauncher.exe, the multi-game hub; this is the only program you run
  Everything below is inside the core folder:
  HidewayLauncher.exe                     the multi-game hub itself (kept current by signed updates); modules\modules.json is its game catalog
  Hideway.exe, HidewayUpdater.exe         the Fortnite module and the installer for updates
  vmm.dll, leechcore.dll, FTD3XX.dll     DMA runtime (MemProcFS / LeechCore / FTDI); their hashes are checked at every start
  dbghelp.dll, symsrv.dll                Microsoft debugging runtime used by MemProcFS for symbols
  VCRUNTIME140*.dll, MSVCP140.dll        Microsoft Visual C++ runtime, application-local (so no separate install is needed)
  all\                                   game structure data (offsets)
  configs\                               created on first start with the factory defaults; your own configs are kept on update
  release.json, release.sig, release_public_key.b64, verify_package.ps1   release integrity material
