Бот Discord и панель
Добавьте бота Luaward на сервер, оформите его панель и профиль под свой бренд, используйте один вид на нескольких серверах и добавьте собственные языки.
Что делает бот
Игроки нажимают кнопку на панели на вашем сервере Discord, чтобы получить скрипт, привязать ключ, сбросить устройство, посмотреть свой ключ или получить роль. Вы решаете, как выглядят панель и бот на каждом сервере, и можете использовать один и тот же вид на любом числе серверов.
Подключение сервера
- Откройте Dashboard → Connections и нажмите Manage на карточке Discord.
- Нажмите Add the bot, выберите проект, затем выберите сервер на странице самого Discord. Discord вернёт вас в Luaward, и сервер подключится сам.
- Если удобнее ввести код, откройте Use a code instead, скопируйте одноразовый код и выполните на сервере
/connectс этим кодом. Код действует один раз и живёт 15 минут.
Подключить сервер может только владелец рабочего пространства или администратор, и сервер принадлежит одному рабочему пространству за раз. Бот запрашивает только нужные права: просмотр каналов, отправку сообщений, вставку ссылок, смену собственного ника и управление ролями (для кнопки получения роли). Права Administrator он не запрашивает никогда.
Когда сервер подключён, карточка Discord показывает ваши серверы с их значками. Откройте один, чтобы перейти к его настройкам. На странице нет отдельной кнопки «назад»; переходить в другие места можно через боковую панель и страницу Connections.
Страница сервера
Страница это ряд вкладок на всю ширину с предпросмотром рядом (на телефоне предпросмотр это отдельная вкладка). Предпросмотр рисуется тем же кодом, которым бот публикует панель, поэтому он показывает то, что увидит Discord. Пока есть несохранённые изменения, внизу появляется полоса: Save сохраняет их, Discard отбрасывает.
| Вкладка | Что вы меняете |
|---|---|
| Overview | Есть ли бот на сервере, что ещё нужно сделать, какому шаблону следует сервер, какой проект он использует, а также отключение. |
| Bot | Имя, картинка, баннер и текст «о боте» на этом сервере. |
| Look | Embed или Components V2, малая и большая картинки, цвет полосы и какие части показывает панель. |
| Words | Заголовок, текст, подвал, ваше собственное краткое руководство и дополнительные поля. |
| Languages | На каком языке говорит панель и языки, которые вы добавляете сами. |
| Buttons and form | Порядок, названия и цвета кнопок, кнопки-ссылки и форма, которую игроки получают по Redeem key. |
| Post | Отправка панели в канал или обновление уже опубликованной. |
Любая настройка, которую вы оставили пустой, использует стандартный текст Luaward, поэтому новый сервер работает ещё до того, как вы что-либо измените.
Имя, картинка и подвал бота по тарифам
На Free бота зовут «Luaward», а подвал «Powered by Luaward». Начиная с Starter вы задаёте имя, картинку, баннер и текст о боте для каждого сервера и пишете собственный подвал. Заголовки, тексты, картинки, цвета, кнопки и языки бесплатны на всех тарифах. Если тариф закончится, платные части вернутся к стандартным при следующей отрисовке панели; остальные настройки сохранятся.
Нажмите Apply to the server на вкладке Bot, чтобы отправить в Discord имя, картинку, баннер и текст. Перед этим всё сохраняется автоматически. Discord требует, чтобы бот состоял в сервере, а для ника нужно право «Change Nickname».
Embed или Components V2
Embed это классическая карточка с цветной полосой сбоку. Components V2 это новый макет Discord с разделами, большими картинками и разделителями. В обоих случаях используются одни и те же слова и кнопки. Сообщение, опубликованное как embed, можно перевести в V2 после подтверждения, но сообщение V2 никогда не вернуть в embed: опубликуйте новое сообщение.
Шаблоны: один вид для нескольких серверов
Шаблон (preset) это вид, который можно использовать на многих серверах. Сервер, следующий шаблону, получает все изменения шаблона и хранит только те немногие настройки, которые вы изменили для него.
- Создайте шаблон на вкладке Overview: Choose a preset → New preset from this server. Текущий вид сервера копируется в него, и сервер начинает ему следовать.
- Используйте его на другом сервере в том же окне. Включите Keep this server's own changes, если сервер должен сохранить то, что уже изменил.
- Save to: пока сервер следует шаблону, полоса над вкладкой спрашивает, куда сохранять: This server only или The preset (all servers). Сохранение в шаблон также удаляет собственную копию этих же настроек на этом сервере, и он снова следует шаблону.
- Back to the preset: вкладка с настройками, отличающимися от шаблона, показывает их число и кнопку, которая их отбрасывает.
- Stop using a preset оставляет текущий вид как собственный для сервера. Удаление шаблона делает то же самое для всех серверов, которые его использовали.
Ваши собственные языки
На вкладке Languages пункт Panel language это язык Discord каждого игрока или один язык для всех. Add a language, чтобы написать панель, названия кнопок, краткое руководство, форму Redeem key и ответы бота на любом языке Discord. Тайский или английский тоже можно переписать строка за строкой. Любое пустое поле использует встроенный тайский или английский, в зависимости от выбранного резервного языка. Можно добавить до 20 языков.
Слова в фигурных скобках, например название проекта или число дней, подставляются сами там, где поле это допускает.
Кнопки и форма ключа
Перемещайте, переименовывайте, перекрашивайте или отключайте каждую кнопку и добавляйте до пяти кнопок-ссылок. Каждая кнопка носит один из собственных значков Luaward; введите эмодзи в поле эмодзи кнопки, чтобы использовать свой. Блок Key form задаёт заголовок, текст и названия полей формы, которую игроки получают по Redeem key; эти слова действуют во всех языках, а пустое поле использует текст конкретного языка. Поле ключа есть всегда и всегда обязательно.
Что получает игрок по кнопке «Получить скрипт»
Если скрипт один, игрок получает его сразу, с уже подставленным своим ключом. Если их несколько, сначала меню спрашивает, какой нужен, поэтому ничего длинного не отправляется, пока игрок не выберет, а то же меню остаётся под скриптом для переключения. Игроку с несколькими ключами добавляется ещё и меню ключей; лучший ключ выбирается за него (сначала бессрочный, затем самый долгий, закончившиеся в конце). Под каждым скриптом зелёная кнопка Mobile copy отправляет скрипт простым текстом, так что на телефоне достаточно удержать это сообщение и выбрать «Копировать текст», чтобы скопировать всё сразу. Скрипт без ключа предлагается всем, остальные только игрокам, у которых есть ключ в этом проекте.
В меню каждый скрипт показывает свою картинку: ту, что вы загрузили для него, иначе значок его игры, иначе картинку проекта, а если ничего нет, значок Luaward. Luaward превращает эти картинки в эмодзи собственного приложения Discord (картинка скрипта загружается в Discord таким образом) самостоятельно: когда игрок нажимает «Получить скрипт», а у скрипта ещё нет эмодзи картинки, а также после того, как вы публикуете или обновляете панель либо открываете вкладку Правила. Неготовая картинка показывается значком а сама картинка появляется в течение пары минут.
Правила для игроков
Вкладка Правила задаёт, что бот позволяет игроку на этом сервере. Как и остальная часть страницы, правила можно делить через шаблон и менять для одного сервера.
- Что выдаёт «Получить скрипт»: каждый скрипт (меню loader'ов), Loader Universe (одна ссылка, которая работает в любой игре и сама находит нужный скрипт) или оба варианта в одном меню. Вы выбираете, какие Loader Universe и какие скрипты предлагает бот; «Все скрипты» включает и те, что вы добавите позже. Loader Universe работает только с ключами проектов, которые он включает, и страница предупредит, если выбранный не включает проект этого сервера.
- Сколько ключей может привязать игрок: максимум ключей, которые один аккаунт Discord может привязать кнопкой активации ключа, от 1 до 10 или без ограничения. Ключи с истёкшим сроком и заблокированные не считаются, а ключи, выданные администратором через
/whitelist, не ограничиваются. - Сброс устройства: правила кнопки сброса устройства только на этом сервере; настройка проекта (панель управления, страница игрока Loader Universe) не меняется. Следуйте проекту или задайте свои: разрешён ли сброс, сколько дней ждать, максимум сбросов на ключ за всё время и за любые 30 дней (считаются только сбросы самого игрока, не администратора) и нужно ли сначала спрашивать с предупреждением и кнопками Сбросить сейчас и Отмена. Строка Сброс устройства на панели показывает правила, по которым работает бот.
Изменение только правил не делает опубликованную панель устаревшей, потому что ни одно сообщение не меняется.
Публикация панели
На вкладке Post выберите канал, в который бот может писать, и нажмите Post. После этого та же страница предлагает Update the posted panel, который правит сообщение на месте. Несохранённые изменения сначала сохраняются. Если Discord не подтвердил публикацию, страница сообщит об этом и подождёт; проверьте канал, прежде чем пробовать снова.
Перенос или отключение сервера
На вкладке Overview можно направить сервер на другой проект того же рабочего пространства или отключить его. После отключения сообщение с панелью остаётся в Discord, но кнопки перестают работать, а собственные настройки сервера удаляются. Ваши шаблоны сохраняются, и сервер можно подключить снова позже.
Лимиты запросов
Один человек может обращаться к боту 30 раз в минуту, а сервер в целом 1200 раз в минуту; обычный сервер до этого предела не доходит. Кто превысил лимит, получает короткий ответ «слишком много запросов» и может повторить через минуту. Если Luaward на какое-то время не может считать запросы, кнопки, которые только показывают данные (получить скрипт, посмотреть свой ключ), продолжают работать, а те, что что-то меняют (сброс устройства, получение роли, активация ключа и команды администратора), просят игрока повторить чуть позже.
Делайте это из кода
Всё, что есть на этой странице, доступно и через API для разработчиков, SDK и инструменты MCP.