Документация к CLEO 4.3

Библиотека CLEO v4.3.20 [21.04.2015] - это инструмент, который позволяет с легкостью добавлять в игру GTA SA и запускать CLEO скрипты, написанные в Sanny Builder или другом редакторе, без рестарта самой игры.

Добавление и удаление скриптов - это легко как просто добавить в папку или удалить из папки любой файл.
В папке с GTA San Andreas появится папка "CLEO", в которую нужно добавлять все скрипты, которые вы хотите включить в игру.

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

Совместимость с CLEO 3

CLEO постоянно улучшается и расширяется с течением времени. В очень редких случаях некоторые скрипты, написанные для CLEO 3, могут не работать с CLEO 4. Начиная с CLEO 4.3, вы можете включить специальный режим совместимости для скриптов CLEO 3. Для этого измените расширение файла скрипта (обычно это '.cs') на '.cs3'. CLEO 4.3 будет работать с такими скриптами в особом режиме, который включает в себя изменение поведения некоторых скриптовых команд. В тоже время в абсолютном большинстве случаев скрипты CLEO 3 работают с CLEO 4 без каких-либо проблем, и использование режима совместимости не требуется.

Среди стандартных плагинов, всё те же, всем известные:

SCMLog
записывает во внешний файл информацию о каждом выполненном игрой опкоде

MP3 Player
позволяет слушать ваши любимые MP3 файлы в любом месте игры

GXT Hook для CLEO 3
дает возможность использовать собственные тексты в скриптах без редактирования GXT. Этот хук встроен в CLEO 4

HUME
позволяет изменить положение и размеры текстур в главном меню игры. Можно использовать видеофайл в качестве бэкграунда

NewOpcodes
плагин для CLEO 4 от DK22Pac, добавляющий 100 новых опкодов

ClipboardControl Library
плагин для CLEO 4 от Deji, добавляющий 2 новых опкода для работы с буфером обмена

SCRLog Plugin
продвинутая версия SCMLog от LINK/2012

Custom opcodes
плагин для CLEO 4 от Shmoopy, добавляющий много продвинутых возможностей в GTA San Andreas