================================================================
 YunaMS Linux Patcher
================================================================

This archive contains the YunaMS game patcher, built to run on
Linux via Wine or Proton.

----------------------------------------------------------------
 Requirements
----------------------------------------------------------------

  - A working YunaMS game install (YunaMS.exe + the .wz files)
  - Wine, Proton, or Bottles with Proton GE 10-34 or newer

----------------------------------------------------------------
 Install
----------------------------------------------------------------

  1. Extract this archive.
  2. Copy "Patcher.exe" into your YunaMS install folder -- it
     should sit next to YunaMS.exe and the .wz files.
  3. If you had an older Patcher.exe, overwrite it.

----------------------------------------------------------------
 Running (Bottles)
----------------------------------------------------------------

  1. Open your YunaMS bottle (Win64, Gaming).
  2. Add Patcher.exe via "Run Executable..." or as a program.
  3. Launch it. It will check for updates, download any that are
     available, and show "Update complete" when done.
  4. Close the patcher by clicking the X in the top-right corner.
  5. Launch YunaMS as normal.

----------------------------------------------------------------
 Running (Wine / Proton)
----------------------------------------------------------------

  From a terminal, inside the YunaMS folder:

    wine ./Patcher.exe

  Or via Proton:

    proton run ./Patcher.exe

----------------------------------------------------------------
 Settings
----------------------------------------------------------------

  Click the gear icon in the top-right to change resolution,
  window mode, FPS cap, WASD remapping, quickslots, and more.
  Settings save automatically on each toggle and write to
  "settings.ini" in the game folder.

----------------------------------------------------------------
 If something goes wrong
----------------------------------------------------------------

  The patcher writes log files next to Patcher.exe:

    PatchLogs/logs-YYYYMMDD.txt   -- normal run log
    patcher-crash-*.log           -- present ONLY on crashes
    patcher-env-*.log             -- environment snapshot
                                     (every run, normal)

  If the patcher crashes, grab the latest patcher-crash-*.log
  file and share it in #support on our Discord. Include your
  Wine/Proton version too -- that is usually the first thing we
  need to reproduce the issue.

----------------------------------------------------------------
 Support
----------------------------------------------------------------

  Discord:  https://yuna.ms/discord
  Website:  https://yuna.ms

================================================================
