PangobotДокументация
RU
Интеграции

Minecraft Whitelist Премиум · 7,99 €

Ваш сервер Discord решает, кто может заходить на ваш сервер Minecraft: участники привязывают аккаунт по коду, роли и тайм-ауты учитываются, команда сервера может одобрять.

Minecraft Whitelist — премиум-модуль: 7,99 €, один раз, для одного сервера — без подписки. В панели управления заблокированный модуль показывает все настройки в режиме предпросмотра ещё до покупки. Как устроен премиум

Ваш сервер Discord решает, кто может заходить на ваш сервер Minecraft. Участники привязывают аккаунт Minecraft коротким кодом; после этого ваши роли, тайм-ауты и уход с сервера действуют и на сервере Minecraft — в течение секунд.

Setting it up

  1. На странице модуля нажмите Подключить сервер Minecraft и дайте ему название. Pangobot покажет токен — один раз.
  2. Скачайте там плагин и положите его в папку plugins сервера. Запустите сервер один раз: плагин создаст файл plugins/Pangobot/pangobot.properties.
  3. Вставьте в этот файл две строки из панели управления. Они считываются за несколько секунд — без перезапуска. После этого страница модуля покажет сервер как онлайн и то, на чём он работает.
  4. Выберите, кто может заходить: роли, время на сервере, одобрение командой сервера. Опубликуйте кнопку Привязать аккаунт Minecraft командой /minecraft panel или расскажите участникам о /minecraft link.

Как участник попадает на сервер

  1. Они заходят на сервер Minecraft. Он отключает их и показывает код из шести букв и цифр, который действует 10 минут.
  2. В Discord они используют /minecraft link (или кнопку) и вводят код в поле.
  3. Они заходят снова — и попадают на сервер, если это позволяют настройки. При Сначала одобряет команда сервера запрос сначала публикуется в вашем канале для одобрения с кнопками Одобрить и Отклонить.

Код доказывает, что запрос отправляет сам игрок Minecraft: никто не может записать чужой аккаунт на своё имя. Аккаунт, привязанный к одному участнику, не может привязать другой — сначала его отвязывает этот участник (или команда сервера) командой /minecraft unlink.

На каких серверах он работает

Один jar-файл для всех: Paper, Spigot, Purpur и Folia начиная с Minecraft 1.8 и прокси BungeeCord, Waterfall и Velocity — в сети серверов ставьте его только на прокси. Он использует только событие входа, которое с тех пор не менялось ни в одной версии, поэтому для новой версии Minecraft новый плагин не нужен. Игроки Bedrock, которые заходят через Geyser и Floodgate, привязывают аккаунт так же; если они вам не нужны, выключите их.

Когда Pangobot недоступен

Собственный белый список вашего сервера (white-list=true) можно не выключать: игрок, которого пускает Pangobot, проходит и через него — отменяется только этот отказ, а бан или заполненный сервер по-прежнему не пускают игрока. В сети серверов, где плагин стоит на прокси, у серверов за прокси не должно быть собственного белого списка.

Плагин хранит список тех, кто может заходить, на диске и обновляет его каждые несколько секунд. Если Pangobot недоступен, все из этого списка по-прежнему заходят; новичка просят попробовать снова через минуту. Пока у плагина ещё нет токена или его токен удалён в панели управления, он никого не проверяет — действует собственный белый список вашего сервера. То же самое, пока модуль выключен или заблокирован.

Команды

<обязательный> [необязательный] — «кто может использовать» указано по умолчанию Discord; администраторы сервера могут изменить это для каждой команды в разделе Настройки сервера > Интеграции.

/minecraft

Все
/minecraft link

Ввести код, который показал сервер Minecraft

/minecraft unlink [account] [member]

Отвязать аккаунт Minecraft

  • accountтекст, необязательноКакой из ваших аккаунтов
  • memberучастник, необязательноДля команды сервера: участник, чей аккаунт нужно отвязать
/minecraft accounts [member]

