Link2It (Линк 2 ит)

Плагин для серверов Майнкрафт, который связывает игровой аккаунт с Discord и использует эту связь для защиты сервера. Он подтверждает входы сотрудников через Discord, синхронизирует роли с LuckPerms и может выдавать награды игрокам, поддерживающим Discord-сервер.

Возможности

• Игрок получает шестизначный код командой в игре и вводит его через кнопку или слеш-команду в Discord. Код не публикуется в канале.
• После привязки игроку можно выдать Discord-роль, сменить никнейм в Discord на игровой и выполнить настроенные команды-награды. Награда выдаётся один раз на аккаунт.
• Параметр link.required оставляет непривязанного игрока на сервере, но запрещает движение до завершения привязки.
• Параметр link.confirm-in-game просит подтвердить в игре, что привязываемый Discord-аккаунт принадлежит игроку.
• Операторы и игроки с правом link2it.2fa.required при входе не могут двигаться, писать в чат и выполнять команды, пока не одобрят вход через карточку в Discord. При отказе выполняются защитные команды из конфига, а игрок отключается от сервера.
• Если Discord недоступен, для двухфакторной проверки подходят одноразовые коды из приложения-аутентификатора или резервные коды. QR-код для настройки показывается на карте в руке игрока; её нельзя выбросить, положить в сундук или потерять после смерти.
• Выбранные опасные команды, например /op, /ban и /stop, требуют отдельного одобрения в Discord. Список таких команд задаётся в конфиге.
• При установленном LuckPerms группы и Discord-роли синхронизируются в обе стороны, включая удаление роли или группы.
• Для бустеров Discord доступны группы в игре и меню наград из трёх уровней. Уровень определяется Discord-ролями, настроенными на сервере.
• Внутриигровая панель содержит настройки, карточки игроков и журнал действий. В режиме ui.mode: CHEST интерфейс заменяется меню сундука.
• Данные двухфакторной проверки шифруются, а IP-адреса хранятся только в виде хешей.

Команды

Для привязки и проверки используются /esle или /link, /dogrula <code> или /verify, /esle coz, /2fa или /twofactor, /boost.

Управление доступно через /link2it panel, а также подкоманды durum, yenile, panel-gonder, bilgi, coz, liste, odul, onayla, ip-engel-kaldir; сброс двухфакторной проверки игрока — /2fa sifirla <player>.

В Discord работают /esle <code>, /hesabim, /coz, /l2i kim, /l2i coz, /l2i durum и /l2i senkron.

Для PlaceholderAPI предусмотрены плейсхолдеры %link2it_linked%, %link2it_discord%, %link2it_discord_id%, %link2it_date%, %link2it_2fa%, %link2it_boost% и %link2it_total%.

Права

• link2it.2fa.required — требует двухфакторного подтверждения при входе.
• link2it.admin — позволяет менять в панели настройки, которые выполняют консольные команды: награды, команды при отказе и соответствия ролей.

Настройка

Основные параметры находятся в plugins/Link2It/config.yml: токен Discord-бота, идентификаторы сервера и каналов, правила привязки, роли, награды и защищаемые команды. Команда /link2it panel меняет большинство параметров из игры, сохраняя комментарии в конфиге.

Для синхронизации ролей и наград бустеров Discord-боту нужны права на отправку сообщений, управление ролями и никнеймами; роль бота должна стоять выше ролей, которые он выдаёт. Для привязки панели в Discord используется /link2it panel-gonder.

Тексты чата, окон и карточек Discord находятся в messages.yml и доступны для перевода. Встроенный язык плагина — турецкий; названия слеш-команд Discord и часть фиксированных ответов остаются на турецком.

Требования

• Paper или Spigot и Java.
• Discord-бот.
• LuckPerms — для синхронизации групп и ролей.
• PlaceholderAPI — для плейсхолдеров.
• SQLite либо MySQL/MariaDB, если данные нужно разделить между несколькими серверами.
• Доступ к Maven Central при первом запуске для загрузки библиотек.