Бібліотека CLEO 4 (4.3.16)
-
depositfiles.comЗавантажити
Оновлена бібліотека CLEO 4 від 19 березня 2014
Скрипти
З використанням CLEO в гру можна додавати нові скрипти, написані в Sanny Builder або іншому редакторі скриптів, без потреби починати нову гру. Все, що потрібно для додавання такого скрипта в гру, - це помістити його в папку CLEO. Скрипт почне працювати після старту гри. Щоб видалити скрипт з гри - видаліть відповідний файл.
Усі скрипти написані фанатами гри і не мають відношення до розробників CLEO. Хоча сама бібліотека CLEO повинна працювати з різними версіями гри, окремі скрипти можуть мати власні обмеження та вимоги до файлів гри. За питаннями працездатності конкретного скрипта звертайтеся до його автора.
Опкоди
CLEO 4 додає в гру 100 нових скриптових команд, які дозволяють працювати з зовнішніми файлами, змінювати дані в пам'яті гри, викликати ігрові функції зі своїми параметрами, а також багато іншого.
У четвертій версії з'явилися нові команди для роботи зі звуками, рядками, була додана можливість виводити на екран текст без використання зовнішніх файлів (.gxt, .fxt). Щоб оцінити нові досягнення та використовувати їх у ваших скриптах, встановіть останню версію бібліотеки CLEO 4.
Плагіни
CLEO-плагіни - це звичайні DLL-файли, але з розширенням .CLEO. При запуску бібліотека CLEO шукає в папці CLEO файли з цим розширенням і намагається їх завантажити. У разі успішного завантаження плагін починає працювати і виконувати ті функції, для яких він написаний.
CLEO 4 дозволяє створювати нові опкоди, використовуючи вихідні коди CLEO SDK. У стартовому комплекті бібліотеки можна знайти три приклади таких плагінів.
Плагіни встановлюються і видаляються так само, як і скрипти. Список доступних плагінів можна знайти на цій сторінці.
Встановлення
CLEO 4 поширюється у вигляді автоматичного інсталятора. Для встановлення бібліотеки запустіть інсталятор і дотримуйтесь його інструкцій.
CLEO 4.3 підтримує три версії гри GTA San Andreas: 1.0, 1.01, 3.0 (steam).
CLEO вимагає установки ASI Loader, який йде разом з бібліотекою. ASI Loader - це програма, яка автоматично завантажує файли з розширенням .asi при старті гри. ASI Loader замінює один з оригінальних файлів гри 'vorbisFile.dll' своїм, тому переконайтеся, що ви зробили копію цього файлу.
Інші файли гри не замінюються, однак додаються наступні файли та папки:
- cleo\ (папка CLEO, в яку копіюються всі скрипти та плагіни)
- cleo\FileSystemOperations.cleo (плагін для роботи з файлами)
- cleo\IniFiles.cleo (плагін для роботи з INI)
- cleo\IntOperations.cleo (плагін для роботи з цілими числами на рівні бітів)
- cleo\cleo_save\ (папка збережень CLEO)
- cleo.asi (ядро бібліотеки CLEO)
- bass.dll (бібліотека для роботи з аудіо)
- vorbisHooked.dll (Silent's ASI Loader)
Усі плагіни є опціональними, але їх функціонал може бути використаний різними CLEO скриптами.
CLEO 4 для San Andreas для відтворення звукових файлів вимагає встановленої бібліотеки BASS.dll версії 2.4, яку можна завантажити з офіційного сайту Un4seen Developments Ltd.
Сумісність з CLEO 3
CLEO постійно покращується і розширюється з часом. У дуже рідкісних випадках деякі скрипти, написані для CLEO 3, можуть не працювати з CLEO 4. Починаючи з CLEO 4.3, ви можете включити спеціальний режим сумісності для скриптів CLEO 3. Для цього змініть розширення файлу скрипта (зазвичай це '.cs') на '.cs3'. CLEO 4.3 буде працювати з такими скриптами в особливому режимі, який включає в себе зміну поведінки деяких скриптових команд. В той же час в абсолютній більшості випадків скрипти CLEO 3 працюють з CLEO 4 без будь-яких проблем, і використання режиму сумісності не є необхідним.
Fdnjhs
Автор і первинний розробник бібліотеки CLEO - Seemann.
Розробники не мають відношення до Take 2 Interactive або Rockstar Games і не несуть жодної відповідальності за можливі негативні наслідки, викликані використанням цього продукту або будь-яких інших продуктів, що поширюються разом з бібліотекою. Використовуйте його на свій страх і ризик.
У CLEO 4.3 використовується ASI Loader від Silent.
Інформацію про зміни в версії 4.3 та більш детальний опис можливостей CLEO можна знайти в readme-файлах, які йдуть в комплекті з бібліотекою.
Подяки
Станіславу Головіну (a.k.a. listener) - за величезну працю в дослідженні ігор GTA.
mfisto - за альфа-тестування бібліотеки CLEO 4, поради та підтримку
NTAuthority і LINK/2012 - за допомогу з CLEO 4.3.
CLEO 4
--------------------
Change Log
-- 4.3.15 --
* Покращено виправлення сумісності для опкодів 0AE1, 0AE2 і 0AE3 з неправильним використанням find_next
-- 4.3.14 --
* Виправлено 0AAA, що повертає лише користувацькі скрипти
* Виправлено багато речей, які використовують 'SCM Block' або 'Mission Local Storage' простір
* Виправлено параметри, що передаються в локальне сховище скриптів замість місійного локального сховища через 0A94
* Виправлено потенційні проблеми з ітерацією через черги скриптів (може викликати рідкісні та важкі для відстеження помилки)
-- 4.3.13 --
* Виправлено аварійне завершення при старті нової гри після того, як гра вже почалася з встановленими скриптами CLEO
* Можливо, виправлено інші проблеми з початком гри з встановленими скриптами CLEO
-- 4.3.12 --
* Виправлено пропуск параметра рядка в 'SkipOpcodeParams', що використовується плагінами CLEO
* 0AC8 тепер повертає NULL значення в вихідну змінну, якщо виділення не вдалося (як це було до 4.3a)
* 0AC9 тепер перевіряє, що пам'ять була виділена 0AC8 перед спробою її звільнити
* FXT посилання тепер нечутливі до регістру (як це було до 4.3a)
* Операції з файлами тепер перевіряють, що вхідна ручка не є нульовою (як це, здається, було до 4.3a)
* Статус 'Завантажена місія' тепер скидається на новій/завантаженій грі (як це було до 4.3a)
* Скрипти більше не завантажуються передчасно (як це було до 4.3a)
* Вирішено конфлікти з іншими меню-хуками, такими як 'HUME'
* Інші незначні налаштування
-- 4.3.11 --
* Виправлено аварійне завершення з 0ADA в скриптах, що починаються з опкоду, що закінчується на '00'
-- 4.3.10 --
* Поліпшення для опкодів 0AE1, 0AE2 і 0AE3 - тепер циклічно проходять по пулу, навіть коли прапор 'find_next' не використовується правильно
* Виправлено 0AD2, що не повертає педі, на яких націлювалися мишкою, тоді як націлювання з контролера працювало
-- 4.3.9 --
* Тепер можна буде почати місію CLEO після нещодавнього завершення стандартної місії
* Більше не буде помилок і завершення, коли скрипти не можуть бути відкриті, а просто буде записано помилку
* Більше не буде завершення при попередженнях
* Більше не включає шляхи в автоматично згенерованих іменах скриптів (наприклад, cleo\dir\demo.cs тепер називається 'demo.cs', а не 'dir\dem')
* Поліпшене оброблення помилок завантаження скриптів
-- 4.3.8 --
* Виправлено аварійне завершення, яке виникало, коли місії закінчувалися з 004E
-- 4.3.7 --
* Користувацькі місії, запущені скриптами CLEO, тепер успадковують свій режим сумісності - можливо, виправляючи несумісності з модами, що використовують користувацькі місії
* Поточний каталог, встановлений 0A99, тепер залежить від скрипта і впливає лише на запущені скрипти CLEO (не на всю гру або main.scm)
* Текстові та текстурні/спрайтові малюнки тепер залежать від скрипта (не впливають на скрипти main.scm)
-- 4.3 --
* Замінено код, який динамічно виділяв і звільняв пам'ять для параметрів скрипта щоразу, коли викликали 0AA5-0AA8, на статичні масиви
* Видалено заміну циклу виконання скрипта, яка не використовувалася для нічого важливого і дивно працювала лише з 1.0US, що викликало аварії з плагінами для ведення журналу скриптів
* Додано підтримку версій Steam (v3) gta_sa.exe
* Запобігли ініціалізації локального сховища в функціях SCM, коли скрипт знаходиться в режимі сумісності CLEO 3 ('.cs3' розширення)
* Оновлення поведінки наступних опкодів:
0A99
CHANGE_DIRECTORY тепер може правильно змінити на каталог програми
0A9A
OPEN_FILE тепер використовує 'спадковий' режим при передачі цілого числа як параметра режиму для сумісності ручок файлів CLEO та SA
Зверніть увагу, що вам дійсно не слід передавати ручки файлів CLEO в ігрові функції. Однак, цей спадковий режим тепер забезпечує, що ручки сумісні.
Інші функції роботи з файлами також були оновлені, щоб забезпечити передачу ручок ігрових файлів до відповідних ігрових функцій.
Рекомендується не покладатися на передачу файлів в ігрові функції і натомість використовувати вбудовані функції роботи з файлами CLEO 4 в майбутньому.
0AD1
CALL тепер приймає рядковий вхід, який передається як вказівник рядка відповідно до рядкової конвенції
0AD4
SCAN_STRING тепер повертає результат умови
0AE6
FIND_FIRST_FILE тепер приймає вихідний масив рядків
0AE3
FIND_ALL_RANDOM_OBJECTS_IN_SPHERE тепер забезпечує, що не повертаються зникаючі об'єкти і повертає -1 замість 0 у разі невдачі
0AE2
FIND_ALL_RANDOM_CARS_IN_SPHERE тепер забезпечує, що не повертаються скриптові автомобілі або зникаючі автомобілі і повертає -1 замість 0 у разі невдачі
0AE1
FIND_ALL_RANDOM_CHARS_IN_SPHERE тепер забезпечує, що не повертаються скриптові персонажі або зникаючі персонажі і повертає -1 замість 0 у разі невдачі
0ADF
ADD_TEXT_LABEL тепер оновлює існуючі текстові мітки, якщо вони вже існують
0AD6
IS_END_OF_FILE_REACHED тепер повертає true, якщо сталася помилка файлу
0AD2
GET_CHAR_PLAYER_IS_TARGETING тепер повертає -1 замість 0, коли ціль не знайдена
0AB5
STORE_CLOSEST_ENTITIES тепер забезпечує, що не повертаються скриптові сутності або зникаючі сутності і забезпечує, що гравець не повертається.
Новая библиотека CLEO 4 от 19 марта 2014
Скрипты
При использовании CLEO в игру можно добавлять новые скрипты, написанные в Sanny Builder или другом редакторе скриптов, без необходимости начала новой игры. Все, что требуется для добавления такого скрипта в игру, - это поместить его в папку CLEO. Cкрипт начнет работу после начала игры. Для удаления скрипта из игры - удалите соответствующий файл.
Все скрипты написаны фанатами игры и не имеют отношения к разработчикам CLEO. Хотя сама библиотека CLEO должна работать с различными версиями игры, отдельные скрипты могут иметь собственные ограничения и требования к файлам игры. По вопросам работоспособности конкретного скрипта обращайтесь к его автору.
Опкоды
CLEO 4 добавляет в игру 100 новых скриптовых команд, которые позволяют работать с внешними файлами, изменять данные в памяти игры, вызывать игровые функции со своими параметрами, а также многое другое.
В четвертой версии появились новые команды для работы со звуками, строками, была добавлена возможность выводить на экран текст без использования внешних файлов (.gxt, .fxt). Чтобы оценить новые достижения и использовать их в ваших скриптах, установите последнюю версию библиотеки CLEO 4.
Плагины
CLEO-плагины - это обычные DLL-файлы, но имеющие расширение .CLEO. При запуске библиотека CLEO ищет в папке CLEO файлы с данным расширением и пытается загрузить их. В случае удачной загрузки плагин начинает работать и выполнять те функции, для которых он написан.
CLEO 4 позволяет создавать новые опкоды, используя исходные коды CLEO SDK. В стартовом комплекте библиотеки можно найти три примера таких плагинов.
Плагины устанавливаются и удаляются также как и скрипты. Список доступных плагинов можно найти на этой странице.
Установка
СLEO 4 распространяется в виде автоматического инсталлятора. Для установки библиотеки запустите инсталлятор и следуйте его инструкциям.
CLEO 4.3 поддерживает три версии игры GTA San Andreas: 1.0, 1.01, 3.0 (steam).
CLEO требует установки ASI Loader, который идет совместно с библиотекой. ASI Loader - это программа, которая автоматически загружает файлы с расширением .asi при старте игры. ASI Loader заменяет один из оригинальных файлов игры 'vorbisFile.dll' собственным, поэтому убедитесь, что вы сделали копию этого файла.
Другие файлы игры не заменяются, однако добавляются следующие файлы и папки:
- cleo\ (папка CLEO, в которую копируются все скрипты и плагины)
- cleo\FileSystemOperations.cleo (плагин для работы с файлами)
- cleo\IniFiles.cleo (плагин для работы с INI)
- cleo\IntOperations.cleo (плагин для работы с целыми числами на уровне битов)
- cleo\cleo_save\ (папка сохранений CLEO)
- cleo.asi (ядро библиотеки CLEO)
- bass.dll (библиотека для работы с аудио)
- vorbisHooked.dll (Silent's ASI Loader)
Все плагины опциональны, но их функционал может быть использован различными CLEO скриптами.
CLEO 4 для San Andreas для проигрывания звуковых файлов требует установленной библиотеки BASS.dll версии 2.4, которую можно скачать с официального сайта Un4seen Developments Ltd.
Совместимость с CLEO 3
CLEO постоянно улучшается и расширяется с течением времени. В очень редких случаях некоторые скрипты, написанные для CLEO 3, могут не работать с CLEO 4. Начиная с CLEO 4.3, вы можете включить специальный режим совместимости для скриптов CLEO 3. Для этого измените расширение файла скрипта (обычно это '.cs') на '.cs3'. CLEO 4.3 будет работать с такими скриптами в особом режиме, который включает в себя изменение поведения некоторых скриптовых команд. В тоже время в абсолютном большинстве случаев скрипты CLEO 3 работают с CLEO 4 без каких-либо проблем, и использование режима совместимости не требуется.
Fdnjhs
Автор и первоначальный разработчик библиотеки CLEO - Seemann.
Разработчики не имеют отношения к Take 2 Interactive или Rockstar Games и не несут никакой ответственности за возможные негативные последствия, вызванные использованием данного продукта или любых других продуктов, распространяемых вместе с библиотекой. Используйте его на свой страх и риск.
В CLEO 4.3 используется ASI Loader от Silent.
Информацию об изменениях в версии 4.3 и более подробное описание возможностей CLEO можно найти в readme-файлах, которые идут в комплекте с библиотекой.
Благодарности
Станиславу Головину (a.k.a. listener) - за огромный труд в исследовании игр GTA.
mfisto - за альфа-тестинг библиотеки CLEO 4, советы и поддержку
NTAuthority и LINK/2012 - за помощь с CLEO 4.3.
CLEO 4
--------------------
Change Log
-- 4.3.15 --
* Improvemed compatibility fix for opcodes 0AE1, 0AE2 and 0AE3 with incorrect find_next usage
-- 4.3.14 --
* Fixed 0AAA only returning custom scripts
* Fixed many things which use the 'SCM Block' or 'Mission Local Storage' space
* Fixed parameters being passed to script local storage instead of mission local storage through 0A94
* Fixed potential problems with iteration through the script queues (may cause rare and hard to trace bugs)
-- 4.3.13 --
* Fixed crashing when starting a new game after a game has already started with CLEO scripts installed
* Possibly fixed other issues with starting a game with CLEO scripts installed
-- 4.3.12 --
* Fixed string parameter skipping in 'SkipOpcodeParams' used by CLEO plugins
* 0AC8 now returns a NULL value to the output var if allocation failed (as it did before 4.3a)
* 0AC9 now checks the memory was allocated by 0AC8 before attempting to free it
* FXT references are now case insensitive (as they were before 4.3a)
* File operations now check the input handle isn't null (as it seems was the way before 4.3a)
* 'Loaded mission' status now reset on new/loaded game (as it was before 4.3a)
* Scripts no longer load prematurely (like before 4.3a)
* Resolved conflicts with other menu hooks such as 'HUME'
* Other minor tweaks
-- 4.3.11 --
* Fixed crash with 0ADA in scripts beginning with an opcode ending in '00'
-- 4.3.10 --
* Improvements to opcodes 0AE1, 0AE2 and 0AE3 - now loops around the pool even when the 'find_next' flag isn't used correctly
* Fixed 0AD2 not returning peds targetted with the mouse, while targetting with a pad worked
-- 4.3.9 --
* Will now be able to start a CLEO mission after recently finishing a standard mission
* Will no longer error & terminate when scripts fail to open and instead simply log the error
* Will no longer terminate on warnings
* No longer includes paths in automatically generated script names (e.g. cleo\dir\demo.cs is now named 'demo.cs' and not 'dir\dem')
* Improved handling of script load errors
-- 4.3.8 --
* Fixed crash which would occur when missions were ended with 004E
-- 4.3.7 --
* Custom missions launched by CLEO scripts now inherit their compatibility mode - possibly fixing incompatibilities with mods using custom missions
* The current directory set by 0A99 is now script-dependant and only affects running CLEO scripts (not the entire game or the main.scm)
* Text and texture/sprite draws are now script-dependant (doesn't affect main.scm scripts)
-- 4.3 --
* Replaced code which dynamically allocated and deallocated memory for script parameters every time 0AA5-0AA8 were called with static arrays
* Removed a script execution loop replacement which wasn't used for anything important and weirdly only worked with 1.0US that caused crashes with script logging plugins
* Added support for Steam (v3) versions of gta_sa.exe
* Prevented the local storage from being initialized in SCM functions when the script is in CLEO 3 compatibility mode ('.cs3' extension)
* Updates to behaviour of following opcodes:
0A99
CHANGE_DIRECTORY can now correctly change to the program directory
0A9A
OPEN_FILE now uses a 'legacy' mode when passing an integer as the mode parameter for compatibility of CLEO file handles and SA file handles
Note that you should really not pass CLEO file handles to game functions. However, this legacy mode now ensures that the handles are compatible.
Other file functions have also been updated ensuring that game file handles are passed to relevant game functions.
It is recommended to not rely on passing files to game functions and instead use CLEO 4's in-built file functions in future.
0AD1
CALL now accepts string input, which is passed as a string pointer following string convention
0AD4
SCAN_STRING now returns a condition result
0AE6
FIND_FIRST_FILE now accepts string array output
0AE3
FIND_ALL_RANDOM_OBJECTS_IN_SPHERE now ensures no fading objects are returned and returns -1 instead of 0 on failure
0AE2
FIND_ALL_RANDOM_CARS_IN_SPHERE now ensures no script vehicles or fading vehicle are returned and returns -1 instead of 0 on failure
0AE1
FIND_ALL_RANDOM_CHARS_IN_SPHERE now ensures no script characters or fading characters are returned and returns -1 instead of 0 on failure
0ADF
ADD_TEXT_LABEL now updates existing text labels if they already exist
0AD6
IS_END_OF_FILE_REACHED now returns true if a file error occured
0AD2
GET_CHAR_PLAYER_IS_TARGETING now returns -1 instead of 0 when no target is found
0AB5
STORE_CLOSEST_ENTITIES now ensures no script entities or fading entities are returned and ensures the player ped is not returned