MHODUME — Linux (experimental)
==============================

This is the Linux build of the Mhodume config app plus the game-side mod.
It is EXPERIMENTAL and the whole flow is UNTESTED end to end — see the warning.

The game runs through Proton (Steam Play). The app is a native Linux window you
alt-tab to, not an in-game overlay, so play the game BORDERLESS-WINDOWED.

! THE BIG UNKNOWN — read first !
--------------------------------
The mod loads through UE4SS, which is Windows software running inside Proton's
Wine layer. Whether UE4SS injects under Proton for THIS game has not been
confirmed. If it does not, nothing below will show anything in game. Test that
first: install the mod (step 2), launch the game, and check whether the mod's
crosshair/checkpoints appear at all.


WHAT IS IN HERE
---------------
  Mhodume                            the config app (self-contained, no .NET to
                                     install). Native Linux binary.
  Copy into game - Binaries Win64/   the mod: dwmapi.dll and the ue4ss folder.


INSTALL (once)
--------------
1. Make the app runnable:
       chmod +x Mhodume

2. Install the mod into the game. The game files sit in your Steam library, the
   same layout as on Windows:
       ~/.steam/steam/steamapps/common/VHOLUME/VHOLUME/Binaries/Win64/
   (a Flatpak Steam is under ~/.var/app/com.valvesoftware.Steam/…). Copy the
   CONTENTS of "Copy into game - Binaries Win64" — the file dwmapi.dll and the
   folder ue4ss — straight into that Win64 folder.

3. Launch VHOLUME once through Steam so Proton creates its prefix.

4. Tell Proton to load our loader, not Wine's built-in one. In Steam:
   VHOLUME -> Properties -> Launch Options, paste:

       WINEDLLOVERRIDES="dwmapi=n,b" %command%

   Without this, Wine may load its own dwmapi and the mod never starts. This is
   the single most important step for the mod to load under Proton.


USE
---
1. Launch VHOLUME through Steam (Proton). With the loader present you are in
   training: the tools work and times are NOT submitted.

2. Run the app:
       ./Mhodume
   Open its About page: it should say it is bridged to VHOLUME's Proton prefix —
   that means the config it writes reaches the game. If it says no prefix was
   found, launch the game once first (step 3 of install), then reopen the app.

3. Play borderless-windowed; alt-tab to the app to change the crosshair,
   checkpoints, trajectory, and to see the NPC tracker.


PLAYING FOR REAL TIMES
----------------------
There is no launcher on Linux to switch modes. Training never submits times. To
play clean, remove dwmapi.dll from that Win64 folder; put it back to train
again. The game must be closed to add or remove it.


NOTES
-----
- The app finds Steam by walking the usual library locations. If it cannot find
  the Proton prefix, it still runs and edits config, it just cannot reach a game
  that has never been launched through Proton.
- Exclusive fullscreen hides everything on top; use borderless-windowed.
