CLEO Redux v1.2.2





































-
cleo-redux-v1-2-2_1693510956_683963.zipDownload (5.81 MB)Password for the archive: libertycity
CLEO Redux is a scripting runtime for games from the GTA 3D era. It is a proud member of the CLEO family and provides familiar features to anyone who has used the library for classic GTA San Andreas or its re-implementations for other games. The main goal of CLEO is to provide the ability to easily customize the game with countless custom scripts.
Update 08/28/2023:
- Fixed an issue where commands returning multiple values (Char#storeClosestEntities, Game.GetCurrentResolution(), etc.) would only return one correct value.
Update 08/13/2023:
- Andfixing the problem when importing the same file from different folders led to code duplication;
- Fix bug in Memory.Fn methods returning 8-bit or 16-bit results;
- Fixed a bug with crown rendering where only one crown was visible.
SDK AND PLUGINS
- Dylib2.0: Now the return value is the address of the loaded module in memory.
- Increased minimum required versions of command definitions.
Update 06/19/2023: - Added support for GTA The Trilogy - The Definitive Edition v1.0.17.39540 (Epic Games Store);
- Fixed a bug when commands for derived classes returned incorrect values (Heli.Create, Boat.Create, etc.);
- Fixed a bug where the library could not read the host version if the path to the executable contained non-ASCII characters;
- Improved the log: it now serializes with all properties, not just [object Object].
Update 02/21/2023:
- Added support for GTA The Trilogy - The Definitive Edition v1.0.17.39540 (Rockstar Games Launcher).
Update 02/18/2023:
- Added support for GTA Trilogy - (Steam) - v1.0.17.39540;
- Updated default tsconfig.json to resolve issues with importing JSON files. Delete your tsconfig.json if you want to recreate it with new settings.
Update 02/14/2023:
- Added support for GTA 4 (version 1.2.0.59).
- Added a new property CLEO.hostVersion which returns the version of the current host. Currently available only if the current exe file has version information (eg GTA IV or GTA Trilogy);
- Fix crash in GTA IV when loading script with syntax error;
- Fix for an issue in GTA IV where some commands would always return the same value (e.g. GEt_CURRENt_CHAR_WEAPON).
Update 01/27/2023:
Breaking changes:
- Increased minimum required versions of command definitions;
- CLEO.version and CLEO.apiVersion incorrectly returned empty strings for missing parts of the version string. Now undefined is returned instead.
- Log(CLEO.apiVersion.patch); // used to be "", now undefined
- Log(CLEO.apiVersion.pre); // used to be "", now undefined
- Log(CLEO.apiVersion.build); // was "", now undefined
Update 01/11/2023:
- New built-in functions for addEventListener and dispatchEvent;
- Added setTimeout, setInterval, clearTimeout, clearInterval;
- Fixed a bug that caused scripts to stop on timeout;
- Fixing a bug that caused scripts to crash after a reboot;
- Fix for a bug where Bully commands returned incorrect values.
SDK AND PLUGINS:
- Added new SDK TriggerEvent method to trigger custom events with some payload. SDK version is now 7;
- Added a new plugin Events, which adds several events to react to them in the JS/TS code: OnVehicleCreate, OnPedCreate, OnObjectCreate, OnVehicleDelete, OnPedDelete, OnObjectDelete;
- IdeLoader 1.3: generates ide_loader.d.ts for better intellisense in TS scripts;
- xtLoader 1.1: txt_loader.d.ts is generated to better understand the meaning in TS scripts.
The minimum required versions of command definitions have also been increased.
Update 12/15/2022:
- Added support for TypeScript;
- Added support for commands that use SCM global variables (for example, counters or timers);
- Removed the previously deprecated GAME variable. Use HOST instead; Updated the script watcher: changing .mjs files in the scripts directory or any subdirectories causes the script to be reloaded;
- With FxtStore, you can make global FXT keys work by setting the last argument to FxtStore.insert and FxtStore.delete to true.
SDK AND PLUGINS:
- IdeLoader 1.2: parser bug fixed, due to which .ide files with 2dfx section were not loaded;
- Frontend 1.1: reduced timeout when checking for updates to 10 seconds;
- ImGuiRedux (by Grinch_): more commands.
CRITICAL CHANGES:
- Increased minimum required versions of command definitions.
Update 11/22/2022:
- Added experimental support for asynchronous functions;
- Added new CLEO.runScript method for scripts;
- Added FXT support for GTA 4;
- Fixed crash from GTA 3 and GTA 4;
- Changed minimum required versions of command definitions for GTA 4.
Update 11/03/2022:
- Added methods: Memory.ReadUtf8, Memory.WriteUtf8, Memory.ReadUtf16, Memory.WriteUtf16;
- The ONMISSION settings allow you to use 00D9 STORE_CAR_CHAR_IS_IN or 00D8 MISSION_HAS_FINISHED;
- New SDK methods;
- Now the code that displays the CLEO version in the main menu has been moved to a separate plugin — frontend.cleo.
Update 09/09/2022:
- Added support for javascript in 64-bit versions of re3 and reVC;
- The Check for Updates option is disabled by default;
- 64-bit version (SDK AND PLUGINS);
- Fixed error when installing ASI Loader in GTA 4;
- Added an additional option when installing cleo for re3 and reVC (choice of 32-bit or 64-bit).
Update 08/19/2022:
- Added support for Bully: Scholarship Edition (v1.2 PC);
- Fixed Gxt Hook bug;
- Fixed bug with non-working scripts after reboot.
Update from 07/01/2022
- Added initial support for GTA 4 (The Complete Edition);
- We fixed an issue where CLEO would stop loading FXT files after encountering non-UTF8 characters.
- Added property CLEO.apiVersion;
- SDKs and Plugins.
Update 03/04/2022:
- Added support for The Definitive Edition Title Update 1.04 (GTA III DE 1.0.0.15284, VC DE 1.0.0.15399, SA DE 1.0.0.15483);
- Fixed bugs in commands (San Andreas);
- Fixed bug with non-working scripts.
Update 02/22/2022:
- Added SDK for developing custom commands in C++ and Rust.
- Added support for error commands in JS (also known as IF and SET commands in SCM scripts), they return an undefined value on failure, e.g. DynamicLibrary.Load or Char.IsInAnySearchlight);
- Two new plugins that add commands to work with DLL (dylib.cleo) and INI files (IniFiles.cleo) in all supported games;
- Added __dirname variable to JS script, which is added to the directory of the current file;
- Added a new built-in function that calls a script command by name;
- Fixed JS import broken issue when CLEO folder is in AppData directory;
- Fixed a bug due to which the showTextBox command in San Andreas displayed junk text;
- Fixed a conversion error when the showTextBox command is given an integer argument;
- Fixed an issue with script permissions not being checked for JS scripts.
- Fixed an issue where the object returned as a result of some commands (Object.GrabEntityOnRope(), Heli.GrabEntityOnWinch(), etc.) did not have the corresponding fields wrapped in a class instance.
Update:
- Added support for JS scripts in GTA III: The Definitive Edition (v1.0.0.14718) and Vice City: The Definitive Edition (v1.0.0.14718);
- Added support for modern ES6+ syntax;
- Added support for importing other scripts and JSON files;
- You can now call game functions with floating point arguments;
- New convenience method "Memory.Fn.X64Float" that can be used for functions that return a floating point number.
Update 12/17/2021:
For San Andreas: The Definitive Edition:
- Added new opcodes: 0C06 WRITE_MEMORY and 0C07 READ_MEMORY, as well as the corresponding javascript commands: Memory.Write and Memory.Read;
- Fixed problem with opcodes 0C01, 0C02, 0C03, 0C04.
- CLEO Redux for San Andreas: The Definitive Edition now uses sa_unreal.json (https://github.com/sannybuilder/library).
For other games:
- Improved stability of JS scripts;
- Fixed issue where script permissions were not checked for CLEO scripts.
Update 12/08/2021:
- Fixed critical bug in CS script scheduler causing abnormal behavior (usually causing slow execution);
- Fixed an issue that caused crowns (light source textures) to not show up in CS scenarios.
Update 12/04/2021:
- Added support for method chaining for constructed files;
- Fixed an issue where the script could run in the menu.
Installation:
- Download and install Ultimate ASI Loader x64by ThirteenAG (rename to version.dll or any compatible name and copy to GTA San Andreas - Definitive EditionGamefaceBinariesWin64 directory);
- Copy cleo_redux64.asi to the same directory.
First setting:
There may be a noticeable delay during the first launch of the game as CLEO Redux downloads the files needed to support javascript. This will not happen on subsequent launches.
When you first start the game, the folderwill appear in the GTA San Andreas — Definitive Edition GamefaceBinariesWin64 directory!CLEO. This is where you move all your scripts.
Compatible with The Trilogy: The Definitive Edition
Currently CLEO Redux only supports San Andreas: The Definitive Edition 1.0.0.14296, 1.0.0.14388, 1.0.0.14718 (Title Update v1.03). There are several key differences from other games:
- Requires Ultimate ASI Loader x64 by ThirteenAG;
- The main menu does not display the version of CLEO;
- Opcodes for custom commands are different, only some are supported:
0C00 IS_KEY_PRESSED
0C01 INt_ADD
0C02 INt_SUB
0C03 INt_MUL
0C04 INt_DIV
0C05 TERMINATE_THIS_CUSTOM_SCRIPT
Sanny Builder does not yet support these new opcodes. To enable new opcodes in CS scripts, add the following lines on top of the script:
{$O 0C00=1, is_key_pressed %1d% }
{$O 0C01=3,%3d% = %1d% + %2d% }
{$O 0C02=3,%3d% = %1d% - %2d% }
{$O 0C03=3,%3d% = %1d% * %2d% }
{$O 0C04=3,%3d% = %1d% / %2d% }
{$O 0C05=0,terminate_this_custom_script }
Use SA Mobile mode to compile CLEO scripts for San Andreas: The Definitive Edition.
Delete:
- Delete cleo_redux64.asi.
- Delete the CLEO folder (optional).
- Delete cleo_redux.log (optional).
Password: libertycity
CLEO Redux — это среда выполнения сценариев для игр эпохи GTA 3D. Является гордым представителем семейства CLEO и предоставляет знакомые возможности всем, кто использовал библиотеку для классической GTA San Andreas или ее повторных реализаций для других игр. Основная цель CLEO — предоставить возможность легко настраивать игру с помощью бесчисленных пользовательских скриптов.
Обновление от 28.08.2023:
- Исправлена проблема, когда команды, возвращающие несколько значений (Char#storeClosestEntities, Game.GetCurrentResolution() и т.д.), возвращали только одно правильное значение.
Обновление от 13.08.2023:
- Исправление проблемы, когда импорт одного и того же файла из разных папок приводил к дублированию кода;
- Исправление ошибки в методах Memory.Fn, возвращающих 8-битные или 16-битные результаты;
- Исправлена ошибка с рендерингом короны, когда была видна только одна корона.
SDK И ПЛАГИНЫ
- Dylib 2.0: плагин переписан для обеспечения поведения, идентичного LOAD_DYNAMIC_LIBRARY из CLEO4. Теперь возвращаемое значение — это адрес загруженного модуля в памяти.
- Увеличены минимально необходимые версии определений команд.
Обновление от 19.06.2023: - Добавлена поддержка GTA The Trilogy — The Definitive Edition v1.0.17.39540 (Epic Games Store);
- Исправлена ошибка, когда команды для производных классов возвращали неверные значения (Heli.Create, Boat.Create и т.д.);
- Исправлена ошибка, когда библиотека не могла прочитать версию хоста, если путь к исполняемому файлу содержал символы, отличные от ASCII;
- Улучшен журнал: теперь он сериализуется со всеми свойствами, а не только [object Object].
Обновление от 21.02.2023:
- Добавлена поддержка GTA The Trilogy — The Definitive Edition v1.0.17.39540 (Rockstar Games Launcher).
Обновление от 18.02.2023:
- Добавлена поддержка GTA Trilogy — (Steam) — v1.0.17.39540;
- Обновлен tsconfig.json по умолчанию, чтобы решить проблемы с импортом JSON-файлов. Удалите свой tsconfig.json, если вы хотите создать его заново с новыми параметрами.
Обновление от 14.02.2023:
- Добавлена поддержка GTA 4 (версия 1.2.0.59).
Обновление от 27.01.2023:
- Добавлено новое свойство CLEO.hostVersion, которое возвращает версию текущего хоста. В настоящее время доступно, только если текущий exe-файл имеет информацию о версии (например, GTA IV или GTA Trilogy);
- Исправление сбоя в GTA IV при загрузке скрипта с синтаксической ошибкой;
- Исправление проблемы в GTA IV, когда некоторые команды всегда возвращали одно и то же значение (например, GET_CURRENT_CHAR_WEAPON).
Критические изменения:
- Увеличены минимально необходимые версии определений команд;
- CLEO.version и CLEO.apiVersion некорректно возвращали пустые строки для отсутствующих частей строки версии. Теперь вместо них возвращается undefined.
- Log(CLEO.apiVersion.patch); // раньше было "", теперь undefined
- Log(CLEO.apiVersion.pre); // раньше было "", теперь undefined
- Log(CLEO.apiVersion.build); // было "", теперь undefined
Обновление от 11.01.2023:
- Новые встроенные функции для addEventListener и dispatchEvent;
- Добавлены setTimeout, setInterval, clearTimeout, clearInterval;
- Добавлено .cs, .js, .ts в список разрешенных расширений файлов для CLEO.runScript;
- Исправлена ошибка, приводившая к остановке скриптов по таймауту;
- Исправление ошибки, приводившей к сбоям в работе скриптов после перезагрузки;
- Исправление ошибки, когда команды Bully возвращали неверные значения.
SDK AND PLUGINS:
- Добавлен новый метод SDK TriggerEvent для запуска пользовательских событий с некоторой полезной нагрузкой. Версия SDK теперь 7;
- Добавлен новый плагин Events, который добавляет несколько событий для реакции на них в JS/TS-коде: OnVehicleCreate, OnPedCreate, OnObjectCreate, OnVehicleDelete, OnPedDelete, OnObjectDelete;
- IdeLoader 1.3: генерирует ide_loader.d.ts для лучшего intellisense в скриптах TS;
- xtLoader 1.1: генерируется txt_loader.d.ts для лучшего понимания смысла в скриптах TS.
Также увеличены минимально необходимые версии определений команд.
Обновление от 15.12.2022:
- Добавлена поддержка TypeScript;
- Добавлено поддержку команд, использующих глобальные переменные SCM (например, счетчики или таймеры);
- Удалено ранее устаревшую переменную GAME. Вместо нее используйте HOST;
- Обновлено средство наблюдения за сценариями: изменение файлов .mjs в каталоге сценариев или любых вложенных каталогах вызывает перезагрузку сценария;
- С помощью FxtStore можно заставить работать глобальные FXT-ключи, установив последний аргумент в FxtStore.insert и FxtStore.delete в true.
SDK И ПЛАГИНЫ:
- IdeLoader 1.2: исправлена ошибка парсера, из-за которой не загружались файлы .ide с секцией 2dfx;
- Frontend 1.1: уменьшен таймаут при проверке обновлений до 10 секунд;
- ImGuiRedux (by Grinch_): больше команд.
КРИТИЧНЫЕ ИЗМЕНЕНИЯ:
- Увеличены минимально необходимые версии определений команд.
Обновление от 22.11.2022:
- Добавлена экспериментальная поддержка асинхронных функций;
- Добавлен новый метод CLEO.runScript для скриптов;
- Добавлена поддержка FXT для GTA 4;
- Исправлен вылет с GTA 3 и GTA 4;
- Изменены минимальные требуемые версии определений команд для GTA 4.
Обновление от 03.11.2022:
- Добавлена поддержка для последнего патча GTA Trilogy 1.04.5;
- Добавлены методы: Memory.ReadUtf8, Memory.WriteUtf8, Memory.ReadUtf16, Memory.WriteUtf16;
- Настройки ONMISSION позволяют использовать 00D9 STORE_CAR_CHAR_IS_IN or 00D8 MISSION_HAS_FINISHED;
- Новые методы SDK;
- Теперь код, отображающий версию CLEO в главном меню, вынесен в отдельный плагин — frontend.cleo.
Обновление от 09.09.2022:
- Добавлена поддержка javascript в 64-битных версиях re3 и reVC;
- Параметр «Проверить обновления» отключен по умолчанию;
- 64-bit версия (SDK AND PLUGINS);
- Исправлена ошибка при установке ASI Loader в GTA 4;
- Добавлена дополнительная опция при установке клео для re3 и reVC (выбор 32-битную или 64-битную).
Обновление от 19.08.2022:
- Добавлена поддержка Bully: Scholarship Edition (v1.2 PC);
- Исправлена ошибка Gxt Hook;
- Исправлена ошибка с неработающими скриптами после перезагрузки.
Обновление от 01.07.2022
- Добавлена начальная поддержка GTA 4 (The Complete Edition);
Все части GTA теперь используют составные определения (комбинация основного файла JSON и файла JSON для неизвестного хоста из библиотеки Sanny Builder);- Исправлена проблема, когда CLEO переставала загружать файлы FXT после обнаружения символов, отличных от UTF8;
- Добавлено свойство CLEO.apiVersion;
- SDK и плагины.
Обновление от 04.03.2022:
- Добавлена поддержка The Definitive Edition Title Update 1.04 (GTA III DE 1.0.0.15284, VC DE 1.0.0.15399, SA DE 1.0.0.15483);
- Исправлены ошибки в командах (San Andreas);
- Исправлена ошибка из нерабочими скриптами.
Обновление от 22.02.2022:
- Добавлен SDK для разработки пользовательский команд на C++ и Rust.
- Добавлена поддержка ошибочных команд в JS (также известных как команды IF и SET в сценариях SCM), они возвращают неопределенное значение при сбое, например. DynamicLibrary.Load или Char.IsInAnySearchlight);
- Два новых плагина, добавляющих команды для работы с DLL (dylib.cleo) и INI файлами (IniFiles.cleo) во всех поддерживаемых играх;
- Добавлена переменная __dirname в сценарии JS, которая добавляется в каталог текущего файла;
- Добавлена новая встроенная функция, которая вызывает команду сценария по имени;
- Исправлена проблема с округлением чисел с плавающей запятой в GTA 3;
- Исправлена проблема с неработающим импортом в JS, когда папка CLEO находится в каталоге AppData;
- Исправлена ошибка, из-за которой команда showTextBox в San Andreas отображала мусорный текст;
- Исправлена ошибка преобразования, когда команде showTextBox дает целочисленный аргумент;
- Исправлена проблема с разрешениями сценариев, которые не проверялись для сценариев JS;
- Исправлена проблема, когда объект, возвращаемый в результате некоторых команд (Object.GrabEntityOnRope(), Heli.GrabEntityOnWinch() и т.п.), не имел соответствующих полей, завернутых в экземпляр класса.
Обновление:
- Добавлена поддержка JS-скриптов в GTA III: The Definitive Edition (v1.0.0.14718) и Vice City: The Definitive Edition (v1.0.0.14718);
- Добавлена поддержка современного синтаксиса ES6+;
- Добавлена поддержка импорта других скриптов и файлов JSON;
- Теперь вы можете вызывать игровые функции с аргументами с плавающей запятой;
- Новая команда "Memory.CallFunctionReturnFloat", аналогичная предыдущей, Memory.CallFunctionReturnно используемая для функций, возвращающих число с плавающей запятой;
- Новый удобный метод "Memory.Fn.X64Float", который можно использовать для функций, возвращающих число с плавающей запятой.
Обновление от 17.12.2021:
Для San Andreas: The Definitive Edition:
- Добавлены новые коды операций: 0C06 WRITE_MEMORY и 0C07 READ_MEMORY, а также соответствующие команды javascript: Memory.Write и Memory.Read;
- Исправлена проблема с опкодами 0C01, 0C02, 0C03, 0C04.
- CLEO Redux для San Andreas: The Definitive издание теперь использует sa_unreal.json (https://github.com/sannybuilder/library).
Для остальных игр:
- Улучшена стабильность JS скриптов;
- Исправлена проблема, когда разрешения скриптов не проверялись для скриптов CLEO.
Обновление от 08.12.2021:
- Исправлена критическая ошибка в планировщике сценариев CS, вызывающая ненормальное поведение (обычно вызывающее медленное выполнение);
- Исправлена ошибка, из-за которой короны (текстуры источников света) не отображались в сценариях CS.
Обновление от 04.12.2021:
- CLEO теперь использует каталог AppData, если в текущем каталоге игры нет прав на запись;
- Добавлена поддержка цепочки методов для конструируемых файлов;
- Исправлена ошибка, из-за которой скрипт мог запускаться в меню.
Установка:
- Загрузите и установите Ultimate ASI Loader x64 от ThirteenAG (переименуйте в version.dll или любое совместимое имя и скопируйте в GTA San Andreas — Definitive EditionGamefaceBinariesWin64 каталог);
- Скопируйте cleo_redux64.asi в тот же каталог.
Первая настройка:
Во время первого запуска игры может наблюдаться заметная задержка, поскольку CLEO Redux загружает файлы, необходимые для поддержки javascript. При последующих запусках этого не произойдет.
При первом запуске игры, в директории GTA San Andreas — Definitive EditionGamefaceBinariesWin64 появится папка CLEO. Туда и переносите все свои скрипты.
Совместимость с The Trilogy: The Definitive Edition
На данный момент CLEO Redux поддерживает только San Andreas: The Definitive издание 1.0.0.14296, 1.0.0.14388, 1.0.0.14718 (Title Update v1.03). Есть несколько ключевых отличий от других игр:
- Требуется Ultimate ASI Loader x64 от ThirteenAG;
- В главном меню не отображается версия CLEO;
- Функция showTextBox не работает в JS скриптах;
- Коды операций для пользовательских команд разные, поддерживаются только некоторые:
0C00 IS_KEY_PRESSED
0C01 INT_ADD
0C02 INT_SUB
0C03 INT_MUL
0C04 INT_DIV
0C05 TERMINATE_THIS_CUSTOM_SCRIPT
Sanny Builder пока не поддерживает эти новые коды операций. Чтобы включить новые коды операций в сценариях CS, добавьте следующие строки поверх сценария:
{$O 0C00=1, is_key_pressed %1d% }
{$O 0C01=3,%3d% = %1d% + %2d% }
{$O 0C02=3,%3d% = %1d% — %2d% }
{$O 0C03=3,%3d% = %1d% * %2d% }
{$O 0C04=3,%3d% = %1d% / %2d% }
{$O 0C05=0,terminate_this_custom_script }
Используйте режим SA Mobile для компиляции CLEO-скриптов для San Andreas: The Definitive Edition.
Удаление:
- Удалить cleo_redux64.asi.
- Удалите CLEO папку (необязательно).
- Удалите cleo_redux.log (необязательно).
Пароль: libertycity
Recommended files

ImGui Menu (Cleo)

Disconnecting Hood


Transport spawner

Camera shake when shooting

machine spawner

Endless run


Skin Selector - Play as any pedestrian

Maximum Weapon Proficiency

Weapon selection menu

Car wash workers

Free Camera 2.1

No damage (repair) to the car

Weapon selection menu v2

Simple Native Trainer
