Бот для дискорда juniperbot
Сегодня многие пользователи VoIP мессенджера устанавливают JuniperBot для Дискорда. Это «пушистый» помощник, ориентированный на предоставление многих функций — прослушивание музыки, напоминание, рейтинг, модерирование, аудит и многое другое. Ниже рассмотрим, как какие опции дает Джунипер Бот в Дискорд, как его установить, и какие команды могут потребоваться. Отдельно обсудим ситуации, когда Bot по какой-то причине не работает.
Что это
Juniper Bot — многофункциональный бот для Дискорда, с возможностью точной настройки и наличием большого числа опций. Все возможности настраиваются в панели управления на сайте. Там же доступен подробный список команд. Официальный сайт JuniperBot — juniper.bot. На главной странице представлен символ бот — приятная по внешности лисичка.
Функции
На фоне большого ассортимента Дискорд помощников JuniperBot выделяется с лучшей стороны. С его помощью можно получить множество дополнительных функций для Discord. Выделим основные направления:
Это лишь часть функций, но уже по ним можно сделать вывод о полезности Джанипер-бота.
Как установить
Если вас устраивают возможности помощника, необходимо знать, как добавить его к себе на сервер Дискорда. Сделайте следующее:
Теперь разберемся, как настроить бота для Дискорд. Для этого сделайте следующее:
Отметим, что лучше всего скачать бота на официальном сайте, чтобы не попасть на версию с вирусом.
Команды
Для пользователей JuniperBot доступно почти 60 команд. Полный список доступен по URL juniper.bot/commands. Мы выделим только основные:
Для удобства желательно изучить список указаний для помощника Дискорд, а уже потом пользоваться ботом.
Проблемы и их решение
Один из распространенных вопросов пользователей Дискорда — что делать, если не работает JuniperBot. В большинстве случаев проблема лежит на поверхности и решается следующими действиями:
Ели рассмотренные действия не дают результата, попробуйте почитать FAQ на официальном сайте, а если в нем нет ответа, пишите в службу поддержки.
Часто задаваемые вопросы#
Заикается/отключается музыка или радио. Что делать?#
У данной проблемы может быть несколько причин:
Какие разрешения необходимы для доступа к панели управления ботом?#
Доступ к панели управления ботом могут получить только владелец сервера и администраторы (пользователи, у которых есть роль с правом «Администратор»).
Будьте внимательны, так как участник с этими правами способен изменить любой параметр в панели управления. Он сможет даже получить роли выше собственных при желании.
Что за печеньки в рангах, профиле пользователя, странице рейтинга?#
Просто счетчик, карма, система репутации. Чтобы повысить этот счетчик, можно:
Один участник другому может дать 🍪 только раз в 10 минут.
Что такое кластер и звено?#
Звено — часть JuniperBot, которая отвечает за обработку определённого набора серверов;
Кластер — физический сервер, который отвечает за обработку определённых звеньев.
Можно ли воспроизвести сохраненный ранее плейлист бота и как это сделать?#
Ссылки на плейлист всегда отображаются в сообщениях о воспроизведении после нажатия кнопки сохранения плейлиста.
Будет ли функционал экономики?#
Не будет. Совсем. Никак. Никогда. Используйте наш шаблонный движок, и сделайте нужный вам функционал сами.
Будет ли поддержка плейлистов и музыки ВКонтакте?#
Нет. Скажите спасибо жадным копирастам, из-за которых ВКонтакте закрыл публичный доступ к инструментарию музыки.
Как рассчитать количество опыта на тот или иной уровень?#
Как настроить экспорт постов из группы ВКонтакте, уведомления о новых видео от YouTube каналов или оповещение о начале трансляции на Twitch?#
В панели управления вашим сервером в разделе «Публикации и подписки» нажмите на плюсик в правом нижнем углу, выберите интересующую Вас платформу и следуйте дальнейшим инструкциям.
Как ограничить использование команды по роли или в каналах?#
Изучите статью Пользовательские команды. Настройки прав доступа применимы и для встроенных команд.
Бот не выдаёт начальную роль и/или не отправляет приветственное сообщение.#
У данной проблемы может быть несколько причин:
Бот не выдаёт/снимает роли.#
У данной проблемы может быть несколько причин:
Информационные сообщения о мьюте/бане/кике/преде участника удаляются через некоторое время. Как это отключить?#
В панели управления в разделе «Общие» в настройках сообщений есть опция «Удалять сообщения об успешных операциях». Введите туда 0 если хотите, чтобы эти сообщения не удалялись.
На каком языке программирования написан бот?#
Бот написан на Kotlin и Java.
У меня есть идея. Где я могу её предложить?#
Вы можете предложить свою идею на нашем фидбэке.
Главная
Привет! Добрo пожaловать в документацию JuniperBot! Здесь ты найдешь много полезной информации о нашем проекте, ответы на часто задаваемые вопросы и многое другое. Воспользуйся главным меню и поиском!
Введение#
JuniperBot — многофункциональный, полностью настраиваемый бот для платформы Discord с множеством полезных и только самых необходимых возможностей для большинства серверов! Все возможности настраиваются в удобной панели управления на сайте, никаких мучений с командами: https://juniper.bot/.
Вот лишь основная часть возможностей лисички:
⚙️ Базовая функциональность: Настройте префикс, язык команд и интерфейса. Обеспечивается поддержка русского и английского языков.
🎵 Музыка (бонус за поддержку): Слушайте музыку из множества различных источников вроде Яндекс.Музыки, Spotify, YouTube, SoundCloud, BandCamp, Vimeo, Twitch.tv и даже некоторые радиостанции из нашего белого списка. Есть возможность ограничить управление музыкой определенным ролям, настроить ограничения плейлистов, автоматическое присоединение к голосовому каналу и не только!
📚 Аудит: Лисичка может вести историю действий на сервере. Модерирование, удаление и изменение сообщений, присоединение и уход участников и много других событий. Удобная хронология действий доступна прямо на сайте с фильтрами по участникам, каналам, типам событий.
📢 Публикации и подписки: Привяжите канал YouTube, Twitch.tv и сообщество ВКонтакте для публикации оповещений о новых видео, стримах и постах прямо в канал на вашем сервере.
🏆 Рейтинг участников: Поощряйте ваших участников за активную жизнь на сервере выдачей ролей при достижении определенных уровней!
👋 Приветствия: Настройте собственные сообщения с приветствием новых участников, назначайте им начальные роли, а также возвращайте предыдущие старым участникам.
💬 Команды: Настройте поведение всех команд под свои нужды — кулдаун, ограничения по ролям и каналам.
📝 Пользовательские команды: Вы также можете добавить собственные команды с текстовым ответом, вызовом встроенной команды, изменением ролей и даже более сложным программируемым поведением, используя шаблоны сообщений. Их можно настраивать так же гибко, как и встроенные команды!
🎭 Весёлости: Реализовано немного забавных вещей вроде смайл-рулетки, системы кармы по печенькам, команд с картинками котов, собачек, лисичек, магический шар и другие мелочи.
Добавление на сервер#
Чтобы добавить бота на сервер, нужно:
При добавлении бота выбраны все необходимые права для его корректной работы. Право администратора выбрано в том числе и его можно отключить если вы действительно понимаете что делаете.
Для корректного функционирования JuniperBot рекомендуется оставить все галочки при выборе прав как есть.
Языки интерфейса и названий команд по-умолчанию зависят от основного языка сервера если включено Сообщество. В противном случае, язык по-умолчанию будет Английский.
Язык можно поменять в панели управления сервером в разделе Общие.
Функции
Описание всех глобальных функций шаблонного движка JuniperBot
Логические функции#
defined #
Данная функция полезна для проверки определено ли указанное выражение или нет. Возвращает true если выражение определено и false в противном случае.
iterable #
Эта функция позволяет проверить, является ли аргумент допустимым для итераций объектом (список или карта).
number #
Эта функция позволяет проверить, является ли аргумент числом или конвертируемым в число объектом.
empty #
Математические функции#
round #
Функция округления дробного числа к целому. Опционально можно указать стратегию округления вторым аргументом:
Операции над строками#
number_format #
Функция number_format позволяет форматировать указанное число с указанными символами для разделителей группы разрядов и дробной части, а также с указанным количеством дробных цифр. Эта функция ожидает как минимум один аргумент и до четырех. Список аргументов в том порядке, как они ожидаются функцией:
capitalize #
Эта функция капитализации строки ожидает один аргумент. В результате выполнения функции первое слово строки станет с заглавной буквы.
format #
Данная функция принимает строку-шаблон, форматируя её с помощью переданных последующих аргументов. Более подробно о форматировании строк можно почитать в интернете.
lower #
Преобразует переданную строку в нижний регистр.
upper #
Преобразует переданную строку в верхний регистр.
replace #
Данная функция принимает на вход строку и карту, заменяя в строке все вхождения ключей карты на соответствующие им значения.
split #
Данная функция ожидает два аргумента. Используя второй аргумент как разделитель, она разбивает первый аргумент-строку в список.
В качестве разделителя используется регулярное выражение.
title #
Эта функция преобразует каждое слово входной строки так, что оно будет начинаться с заглавной буквы.
Эта функция избавит входную строку от пробелов в начале и в конце этой строки.
Предыдущий пример распечатает Hello World без пробелов.
startsWith #
Эта функция проверяет, начинается ли одна строка с другой указанной строки.
Она также может принимать третий логический аргумент как признак того, нужно ли сравнивать строки без учета регистра:
endsWith #
Эта функция проверяет, заканчивается ли одна строка другой указанной строкой.
Функция также может принимать третий логический аргумент как признак того, нужно ли сравнивать строки без учета регистра:
contains #
Эта функция проверяет, содержит ли одна строка другую подстроку.
Функция также может принимать третий логический аргумент как признак того, нужно ли сравнивать строки без учета регистра:
plural #
Эта функция поможет правильно выбрать нужную количественную форму слова или словосочетания в зависимости от указанного числа и языка (количественные числительные). Команда принимает до восьми аргументов, набор которых зависит от выбранного языка.
Для английского языка#
Для русского языка#
Смешанные функции#
random #
Эта функция возвращает произвольный элемент из переданного списка или произвольное число из указанного диапазона.
Предыдущий пример распечатает случайное целое число от 10 до 20 включительно.
first #
reverse #
Эта функция возвращает перевернутый в обратном порядке список или строку. Если переданный аргумент не список и не строка, функция просто вернет этот аргумент.
default #
length #
Списки и карты#
batch #
Эта функция разделяет переданный список на равные группы списков. Она ожидает два или три аргумента:
concat or concatenate #
Эта функция объединит множество строк в одну строку.
Эта функция возвращает значения ключей для указанной коллекции (списка или карты). Для списков ключами являются индексы элементов.
slice #
Эта функция возвращает подстроку или часть списка и ожидает три аргумента, где первый аргумент — список или строка, а второй и третий — числа.
Второй аргумент — индекс позиции первого символа или элемента списка (включительно), а третий — длина ожидаемой подстроки или подсписка. Как показано на предыдущих двух примерах, они распечатают «2» и [1, 2] соответственно. Обратите внимание, что функция безопасна для выходящих за размеры значений, например:
Предыдущие примеры все еще распечатает подстроки «3» и «» соответственно.
Эта функция отсортирует переданный список по возрастанию.
Дата и время#
Эта функция форматирует переданную дату в указанный формат. Функция принимает от одного до трёх аргументов:
calendar #
Эта функция создает новый экземпляр DateTime. Принимает до двух аргументов:
Так как функция возвращает экземпляр DateTime, вы можете использовать его функциональность, например:
Предыдущий пример распечатает две даты с разницей в 5 часов:
duration #
Эта функция форматирует указанный интервал времени в читаемый формат. Принимает до двух аргументов:
Взаимодействия#
reaction #
Эта функция добавит к результирующему сообщению шаблона реакцию с указанной эмоцией. Принимает единственный аргумент с эмоцией в следующих форматах:
Серверам без бонусов поддержки доступно добавление только одной реакции к сообщению. Поддержавшим нас доступно добавление до пяти реакций на серверах с активным бонусом!
button #
Эта функция добавит к результирующему сообщению шаблона кнопку. Принимает пять строковых аргументов.
Кнопки, выполняющие Действия, то есть все стили кнопок, кроме кнопок-ссылок, доступны только в пользовательских командах.
Пользовательские команды
Вы можете создавать свои команды, которые могут выполнять определенные действия.
Пользовательские команды (кастомные команды) создаются и настраиваются в панели управления сервера во вкладке с названием «Команды». Любую пользовательскую команду можно отключить при необходимости и настроить необходимые права доступа аналогично встроенным командам бота.
Интерфейс настроек#
У каждой команды есть определенный набор общих настроек:
Интерфейс настроек команды
Команда — имя команды, по которому она будет вызываться в Discord;
Действие команды — действие по-умолчанию, которое будет выполнено для этой команды;
Краткое описание — просто краткое описание данной команды, которое отображается в списке пользовательских команд, а также в справке самого бота в Discord;
Права доступа и выполнение — описывает права доступа к команде по ролям, каналам, типу каналов и как часто можно вызывать команду (кулдаун);
Слэш-команда — позволяет включить и настроить эту команду как слэш-команду, более подробно описано в разделе Слэш-команда.
Слэш-команда#
Пользовательская команда может быть включена как Слэш-команда с возможностью использования параметров и даже разделения на подкоманды. Интерфейс настроек слэш-команды интуитивно понятен и не требует пояснения.
Для получения нужного параметра следует использовать следующий синтаксис:
Кроме этого, можно получить список всех параметров определённого типа:
Более подробно в описании типа данных Arguments.
Слэш-команды имеют некоторые ограничения:
Все ограничения, описанные в общем разделе Слэш-команд;
Корневая слэш-команда может содержать либо параметры, либо подкоманды, но не вместе;
Максимум 25 параметров на корневую команду или подкоманду;
Максимум 25 подкоманд;
Максимум 25 вариантов выбора для параметров строк или чисел;
Максимум 20 пользовательских команд с включенной слэш-командой.
Горячие клавиши#
В диалоге создания или редактирования пользовательской команды можно использовать горячие клавиши:
Сtrl+S — быстрое сохранение команды;
F11 — переход в полноэкранный режим активного поля шаблона сообщения.