Показать привязанные аккаунты Minecraft

  • memberучастник, необязательноДля команды сервера: чьи аккаунты показать
/minecraft panel

Для команды сервера: опубликовать в этом канале кнопку «Привязать аккаунт Minecraft»

Настройки

Всё, что можно настроить для этого модуля в панели управления, в том порядке, в каком это показывает страница.

Привязка

После привязкиВыборМогут заходить сразу
Канал для запросов на одобрениеКанал

Каждый новый аккаунт публикуется здесь с кнопками «Одобрить» и «Отклонить». Только при «После привязки»: «Сначала одобряет команда сервера».

Роли, которые могут одобрятьРоли

Помимо участников с правом «Управлять сервером». Только при «После привязки»: «Сначала одобряет команда сервера».

Аккаунтов Minecraft на участникаЧислоот 1 до 51
Сообщение /minecraft panelСообщение

Публикуется с кнопкой, которая открывает поле для ввода кода. Переменная: {server}

Текст кнопкиТекстдо 80 символов«Link Minecraft account»
Дней на сервере Discord до привязкиЧислоот 0 до 3650

0: сразу.

Кто может заходить

Только участники с одной из этих ролейРоли

Если пусто: все участники.

Никогда не пускать участников с одной из этих ролейРоли
Не во время тайм-аутаПереключательВключён

Участник в тайм-ауте не может зайти, пока тайм-аут не закончится. Его аккаунт остаётся привязанным.

Игроки Bedrock (через Geyser и Floodgate)ПереключательВключён
Отключать игроков, потерявших доступ во время игрыПереключательВключён

В течение нескольких секунд — если игрок покинул сервер Discord, потерял роль, получил тайм-аут или его аккаунт отвязали.

Всегда пускать (имена в Minecraft)Списокдо 25 записей

Без привязанного аккаунта — для владельца или члена команды сервера без Discord. Только для сервера в режиме online-mode: в офлайн-режиме любой может зайти под любым именем.

Ограничения

  • Роли, которые могут одобрять: до 10
  • Только участники с одной из этих ролей: до 10
  • Никогда не пускать участников с одной из этих ролей: до 10
  • Всегда пускать: до 25
  • До 3 серверов Minecraft на один сервер Discord.
  • Код действует 10 минут; не больше 6 неверных кодов на участника за 10 минут.
  • Плагин работает на Paper, Spigot, Purpur и Folia начиная с 1.8, а также на BungeeCord, Waterfall и Velocity.

Полезно знать

  • Кто может заходить, определяется при каждом входе, а не хранится: если участник теряет роль, получает исключённую роль или тайм-аут либо уходит с сервера Discord, его аккаунт сразу теряет доступ, а когда роль возвращается, доступ возвращается тоже. С Отключать игроков, потерявших доступ во время игры игрок, который уже на сервере, отключается в течение нескольких секунд.
  • Участник, который уходит с сервера (или получает бан), забирает свои привязки с собой. Всегда пускать — для владельца или команды сервера без Discord: по имени в Minecraft, поэтому только на сервере в режиме online-mode.
  • До 3 серверов Minecraft на один сервер Discord, по одному токену на каждый. Токен работает только для своего сервера и только узнаёт, кто может заходить, — он не может выполнять команды или что-то менять. Потеряли токен? Новый токен сразу отключает старый. Pangobot хранит только его отпечаток.
  • Не больше 6 неверных кодов на участника за 10 минут. Показать привязанные аккаунты — список того, кто какой аккаунт привязал, с кнопками Одобрить и Отвязать.
  • Сообщение, которое /minecraft panel публикует вместе с кнопкой, и текст кнопки — отдельные настройки: напишите свои, с {server} для названия сервера. Если их не менять, они будут на языке вашего сервера.

What the bot needs

  • Просматривать канал, Отправлять сообщения и Встраивать ссылки в канале для одобрения (если аккаунты одобряет команда сервера) и там, где /minecraft panel публикует кнопку.