Список опкодов (SCM.INI)

Документацию по опкодам можно найти в Sanny Builder Library.

Основной файл, который обеспечивает компиляцию и дизассемблирование скриптов, – INI файл со списком опкодов. В Sanny Builder есть список опкодов для каждого режима редактирования.

Начиная с версии 4.0 этот файл является необязательным для работы и может быть заменен определениями команд, доступными для скачивания в формате JSON в Sanny Builder Library. Новые режимы редактирования используют только файлы SBL.

Игра	Имя файла	Директория
GTA III	SCM.INI	data\gta3
Vice City	VCSCM.INI	data\vc
San Andreas	SASCM.INI	data\sa
Liberty City Stories	LCSSCM.INI	data\lcs
Vice City Stories	VCSSCM.INI	data\vcs
VC Mobile	VCSCM.INI	data\vc_mobile
SA Mobile	SASCM.INI	data\sa_mobile

Формат файла

Строки, начинающиеся с ;, игнорируются.

Метаданные

Файл может иметь особые параметры, которые содержат метаданные о его текущей версии.

VERSION – номер версии. См. директиву $VERSION PUBLISHER – автор изменений DATE – дата обновления Дизассемблер выводит эту информацию в комментарии на первой строке исходника.

Опкоды

Каждая строка с опкодом имеет следующий формат:

xxxx=N, yyyy XXXX – номер опкода N – кол-во параметров yyyy – описание опкода

Не допускается редактирование первых двух значений (номер опкода и кол-во параметров). Описание опкода может меняться свободно.

Если в INI файле содержится несколько определений для одного и того же опкода, используется последнее.

Существует соглашение, по которому описание условного опкода всегда начинается с двух пробелов.

Параметры опкодов

Параметры - это динамическая часть опкода. В описании опкода они начинаются и заканчиваются %

0001=1,wait %1d% ms

Данная строка указывает дизассемблеру, что для опкода 0001 следует написать слова wait и ms, а между ними единственный параметр опкода:

0001: wait 10 ms

Определение параметра включает в себя его порядковый номер и тип.

Порядок следования параметров

Число в параметре %1d% - его порядковый номер. Он нужен, потому что в некоторых опкодах параметры переставлены местами для улучшения читабельности кода.

0053=5,%5d% = create_player %1o% at %2d% %3d% %4d%

Для опкода 0053 дизассемблер поставит 5-й параметр в начале:

0053: $PLAYER_CHAR = сreate_player #NULL at 2488.562 -1666.865 12.8757 

Если бы параметры выводились в оригинальном порядке, опкод 0053 выглядел бы так:

0053: сreate_player #NULL at 2488.562 -1666.865 12.8757 $PLAYER_CHAR

Изменение порядка следования параметров должно быть крайней мерой, т.к. оно приводит к несовместимости старых скриптов с новым INI файлом.

Порядок следования параметров может различаться от режима к режиму. Смотрите сравнительную таблицу, чтобы узнать больше.

Типы параметров

Буква после номера параметра обозначает его тип.

d - любое значение p - имя метки o - имя модели (включая объекты) m - имя модели из .ide файла (исключая объекты) g - ключ из .gxt файла x - ID внешнего скрипта k - строковый литерал фиксированной длины (128 байтов)

Типы параметров могут свободно меняться в случае необходимости.