Repository navigation
Releases
LibertyRecompAndroid 0.5.9.3
Install over the previous version; your saves are kept.
Warning
WARNING! Mali Support is REALLY experimental and is to be expected to be shitty as possible. I don't have intentions to fix this and work on its support for now. Thanks for Mali fork and user patch suggested in #62 this is possible. You can thank these people for this. Tested only on Pixel 7 with the System default driver. Experience was ass, but it is working tho.
Experimental Mali support
- The game now starts on ARM Mali GPUs with the phone's own Vulkan driver. Without an Adreno GPU, the launcher uses the system driver instead of the bundled Turnip. A driver you import yourself (for example PanVK) is still used.
- Mali drivers have no clip distance: the game's clip planes are skipped there, so some reflections may show geometry they would normally hide.
- Mali GPUs can't read the game's DXT textures: they are decoded when loaded, which uses more memory and may stutter while new textures stream in.
- Fixed a black screen where only the HUD was drawn: Mali has no 2x MSAA, which the game asks for, so those surfaces now use 4x.
Fixed
- Resolution. Since 0.5.9.2 the game rendered at the screen's full resolution instead of the default 720p, and choosing 720p in the Display menu did nothing. 720p is applied again, which also gives some frame rate back.
- Audio stutter. Audio now opens in Android's normal mode instead of its low-latency mode, whose buffer is only a few milliseconds long. Short CPU hiccups no longer turn into gaps. Sound may be about 20 to 40 ms later than before, which you shouldn't notice.
- Pause map icons sliding on screens wider than 16:9 (#66). Blips and the GPS route on the pause menu map stay on their places while you move the cursor. The minimap during gameplay is unchanged.
- Android 10: bundled Turnip not loading ("cannot locate symbol call_once", #63). The driver uses thread functions that Android only has since version 11; the app now provides them on older versions. Not tested on an Android 10 device yet.
Also in this release (from the 0.5.9.2 pre-release, for those updating from 0.5.9)
- Vehicle damage (#46): cars show every dent, not only the first impact.
- Crash in the safehouse and other random crashes on older phones (#58): on Linux kernels older than 4.17, a memory call could silently return the wrong address.
- In-game Display menu settings apply:
args.txtno longer overrides them on every launch. On the first start, the saved shadow map size and reflection resolution are reset once (the highest shadow setting ran at about 10 FPS on a Snapdragon 865). - Launcher: Sustained performance mode, Thermal guard and Safe mode (for bug reports).
- Android performance hints, the main game thread sleeping instead of spinning while it waits for a frame, textures untiled on the GPU, and cheaper locks between game threads.
Known issues
- Heavy scenes (under the bridge, many shadows) are still CPU-bound at about 28 to 31 FPS on a Snapdragon 865.
- On Mali, the city runs slowly and audio may still stutter.
LibertyRecompAndroid 0.5.9.2
A pre-release with fixes for vehicle damage and the Display menu, plus power management options. Install over the previous version; your saves are kept.
Fixed
- Vehicle damage (#46). Cars showed only the first impact; later dents never appeared or showed up much later, sometimes on the wrong side. The game stores deformation in small textures that it rewrites in place, and the renderer kept its first copy of them. These textures are now re-read every frame when they change. There is no measurable frame rate cost.
- Crash in the safehouse and other random crashes on older phones (#58). On Linux kernels older than 4.17 (for example Snapdragon 855 phones on Android 10/11), a memory call could silently return the wrong address, and the next thread the game created crashed.
- In-game Display menu settings now apply. Resolution, upscaler (FSR), VSync, frame limit, anti-aliasing, draw distance, shadows, reflections and motion blur were overridden by
args.txton every launch. The defaults now live in the game itself, and the old default lines are removed from yourargs.txton the first start (lines you edited yourself are kept). An old 720p output cap saved in the config is removed too. - Very low FPS with high shadow settings. On the first start of this version, the saved shadow map size and reflection resolution are reset once to the defaults. The highest shadow map setting is a 5120x5120 shadow atlas that runs at about 10 FPS on a Snapdragon 865. You can raise them again in the Display menu.
New in the launcher
- Sustained performance mode: asks Android for clocks the device can hold without overheating. Steadier frame rate on long sessions, lower peaks.
- Thermal guard: lowers the draw distance when the device gets hot and restores it when it cools down. Off by default.
- Safe mode (for bug reports): turns off every renderer and timing optimization at once. If a bug goes away in safe mode, please mention it in your issue. Expect a lower frame rate.
Under the hood
- The game tells Android which threads carry each frame (Android performance hints), so the scheduler can keep them on fast cores at the right clocks.
- The main game thread sleeps instead of spinning while it waits for the next frame: the frame rate is the same, but the game uses noticeably less CPU at idle moments (about 1.4 cores instead of 2.2 at the starting save point).
- Textures are now untiled on the GPU instead of the game thread, and shader constants shared by many draws go through a uniform buffer.
- Short locks between game threads are cheaper: three game threads spent about a quarter of their time waiting on one internal lock.
- Built-in Android defaults: 720p, 30 FPS limit, FXAA, shadow map base 256, original reflection resolution, draw distance 1.0, motion blur off.
Known issues
- Heavy scenes (under the bridge, many shadows) are still limited by the CPU at about 28 to 31 FPS on a Snapdragon 865.
LibertyRecompAndroid 0.5.9
A performance release: faster game code and a lighter renderer. Install over the previous version; your saves and settings are kept.
What changed
- Faster game code. The recompiled game code keeps vector math in CPU registers instead of going through memory between instructions. Multiply-add math now runs as one fused instruction, the same way the Xbox 360 did it. The build is also tuned with a fresh profile of real gameplay.
- Lighter renderer. The render worker now prepares shader constants and texture bindings ahead of time, so the thread that records each frame for the GPU does much less work per draw. Some internal diagnostics that ran every frame are now off.
- Better GPU culling. Depth clears no longer turn off the Adreno driver's early depth rejection (LRZ) for whole render passes, and blending that changes nothing no longer disables it either.
- Less waiting between game threads. Short waits on game locks no longer give up the CPU right away.
- GPU turbo in Performance test settings: keeps the Adreno GPU at its highest clock (more heat and battery use). It is turned back off when the game exits normally.
Measured on a Retroid Pocket 5 (Snapdragon 865), compared with 0.5.8.1
- At the starting save point, recording a frame for the GPU takes about 7.4 ms instead of about 10 ms.
- In a heavy scene (under the bridge), it takes about 28.5 ms instead of about 33 ms, and the frame rate is 28.5 to 29.3 FPS. That scene is still limited by the CPU.
Results on other devices will differ. If something looks or runs worse than in 0.5.8.1, please open an issue with a debug log (Play (Debug Log) in the launcher).
LibertyRecompAndroid 0.5.8
A CPU and stability pass. Install over the previous version; your saves and settings are kept.
May be fixed or improved
- Rare crashes in long sessions. The game's lock and barrier instructions are now real memory barriers on ARM64. Before, they compiled to nothing, so on a phone one thread could see another thread's data out of order. This is a likely cause of some rare, random crashes.
- Crash after a car collision. A crash on a stale object in the game's entity list is now caught: the broken entry is skipped for that frame.
- Stutter while driving fast or streaming the city. Every time the game committed memory, the runtime parsed
/proc/self/maps(thousands of lines). It no longer does. - Smoother game logic. The game's CPU registers are now kept in native registers instead of memory. At the reference bridge on a Retroid Pocket 5, the game threads got about 3 ms lighter per frame, and frame rate went from about 26 to 28-30 FPS.
- Lighter shaders. The shader cache was rebuilt with merged conditional blocks: about 15% fewer branches on the GPU, same image.
- Faster renderer. The renderer is now built with stronger optimizations (-O3, link-time optimization, hot functions placed together). Several hot spots in the frame recorder were also made cheaper: shader constant copies, hash table lookups and per-frame allocations.
- Phones with game boosters. The app now declares Android's game modes, so Samsung Game Booster, RedMagic Game Space and other game tools recognize it as a game. Some of them limit the CPU clock of apps they don't know.
- Snapdragon 8 Elite (Adreno 830). GPU waits are now made one second at a time. That driver returns at once from an endless wait, which could freeze or corrupt the picture.
- Draw distance no longer jumps back and forth. The dynamic draw distance now changes in small, spaced steps, measured over one-second windows. Its minimum is 0.80, and older settings are migrated automatically.
For testers
- The runtime log now shows guest threads that spin on yields or locks (
yields/spins-5s=in thethermal:lines). --gta4_native_frame_timeline=truelogs per-frame stage times.
Known: in the heaviest places (the bridge at night) the frame rate can still dip to about 28 FPS. The frame recorder is the limit there.
LibertyRecompAndroid 0.5.8.1
A pre-release with experimental performance settings for weak devices. Install over the previous version; your saves and settings are kept.
Performance test settings (launcher)
A new button under Play opens settings meant only for testing on lower-end devices. They break the visuals; if you already have a stable 30 FPS, leave them alone. Issues opened with any of these settings on may be skipped.
- Draw distance 0.5: fixed half draw distance, with the dynamic draw distance off.
- Sun shadows off: the sun shadow map is not drawn.
- Water reflections and other reflections (cars, windows), set separately: every frame, every 2nd frame, every 3rd frame or off.
The settings are stored by the launcher and applied each time you press Play. args.txt is not changed.
Fixed
- With the FPS guard off (the default), the reflection update rates were reset to every frame at start.
LibertyRecompAndroid 0.5.7.8
Pre-release: Play (Debug Log) for bug reports.
- A new smaller button under Play starts the game with detailed logging and saves the game's whole log (the game, the Vulkan driver, crashes) to
Android/data/com.libertyrecomp/files/debug_logs/. Reproduce your problem with it and attach the newestdebug-*.logto your issue. This helps us a lot. - GitHub link at the bottom of the launcher.
Includes everything from 0.5.7.7 (less audio delay). Install over any earlier version; the installed game and saves are kept.
LibertyRecompAndroid 0.5.7.7
Pre-release: less audio delay.
- Sound lagged noticeably behind the picture, especially on glass breaking and car crashes (#9). The game kept up to ~340 ms of audio queued; it now keeps ~170 ms by default (
--audio_maxqframes=32). - Want it tighter? Add
--audio_maxqframes=16toAndroid/data/com.libertyrecomp/files/args.txt(~85 ms). On some devices that can make the sound stutter briefly when the game hitches, so go back to 32 if you hear that.
Includes everything from 0.5.7.6 (the game stays in landscape on phones). Install over any earlier version; the installed game and saves are kept.
LibertyRecompAndroid 0.5.7.6
Pre-release: the game stays in landscape on phones.
- On phones held upright, the game could turn to portrait right after it started, or show only a narrow strip in the middle of the screen. The cause was that the game's window allowed any orientation. It is now locked to landscape, either way round, and respects the rotation lock.
- If the game closes right after Play on Android 14 or newer (moto, Samsung and others), update: that was fixed in 0.5.7.4 and is included here.
Includes everything from 0.5.7.5. Install over any earlier version; the installed game and saves are kept.
LibertyRecompAndroid 0.5.7.5
Everything from the 0.5.7.2 to 0.5.7.4 pre-releases, plus a fix for wide phones.
Starts on Android 17 and Adreno 8xx (0.5.7.4)
- On some new devices (for example a Samsung with Adreno 840 and Android 17) the game quit right after Play with "Unable to reserve the 4gb guest address space". It used an old Android memory API that newer Android builds refuse. It now uses the current one, with a second fallback method. This is confirmed working on that Samsung.
- If the game still cannot start, it shows a dialog with the reason instead of crashing.
- Workaround for unusual devices:
LIBERTY_FORCE_MEMFD=1inAndroid/data/com.libertyrecomp/files/env.txt.
Full-screen picture on phones (0.5.7.5)
- On phones whose natural orientation is portrait, the game could start with a portrait-shaped picture: a narrow strip in the middle of the screen. It now always picks a landscape picture that fills the screen.
On-screen Xbox gamepad (0.5.7.2)
- Without a controller, a translucent Xbox 360 controller appears on screen. It hides while a gamepad is connected.
- Left stick: touch anywhere on the left half of the screen. Camera (right stick): touch anywhere on the right half. A/B/X/Y, D-pad, LT/LB, RT/RB, L3/R3, Back and Start are fixed buttons, and several fingers work at once.
- On handhelds (Retroid Pocket and similar) the overlay appears by itself when the built-in controller is switched off.
- The previous context-sensitive touch layout is still available with
--gta4_touch_layout=contextinargs.txt.
Crash reports (0.5.7.3)
- After a crash, the launcher shows a red card: The game crashed - a crash report was saved. The report (device, GPU, driver, where it crashed and the last log lines) is in
Android/data/com.libertyrecomp/files/crash_reports/. - Share report sends it as text to any app. Please attach it to Issues.
- The game's own log is now on by default (warnings and errors).
Install over any earlier version; the installed game and saves are kept.
LibertyRecompAndroid 0.5.7.1
Install the game from the launcher, now as a stable release.
- Game panel in the launcher: choose the disc image (
.iso), Title Update 8 and, optionally, the episodes from anywhere on the device or an SD card. The disc is checked as soon as you pick it, and Install shows a progress bar. Picking files outside the app's folder needs All files access once; without it, theAndroid/data/com.libertyrecomp/files/install/folder still works. - Wide screens: the launcher no longer cuts the logo in half on 20:9 and 21:9 phones.
- New logo lettering and Play button.
- Android 10 to 12: Turnip (bundled or imported) is accepted there now. Before, the "needs Vulkan 1.2" error appeared, for example on the Snapdragon 855 (#3).
- Also included: the Vulkan driver picker with .zip import, the system-driver fallback, the error dialog and
last_launch.txt.
Install over any earlier version; the installed game and saves are kept. Walkthrough: INSTALL.md.


