Скрипты


Что такое CLEO скрипты?

CLEO скрипт - это дополнительный игровой сценарий, написанный для одной из игр серии Grand Theft Auto от Rockstar Games. Несмотря на то, что в этих играх разнообразный игровой процесс, он может быть еще больше расширен путем добавления новых или изменения уже существующих возможностей. CLEO скрипты компилируются в программе Sanny Builder в отдельный файл с расширением .cs. Любой желающий может научиться создавать свои собственные CLEO скрипты и обмениваться ими среди миллионов фанатов игры GTA - пользователей библиотеки CLEO!

При помощи библиотеки CLEO можно создать как совершенно новые игровые возможности и миссии, так и полностью внутриигровые приложения для модификации игры (как например, DYOM), только лишь при помощи небольших скриптов, которые можно быстро скачать и установить. Такие возможности библиотеки как простая и быстрая установка, появление новых скриптовых команд (опкодов) и новой звуковой системы, загрузка внешних миссий, поддержка плагинов и многое другое открывают простор для реализации ваших идей при изменении любимой игры Grand Theft Auto.

Где скачать CLEO скрипты?

Ниже приведены ссылки на сайты с достаточно большими коллекциями CLEO скриптов. Обращаем внимание, что разработчики CLEO не имеют отношения к указанным сайтам и не отвечают за их содержание.

hotmist.ddo.jp
zazmahall.de
gtagarage.com
gtainside.com
gtaall.com
gta-modding.com
gtascriptd88.ucoz.ru
libertycity.ru
gta.com.ua
gamemodding.net

Как установить CLEO скрипты?

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

Чтобы установить CLEO скрипт вам нужно скопировать файл с расширением .cs в папку CLEO. Имя файла не имеет значения, однако первые 7 букв названия используются библиотекой для внутреннего обозначения скрипта. Например, CLEO скрипт из файла showsavescreen.cs будет иметь имя SHOWSAV.

Чтобы удалить скрипт, просто удалите соответствующий файл из папки CLEO.

Как написать свой CLEO скрипт?

Создать CLEO скрипт очень просто (при условии, что вы умеете писать скрипты для GTA вообще). В Sanny Builder добавьте директиву {$CLEO} в начало файла с исходным кодом скрипта и скомпилируйте его. Получившийся файл будет скопирован в папку CLEO и ему будет дано расширение, заданное директивой {$CLEO} (по умолчанию .cs).

Процесс создания CLEO миссии аналогичен, за исключением того, что получившийся файл должен иметь расширение .cm (его можно задать директивой {$CLEO .cm}). Миссия запускается из CLEO скрипта при помощи опкода 0A94.

Есть несколько основных правил, которым вы должны следовать при создании CLEO скрипта:

1) Один файл - один скрипт. CLEO поддерживает только один скрипт в файле. Если вам нужно запустить дополнительные скрипты, используйте опкод 0A92 с указанием пути к другому .cs файлу.

2) Никогда не используйте опкод 004E в CLEO скриптах. CLEO скрипты работают независимо от оригинальных скриптов main.scm, поэтому этот опкод нарушит работу игры. Используйте опкод 0A93, если вам нужно остановить CLEO скрипт. При этом, никогда не используйте 0A93 в CLEO миссиях, вместо него используйте 004E чтобы остановить CLEO миссию.

Каждый CLEO скрипт может быть сохранен и загружен независимо от оригинальных скриптов игры. По умолчанию состояние CLEO скрипта не сохраняется, но вы можете изменить это путем добавления в скрипт опкода 0A95. CLEO сохраняет состояние скриптов в папке 'CLEO\cleo_saves'. Для каждого слота сохранения создается отдельный файл. CLEO-сейв содержит в себе информацию не только об активных скриптах на момент сохранения, но также о тех, которые были завершены (опкодом 0A93), чтобы предотвратить их повторный запуск после загрузки сейва.

Если при загрузке иры один из ранее сохраненных скриптов не был найден, ошибки не будет. Если в папке CLEO будет найден новый скрипт, которого не было при сохранении игры, он будет загружен вместе с остальными и начнет работу с начала.

CLEO скрипты работают также как и обычные скрипты GTA. У них 32 локальные переменные и 2 таймера, которые постоянно увеличивают свое значение. При запуске скрипта опкодом 0A92 или миссии опкодом 0A94 вы можете передать в них до 34 параметров (как в опкоде 004F).

При обмене данными между CLEO скриптом и main.scm необходимо помнить следующее. Несмотря на то, что CLEO скрипты могут читать содержимое main.scm и работать с ним, рекомендуется избегать этого. Это необходимо для независимой работы CLEO скрипта на различных модификациях игры у разных пользователей. Лучше всего, если CLEO скрипт будет использовать только внутренние данные или данные, полученные напрямую из памяти игры. Однако некоторые переменные, такие как $PLAYER_CHAR, $PLAYER_ACTOR и $ONMISSION могут свободно использоваться в CLEO скриптах.

Также для обмена данными между CLEO скриптами вы можете использовать CLEO переменные (опкоды 0AB3, 0AB4).

Стандартная установка CLEO включает в себя примеры простых скриптов с исходниками.