CLEO Redux v1.2.2

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: Тепер значення, що повертається — це адреса завантаженого модуля в пам'яті.
• Збільшено мінімально необхідні версії визначень команд.
  
  Оновлено від 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 неправильно повертали порожні рядки для відсутніх частин рядка версії. Тепер замість них повертається невизначений.




• Log(CLEO.apiVersion.patch); // Раніше було "", тепер undefined
• Log(CLEO.apiVersion.pre); // Раніше було "", тепер undefined
• Log(CLEO.apiVersion.build); // було "", тепер undefined

Оновлено від 11.01.2023:

• Нові вбудовані функції для addEventListener та dispatchEvent;
• Додані setTimeout, setInterval, clearTimeout, clearInterval;
• Виправлено помилку, що призводила до зупинки скриптів по таймууту;
• Виправлення помилки, що призводила до збоїв у роботі скриптів після перезавантаження;
• Виправлення помилки, коли команди 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:

• Додані методи: Memory.ReadUtf8, Memory.WriteUtf8, Memory.ReadUtf16, Memory.WriteUtf16;
• Налаштування ONMISSION дозволяють використовувати 00D9 STORE_CAR_CHAR_IS_IN або 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);
• 
• Виправлено проблему, коли CLEO переставала завантажувати файли FXT після виявлення символів, відмінних від UTF8;
• Додано властивість CLEO.apiVersion;
• SDK та плагіни.

Оновлено від 04.03.2022:

• Додано підтримку The Definitive Edition Title Update 1.04 (GTA III DE 1.0.0.15284;
• Виправлені помилки у командах (San Andreas);
• Виправлено помилку з неробочими скриптами.

Оновлено від 22.02.2022:

• Доданий SDK для розробки команд користувача на C++ і Rust.
• Додана підтримка помилкових команд у JS (також відомих як команди IF та SET у сценаріях SCM), вони повертають невизначене значення при збої, наприклад. DynamicLibrary.Load або Char.IsInAnySearchlight);
• Два нових плагіни, що додають команди для роботи з DLL (dylib.cleo) та INI файлами (IniFiles.cleo) у всіх підтримуваних іграх;
• Додана змінна __dirname у сценарії JS, яка додається до каталогу поточного файлу;
• Додано нову вбудовану функцію, яка викликає команду сценарію на ім'я;
• Виправлено проблему з непрацюючим імпортом у 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.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:

• Додана підтримка ланцюжка методів для файлів, що конструюються;
• Виправлена ​​помилка, через яку скрипт міг запускатися в меню.

Установка:

1. Завантажте та встановіть Ultimate ASI Loader x64від ThirteenAG (перейменуйте на version.dll або будь-яке сумісне ім'я та скопіюйте в GTA San Andreas — Definitive EditionGamefaceBinariesWin64 каталог);
2. Скопіюйте 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;



- Коди операцій для команд користувача різні, підтримуються тільки деякі:

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