LBCS Port — Windows x86-64 (experimental)
==========================================

This is the engine and its host, built for Windows with MinGW-w64, and it is
the same engine the Linux AppImage runs. There is no launcher here: the Slint
launcher is Linux-only, so on Windows nothing installs or extracts an APK for
you. You supply the extracted files yourself (see below) and run Play.bat.

This build is labelled experimental because of how it was verified. It renders
under Wine: 120 frames of real gameplay, a capture written, exit code 0, no
fault and no abort, byte-identical to the same run repeated. It has not been
run on real Windows hardware, so first-run differences in drivers, audio
devices or the Desktop Window Manager are unknown.


What you need
-------------
- Windows 10 or later, 64-bit.
- A GPU driver with OpenGL 3.0 or later. The engine creates a GL 3.0 ES
  context through SDL and translates the guest's GLES 2 calls itself.
- Your own legally obtained copy of the Android version of Grand Theft Auto:
  Liberty City Stories, build 2.4.379. Other versions are rejected, because
  the bridge uses version-specific addresses. No game data is included here
  and none may be redistributed with it.
- Roughly 2 GB of free disk space and 2 GB of RAM.


Setting up this folder
----------------------
An .apk is a zip file. Extract it with any archive tool (7-Zip, WinRAR, or
`tar -xf` in PowerShell) and place the pieces like this:

    LBCS-Port-windows-x86_64\
        assets\                 <- the APK's assets\ contents
            data_main.wad
            data_music.wad
            ...
        android-libs\           <- from the APK's lib\arm64-v8a\
            libGame.so
            libopenal.so
            libVendor_mpg123.so
        arc_boot.exe
        SDL2.dll
        OpenAL32.dll
        libmpg123-0.dll
        Play.bat
        README-WINDOWS.txt

All three libraries are required, not just libGame.so. The C++ standard
library the game was built against is shipped inside libopenal.so -- 183
`basic_string` symbols live there and none in libGame.so -- so a library
directory with libGame.so alone traps on an unresolved import before the first
frame.

If your copy keeps the game data in a separate OBB archive, extract that too
and put its WAD files in assets\ alongside the others.

Then double-click Play.bat. It runs:

    arc_boot.exe --lcs --assets="<this folder>" "android-libs\libGame.so"


Controls
--------
Defaults, all rebindable from the settings panel:

    W / A / S / D   move
    Shift           sprint
    Space           handbrake
    Mouse           camera / aim
    Left mouse      fire            (keyboard alternative: left Ctrl)
    Right mouse     aim             (keyboard alternative: R)
    Wheel           change weapon   (off / weapons / camera vertical -- setting)
    C               change camera
    F               enter or leave a vehicle
    Q / E           look left / right
    Arrow up/down   look up / down
    Enter           confirm
    P               the guest's L1 (pad button 6)
    Escape          the game's pause menu in play; the settings panel elsewhere
    F2              the settings panel, at any time
    F11             toggle fullscreen (also Alt+Enter)
    Tab             toggle frame capture

With free aim switched on, holding the aim button gives you the camera instead
of locking onto a target, so you can aim anywhere and still walk.

Settings live in desktop-controls.conf next to the executable and apply the
moment they are changed; there is no restart. The panel can be worked with the
keyboard, the mouse wheel, or the mouse, and an FPS meter can be switched on
in the top-right corner.


Troubleshooting
---------------
- "No game data found" from Play.bat: assets\data_main.wad is missing. It is
  inside the APK's assets\ folder, or inside the OBB.
- The window opens and then closes: run Play.bat from a command prompt to see
  the engine's own message. The most common cause is a missing library in
  android-libs\ -- see the note above about libopenal.so.
- No sound: OpenAL32.dll in this folder is the one built by the project (see
  licenses\). A different OpenAL32.dll on PATH is not used unless you put it
  beside the executable; if you replace it, keep the one shipped here, because
  stock MinGW builds of OpenAL Soft abort the process when the game closes its
  audio device.
- A crash or a black frame is worth reporting with the last lines Play.bat
  printed, the GPU model and its driver version.


Licences
--------
This port is GPL-3.0-only; see licenses\LBCS-Port-GPL-3.0.txt. SDL2 and OpenAL
Soft are bundled with their own licences in licenses\, and the full list of
third-party components is in THIRD_PARTY_NOTICES.md. The game itself is not
included, is not covered by any of these licences, and remains the property of
its rights holders.
