RakBot Wiki

Качай аккаунты не напрягаясь!

Инструменты пользователя

Инструменты сайта


scripting:functions

Список Lua-функций RakBot

Здесь предоставлен список функций RakBot для использования в Lua-скриптах. Помимо данных функций можно использовать стандартные функции языка Lua.

Скрипты для RakBot необходимо помещать в папку «scripts» с расширением «.lua» (файл должен быть обязательно в кодировке ANSI!)

События

События - функции, которые вызываются самим ботом, когда происходит какое либо событие. Данные функции перечислены ниже.

Функция Описание
onScriptStart() Вызывается при загрузке скрипта
onScriptExit() Вызывается при выгрузке скрипта
onRunCommand(cmd) return bool (найдена ли команда), вызывается после отправки команды в бот
onPrintLog(msg) return bool (true - не показывать текущую строку лога в боте), Вызывается при добавлении строки в лог-список
onDialogShow(id, style, title, btn1, btn2, data) return bool (закрыть диалог), вызывается при получении диалога
onBotSpawn(x, y, z) вызывается, когда бот был заспавнен, в аргументах содержит координаты спавна
onSetPosition(x, y, z) вызывается, когда позиция бота была изменена, в аргументах содержит новые координаты
onConnect() вызывается, когда бот был подключен к серверу
onGameInited() вызывается после инициализации сервера
onServerJoin(id, name) вызывается, когда другой игрок подключился к серверу, в аргументах содержит ID и имя игрока
onServerQuit(id, reason) вызывается, когда другой игрок отключился от сервера, в аргументах содержит ID игрока и причину отключения
onSetHealth(health) вызывается при изменении ХП бота сервером, в аргументах содержит новый уровень здоровья
onSetMoney(money) вызывается при изменении количества наличных сервером, в аргументах содержит новое значение суммы на руках
onScriptUpdate() вызывается циклически для выполнения действий независимо от других событий
onRecvPacket(id, data, size) вызывается при получении пакета
onSendPacket(id, data, size) вызывается при отправке пакета
onRecvRPC(id, data, size) вызывается при получении RPC
onSendRPC(id, data, size) вызывается при отправке RPC

Функции

Данные функции Вы можете вызывать из своих скриптов для выполнения каких-либо действий или получения информации.

Функция Описание
printLog(text) добавить лог-строку
runCommand(cmd) выполнить команду
getBotInfo() return string (информация из окошка справа), возвращает информацию о боте
getBotPos() return float, float, float (x, y, z), возвращает позицию бота
getPlayerInfo(id) return bool, string, integer, float, float, float (подключен, ник, уровень, координаты: x, y, z), возвращает информацию об игроке с определенным id
sendDialog(id, btn, item, input) отправляет ответ на диалог
openUrl(url) return string (тело ответа), отправка get запроса по url
getNickName() return string (ник), получение ника бота
getServerAddress() return string (IP адрес), получение адреса сервера
getServerName() return string (название сервера), получение названия сервера
sleep(time) задержка <time> миллисекунд
sendPacket(data) отправка пакета с данными data (data - указатель на битстрим, о нем ниже будет)
sendRPC(id, data) отправка RPC с ID = id и данными = data (data - указатель на битстрим, о нем ниже будет)
bitStreamNew() создание нового объекта битстрим с пустыми данными, возвращает указатель на него
bitStreamInit(data, size) создание нового объекта битстрим из готовых данных (data - указатель на данные, size - размер), возвращает указатель на него
bitStreamData(bs) возвращает данные потока битстрим
bitStreamSize(bs) возвращает размер данных потока битстрим
bitStreamDelete(bs) удаляет объект битстрим (принимает указатель на объект, указание неверного вызовет краш!)
bitStreamIgnore(bs, amount) игнорирует байты в потоке битстрим (bs - указатель на объект, amount - количество)
bitStreamReset(bs) очистить поток битстрим
bitStreamSetReadOffset(bs, offset) установить смещение чтения
bitStreamSetWriteOffset(bs, offset) установить смещение записи
bitStreamReadByte(bs) считывает 1 байт из потока (bs - указатель на объект), возвращает считанные данные
bitStreamReadWord(bs) считывает 2 байта из потока (bs - указатель на объект), возвращает считанные данные
bitStreamReadDWord(bs) считывает 4 байта из потока (bs - указатель на объект), возвращает считанные данные
bitStreamReadFloat(bs) считывает float из потока (bs - указатель на объект), возвращает считанные данные
bitStreamReadString(bs, size) считывает строку из потока (bs - указатель на объект, size - длина строки), возвращает считанные данные
bitStreamWriteByte(bs, val) записывает 1 байт в поток (bs - указатель на объект, val - значение для записи)
bitStreamWriteWord(bs, val) записывает 2 байта в поток (bs - указатель на объект, val - значение для записи)
bitStreamWriteDWord(bs, val) записывает 4 байта в поток (bs - указатель на объект, val - значение для записи)
bitStreamWriteFloat(bs, val) записывает float в поток (bs - указатель на объект, val - значение для записи)
bitStreamWriteString(bs, str, size) записывает строку в поток (bs - указатель на объект, str - строка для записи, size - длина строки)
getPassword() получить пароль для логина
getMail() получить почту для регистрации
getReferer() получить ник пригласившего
getSex() получить пол для регистрации (1 - мужской, 0 - женский)
setOwnAutoReg(state) включить собственную авторегистрацию (state=true - отключает встроенную в боте авторегистраци, state=false - включает авторегистрацию в боте)
scripting/functions.txt · Последние изменения: 2018/04/20 21:37 (внешнее изменение)

Инструменты страницы