Добро пожаловать на официальный сайт библиотеки CLEO - популярнейшего дополнения к серии игр Grand Theft Auto от Rockstar Games. CLEO расширяет возможности скриптинга и позволяет использовать тысячи уникальных модов, которые изменяют и дополняют процесс игры. Для игр GTA III, GTA Vice City и GTA San Andreas разработаны отдельные версии библиотеки CLEO.


Возможности

 Скрипты

При использовании CLEO в игру можно добавлять новые скрипты, написанные в Sanny Builder или другом редакторе скриптов, без необходимости начала новой игры. Все, что требуется для добавления такого скрипта в игру, - это поместить его в папку CLEO. Cкрипт начнет работу после начала игры. Для удаления скрипта из игры - удалите соответствующий файл.

Все скрипты написаны фанатами игры и не имеют отношения к разработчикам CLEO. Хотя сама библиотека CLEO должна работать с различными версиями игры, отдельные скрипты могут иметь собственные ограничения и требования к файлам игры. По вопросам работоспособности конкретного скрипта обращайтесь к его автору.

Подробнее »

 Опкоды

CLEO 4 добавляет в игру 100 новых скриптовых команд, которые позволяют работать с внешними файлами, изменять данные в памяти игры, вызывать игровые функции со своими параметрами, а также многое другое.

В четвертой версии появились новые команды для работы со звуками, строками, была добавлена возможность выводить на экран текст без использования внешних файлов (.gxt, .fxt). Чтобы оценить новые достижения и использовать их в ваших скриптах, установите последнюю версию библиотеки CLEO 4.

Подробнее »

 Плагины

CLEO-плагины - это обычные DLL-файлы, но имеющие расширение .cleo. При запуске библиотека CLEO ищет в папке CLEO файлы с данным расширением и пытается загрузить их. В случае удачной загрузки плагин начинает работать и выполнять те функции, для которых он написан.

CLEO 4 позволяет создавать новые опкоды, используя исходные коды CLEO SDK. В стартовом комплекте библиотеки можно найти три примера таких плагинов.

Плагины устанавливаются и удаляются также как и скрипты. Список доступных плагинов можно найти на этой странице.

Подробнее »


Установка

CLEO 4 распространяется в виде архива. Для установки библиотеки распакуйте архив в папку игры.

CLEO 4 поддерживает версию GTA San Andreas 1.0 US.

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 без каких-либо проблем, и использование режима совместимости не требуется.


Об авторах

Автор и первоначальный разработчик библиотеки CLEO - Seemann.

Разработку CLEO 4 начал Alien, теперь ее ведет Deji.

Разработчики не имеют отношения к Take 2 Interactive или Rockstar Games и не несут никакой ответственности за возможные негативные последствия, вызванные использованием данного продукта или любых других продуктов, распространяемых вместе с библиотекой. Используйте его на свой страх и риск.

В CLEO 4.3 используется ASI Loader от Silent.

Информацию об изменениях в версии 4.3 и более подробное описание возможностей CLEO можно найти в readme-файлах, которые идут в комплекте с библиотекой.

Благодарности:


CLEO для GTA 3 и GTA Vice City

Успех CLEO для San Andreas вдохновил Alien портировать библиотеку в GTA 3 и Vice City. При этом некоторые функции, такие как сохранение CLEO переменных и состояния скриптов в отдельных сейв-файлах, были удалены.

После того, как Alien прекратил дальнейшую разработку, развитие этой ветки приостановилось до тех пор, пока Silent не выпустил патч к последней на тот момент версии. Вскоре после этого DK22Pac объявил о начале разработки новой версии CLEO для GTA 3 и Vice City, написанной с нуля. ThirteenAG помог завершить ее, и теперь CLEO 2.0 для GTA 3 и Vice City доступна для скачивания.

Больше информации можно найти на GTAForums.com.

Исходный код выложен на GitHub.