Добро пожаловать в документацию по WoWnikBot!¶
Команды¶
Триггеры¶
Триггеры это перечисление возможных слов в сообщении пользователя, необходимые для срабатывания команды.
Типы триггеров¶
- «first»: Первое слово есть среди триггеров.
- «just»: Сообщение состоит только из одного слова и оно есть среди триггеров.
- «begin»: Сообщение начинается с одного из триггеров.
- «end»: Сообщение оканчивается на один из триггеров.
- «find»: В любом месте сообщении есть один из триггеров.
- «find_all»: В любом месте сообщения каждый триггер встречается хотябы раз.
- «find_word»: Один из триггеров является отдельным словом в сообщении.
- «find_word_all»: Все триггеры является словами в сообщении.
Правила триггеров¶
- Все триггеры перечисляются по отдельности в каждом поле.
- В случае если допущена ошибка в написании тригеров, команда просто не сработает.
- ТриГгеРу нАПлЕваТь Как тЫ нАпиШЕшь СооБщЕНИе.
Ответные сообщения¶
Ответные сообщения - одно из них будет отправлено в чат в случае срабатывания
Правила ответных сообщений¶
- Все сообщения перечисляются по отдельности в каждом поле.
- В случае если допущена ошибка в написании сообщения, команда просто не сработает.
- В случае если тригер сработал будет выбрано одно из сообщений из списка.
- Для добавления аддонов используется синтаксис {{ service.command }} или {{ service.command(5, [3,4,6]) }}. Все аргументы должны идти в правильном порядке. Если какой-то параметр не используется, то можно на его месте написать None (без кавычек и всего прочего, просто None).
- Кстати можно использовать аддоны внутри аддонов.
Аддоны¶
Base¶
base.time_now - Возвращает текущее время на сервере (Москва).
base.randint(a, b) - Возвращает случайное число от a до b.
base.randlist(l) - Возвращает случайный элемент списка l. Список задается как [4,56,“string“].
base.part(a, b) - Возвращает слова из сообщения начиная с a и заканчивая b. Слова считаются с 0. Если указать только a, то будет браться сообщение до самого конца.
base.calculate(st) - Возвращает результат операции из st. Можно вырезать часть сообщения пользователя используя part(1) и поместить это в calculate.
base.last_message(user) - Возвращает последнее сообщение пользователя user в чате. В случае если пусто, то использует отправителя.
base.convert(st) - Возвращает перевернутую ru-en строку.
base.commands - Возвращает ссылку на команды ботов.
base.site - Сайт бота.
base.iif(req, st1, st2) - Возвращает st1 если req, иначе st2.
Command¶
command.id - Id команды.
command.name - Название команды.
command.type - Тип команды.
command.triggers - Триггеры команды.
command.messages - Сообщения команды.
command.userlevel - Уровень доступа команды.
command.count - Количество использований команды.
command.cooldown - Откат команды.
command.last_call_date - Время последнего вызова команды в unix формате.
Games¶
games.ball8 - Случайный ответ на вопрос типа да/нет.
Hug¶
hug.megakus - Полноценная команда. Кусание с повреждением частей тела.
hug.kus - Полноценная команда. Кусание.
Message¶
message.time - Время отправки сообщения.
message.chan - Текущий канал.
message.user - Отправитель.
message.text - Текст сообщения.
message.converted_text - Конвертированный в другую раскладку текст сообщения.
message.badges - twitch-badges.
message.bits - twitch-bits.
message.color - Цвет ника отправителя.
message.display_name - Отображаемое имя отправителя.
message.emotes - .
message.id - twitch_id сообщения
message.mod - Модер ли отправитель?
message.room_id - room_id
message.subscriber - Подписчик ли отправитель?
message.tmi_sent_ts - tmi_sent_ts
message.turbo - turbo
message.user_id - twitch-user_id
message.user_type - user_type
Twitch¶
twitch.uptime(also) - Возвращает время трансляции. В случае, если трансляция не запущена, то возвращает also.
twitch.follow_age(also) - Возвращает длительность подписки отправителя. В случае если человек не подписан возвращает also.
twitch.random_user - Возвращает случайного пользователя из чата.
Weather¶
weather.now - Полноценная команда. Возвращает погоду в месте, написанном после первого слова в сообщении.