Lua API.md

Данная документация актуальна только для IsLua = true команд, для обычных команд документация есть по команде @helpcmd regcmd

Лимиты

Лимит на выполнение: 150 МиБ оперативной памяти, 10 секунд времени

Заблокированные функции, библиотеки:

os.execute, os.exit, os.getenv, os.remove, os.setlocale, os.rename, os.tmpname, io (весь), debug (весь), require, print

Структура команды

Lua команды в боте обязаны возвращать результат своей работы с типом string. Еcли нужен многострочный вывод, используйте символ \n.

Простой пример команды:

return _VERSION .. " время: " .. os.date()
-- Напишет в чат: Lua 5.4 время: Thu Jul  2 11:08:43 2020

Глобальные переменные в окружении с типом string

RANDOM_NICK - Случайный ник из базы с антихайлайтом (сохраняется при вводе)

CMD_NAME - Имя вызванной команды

CMD_OWNER - Владелец вызванной команды

CMD_ARGS - Аргументы команды

Класс Cmd:

Данный класс содержит все функции для работы с командами

table:string = Cmd:GetCommandOutput(string input, string command)

Получить вывод из IsLua = false команды

command - Команда (вводить с @), возвращает nil в случае если команда не найдена или эта команда является Lua-командой

input - Значение заполнителя #USERINPUT

string:data = Cmd:GetLocalStorage()

Получить данные пользователя который вызвал команду. Возвращает nil если данные для пользователя отсутствуют

bool:success = Cmd:SetLocalStorage(string data)

Установить (полная перезапись ранних данных) данные для пользователя который вызвал команду. Возвращает true в случае успеха или false в случае неудачи (превышен лимит 1 КиБ на данные)

bool:success = Cmd:AppendLocalStorage(string data)

Добавляет значение к ранее записанным данным для пользователя который вызвал команду. Возвращает true в случае успеха или false в случае неудачи (превышен лимит 1 КиБ на данные). Рекомендуется убедиться что данные существуют перед добавлением!