¶ Консоль
У SAMPFUNCS есть внутриигровая консоль, активируется она кнопкой ~ (тильда).
Назначение консоли -- помогать скриптерам в отладке своих скриптов.
У неё также есть несколько команд, их список будет представлен ниже.
Главным свойством командной строки консоли является способность выполнять опкоды, например, если ввести в командную строку текст 07A7: put_jetpack_on_actor $PLAYER_ACTOR, на игрока будет надет джетпак (команда "op" выполняет точно такую же роль).
Порядок параметров должен быть обязательно учтён, пример: 0226: 0@ = actor $PLAYER_ACTOR health, если вызвать этот опкод в том виде, в каком он есть, то с большим шансом это приведёт к вылету, т.к. у подобного вида опкодов первый параметр на самом деле является последним, поэтому вызывать его надо так: 0226: store_actor $PLAYER_ACTOR health_to 0@.
Порядок параметров каждого опкода можно посмотреть в SASCM.ini.
На текущий момент обработчик полностью поддерживает синтаксис Sanny Builder'а, за исключением глобальных и локальных массивов, и имеет только две глобальные переменные - $PLAYER_ACTOR и $PLAYER_CHAR, к остальным можно обращаться по номеру ($5, $8, $609...).
¶ Команды
| Команда | Описание | Параметры |
|---|---|---|
| cmdlist | Выводит список всех консольных команд | - |
| op | Выполняет опкод | параметры опкода |
| clear | Очищает окно консоли | - |
| getfps | Выводит в консоль текущий FPS | - |
| fpscounter | Переключает состояние индикатора FPS (находится в правом верхнем углу экрана) | - |
| printv | Выводит значение локальной/глобальной переменной | <var> |
| prints | Выводит строку, хранящуюся в локальной/глобальной переменной | <var> |
| getresult | Выводит результат выполнения последнего опкода | - |
| threads | Выводит список активных и неактивных потоков | <all/active/inactive> |
| run | Последовательно выполняет опкоды из файла, имеет возможность передачи параметров перед выполнением (синтаксис SB). | <filename> [params ...] |
| pfree_all | Выгружает все плагины SF | - |
| pload | Загружает плагин по имени (поиск будет производиться как и в папке SAMPFUNCS, так и в корневой папке | <filename> |
| pfree | Выгружает плагин по имени (помимо плагинов SF возможна выгрузка и любых других библиотек) | <filename> |
| preload | Перезагружает плагин | <filename> |
| cs | Загружает CLEO-скрипт | <filename> |
| chatcmds | Выводит список пользовательских (зарегистрированных скриптами и плагинами) чат-комманд | <filename> |
| help | Выводит список всех доступных консольных команд или, если указан параметр, описание конкретной команды | [command] |
¶ Макросы
С версии 5.2.2 в SAMPFUNCS стали доступны пользовательские макросы, которые задаются в файле настроек плагина.
Суть макросов заключается в автоматической замене определенного текста на другой, при выполнении консольной команды.
Список макросов располагается в секции "Macro" в файле настроек (по умолчанию он пуст). Формат макроса состоит из ключа (заменяемого текста) и значения (текста, на который заменяется) и выглядит так: KEY = VALUE. При вводе в консоль команды KEY TEST (макросы чувствительны к регистру) она автоматически заменится на VALUE TEST и перейдёт к выполнению. Макросы могут быть вложенными.