Many players who have long completed the main story Grand Theft Auto: San Andreas on mobile devices seek to diversify the gameplay with new features. It is for these purposes that the modder community has developed a library CLEOthat allows you to implement custom scripts into the game. However, unlike the PC version, transferring this functionality to the Android platform is associated with a number of technical nuances that must be taken into account for correct operation. In this manual, we will look in detail at how to properly prepare the file system of your smartphone and integrate the necessary components.
It is worth noting right away that the standard version of the game from Google Play or the AppStore does not support third-party modifications out of the box. You will need a special version of the installer or manually replacing the system files. The process requires care, since an error in the file paths can lead to the application simply not starting or crashing when loading a save. We will look at safe integration methods that minimize the risks of data loss.
Before starting any manipulations, make sure that you have a backup copy of the original game files. This is a critical step, as restoring functionality after a failed mod installation may require a complete reinstallation of the application. If you are ready to experiment and want to access teleportation, vehicle spawning or weather changes, then follow the recommendations below.
Preparing the file system and selecting the game version
The first and most important step is to understand the directory structure on your device. In modern versions of Android, access to root folders is limited by security policies, which makes working with game files more difficult. You will need a file manager with advanced rights, for example ZArchiver or MT Manager. These tools allow you not only to view archives, but also to correctly move files to protected system directories.
You need to determine which version GTA San Andreas is installed on your smartphone. There are main variations: a licensed version for new Androids, an old version for legacy devices, and modified builds from enthusiasts. The path where the libraries will need to be copied depends on this. In most cases, on new devices the path looks more complicated due to restrictions on access to the folder Android/data.
⚠️ Attention: On Android 11 and higher, access to the folder
Android/data/com.rockstargames.gtasamay be blocked by standard explorers. Use special file managers that request permission to access this directory through a system dialog.
If you are using an older version of the game, the files are often located directly in the root of the internal memory in the folder com.rockstargames.gtasa. For new versions the path is deeper: Android/data/com.rockstargames.gtasa/files/. Incorrect file placement is the most common reason why scripts don't work. Make sure that you copy the files exactly to the directory that corresponds to your build.
Installing the CLEO library for Android
The library itself is not a game, it is a set of tools (DLL libraries for PCs and SO libraries for Android) that intercept the execution of the game code. To activate this functionality, you need to download the current archive CLEO Android. It is important to choose a version that is compatible with your processor architecture (usually armv7 or arm64), although modern packages often contain libraries for all types of devices.
After downloading the archive, unzip it. Inside you will find files with the extension .so. It is these files that need to be placed in a folder libs inside the game directory. The path may look like .../files/libs/ or .../lib/ depending on the structure of your version of GTA. If the folder libs does not exist, it must be created manually, respecting the case of letters.
☑️ Checking the library installation
Some users prefer to use ready-made installers in the format .apk, which automatically detect the path and copy the files. This simplifies the process, but such installers may not work on devices with a newer OS version due to file system access restrictions. The manual method via ZArchiver remains the most reliable way to ensure that the files are delivered exactly as intended.
Placing scripts and managing mods
Once the base library is installed, you can proceed to installing the scripts themselves. Mod files have the extension .cs. They must be placed in a specially created folder cleo at the root of the game directory. It is important not to confuse this folder with the system library directories - the scripts are located separately from the files .so.
The folder structure should look like this: a directory is created inside the main game folder cleowhere you place the script files. When the game starts, it scans this folder and connects the modules it finds. If you downloaded the mod as an archive .zip or .rar, it must be unpacked, leaving only the file .cs and accompanying resources (textures, models), if they are in the instructions.
| File type | Where to copy | Purpose |
|---|---|---|
libcleo.so |
.../files/libs/ |
Main library |
script.cs |
.../cleo/ |
Mod script |
script.ini |
.../cleo/ |
Script configuration |
texture.txd |
.../models/ |
Textures (optional) |
Please note that some complex mods require additional libraries, for example Android Multi Script or Plugin_Sa. In this case, the files of these plugins are also copied to the folder libs, similar to the main CLEO library. Always read the file readme.txtthat often comes with a mod, it contains specific installation requirements.
What to do if the cleo folder is not created?
If the game does not automatically create the cleo folder when you first launch it, create it manually using a file manager. Make sure the title is written in small letters and without extra spaces. Sometimes it helps to create an empty file inside the folder before starting the game.
Settings through the CLEO menu and hotkeys
Successful installation of the library often adds a new item to the main menu of the game - CLEO. Through this menu you can manage active scripts, enable or disable them, and also view error logs. This is a convenient diagnostic tool: if the mod does not work, here you can see the cause of the failure.
Virtual buttons or key combinations are used to control script functions during the game. In the mobile version, PC keys are often emulated. For example, to activate many cheats, the key H or number keys are used. On a smartphone screen, these buttons can be hidden or placed in a separate overlay. You may need to adjust the transparency and placement of these buttons in the control emulator settings if you use third-party input tools.
⚠️ Attention: Do not activate too many scripts at the same time. A code conflict can lead to unpredictable game behavior, physics freezing, or the application instantly crashing to the desktop.
If there is no CLEO item in the menu, but the files were copied correctly, try restarting the application. In rare cases, a complete reboot of the device is required for the system to load new native libraries. Also check if your antivirus or system is blocking files with the extension .so, considering them potentially dangerous.
Solving problems with crashes and compatibility
The most common problem is the game crashing immediately after the Rockstar logo appears or when loading a save. This almost always indicates that the script version is incompatible with the game version. Scripts written for the old version of GTA SA may not work correctly on the new one, and vice versa. Always download mods that are marked as compatible with your version of the game.
Another reason for failures is file corruption during copying. If you transferred files via Bluetooth or instant messengers, the integrity may have been compromised. It is recommended to download archives directly to the device and unpack them with the same file manager that you use to copy files to system folders. Using cloud storage as an intermediate link can also lead to errors.
If the game crashes when loading a specific save, try deleting the mod file from the cleo folder, loading the save without the mod, and then returning the mod file back. Sometimes the script conflicts with a specific state of the game world.
It is also worth considering the limitations of the device's RAM. Heavy graphics mods combined with a lot of active scripts can exhaust the available resources of the smartphone. In this case, closing background applications before launching GTA SA or lowering the graphic settings within the game itself will help.
Security and removal of modifications
Using third-party code always carries certain risks. Download scripts only from trusted resources, such as specialized modder forums or well-known repositories. Files with extension .cs theoretically may contain malicious code, although in practice this is rare in the GTA community, since the reputation of the authors is expensive.
If you decide to stop using mods and return the game to its original state, the process is simple. You need to delete the folder cleo and library files from the folder libs. However, if the game stops launching even after removing mods, the main configuration files may have become corrupted. In this case, the fastest solution would be to delete the game and install it again.
Remember that using cheats and mods can make the game too easy and less interesting. It is recommended to use the CLEO library for one-time experiments or creating screenshots, and leave the story passage clean. This will maintain the balance between fun and challenge that the original game offers.
Stable operation of mods depends on the exact match of game versions and scripts, as well as on the correct placement of files in the Android system folders.
Why does the game not start after installing CLEO?
Most likely, you put the files libraries (.so) in the wrong folder or downloaded a version of CLEO that is incompatible with your version of GTA SA. Check the paths: for new versions of Android this is usually Android/data/com.rockstargames.gtasa/files/libs.
Where to look for the cleo folder on the phone?
The cleo folder is created in the root of the game directory. If you don't see it, create it manually. The path depends on the version: either simply /cleo/ in the internal memory (for older versions), or inside the game files folder (for new ones).
Is it possible to play with mods in online modes?
No. The use of CLEO scripts is intended for single player play only. Trying to enter multiplayer with active mods may lead to account blocking or technical connection errors.
How to activate cheats after installation?
Depends on the specific script. Many people use keyboard emulation (for example, entering codes like on a PC). Others add buttons to the screen. Read the instructions for the specific mod you downloaded.