ZLDiscord: связь Minecraft и Discord с голосованиями

ZLDiscord — мощный плагин для связи Minecraft и Discord

Каждый администратор сервера Minecraft рано или поздно сталкивается с задачей объединить игровой чат и Discord-сообщество. Хочется, чтобы игроки могли голосовать за события прямо из игры, получать уведомления о войсах и управлять сервером через удобные команды. Плагин ZLDiscord решает эти проблемы на новом уровне, предлагая гибкую систему взаимодействия между сервером и Discord-каналом. Он работает на версиях от 1.16.5 до 1.20.x и требует Java 17, а также обязательную зависимость PlaceholderAPI. Скачать сам плагин и ознакомиться с документацией можно на официальном сайте разработчика, а для быстрой установки удобно использовать лаунчер foxygame.net — современный инструмент, который позволяет загружать моды и плагины прямо из меню, не тратя время на ручной поиск файлов.

Что умеет ZLDiscord

ZLDiscord — это не просто мост между чатами. Плагин предлагает продвинутые функции, которые превращают сервер в единую экосистему. С его помощью вы сможете:

• Создавать голосования (ивенты) прямо из игры или Discord, указывая команду, которая выполнится по завершении.
• Формировать красивые Embed-сообщения в Discord с кастомными заголовками, описанием, картинками и иконками.
• Управлять кастомными командами с шаблонным движком — можно прописать целые сценарии, например, лечение игрока и одновременный бродкаст.
• Хранить и изменять атрибуты игроков, ботов и участников Discord через DataStore.
• Настраивать LongPoll-соединения с авто-переподключением для интеграции с внешними API.
• Привязывать и отвязывать аккаунты Minecraft к Discord для персонализации.

Команды в игре

Все игровые команды начинаются с префикса /z и имеют гибкие параметры. Вот основные из них:

• /zevent "название" "команда" "время" "channel_id" — создаёт новый опрос в указанном Discord-канале. Права: zoliryzik.zevent.
• /zcc list/run/create/remove/reload <имя> — управление кастомными командами. Можно создавать сложные последовательности действий. Права: zoliryzik.zcc.
• /zembed "имя" "заголовок" "описание" "channel_id" [изображение] [миниатюра] [футер] [иконка] — отправляет Embed в Discord. Права: zoliryzik.zembed.
• /zattr get/set/inc/dec bot|member|player <ключ> [значение] — работа с атрибутами DataStore. Права: zoliryzik.zattr.
• /zlongpoll create/list/remove/reload <имя> <url> <ключ> [ожидание] — настройка LongPoll-соединений. Права: zoliryzik.zlongpoll.
• /zlink и /zunlink — привязка и отвязка Discord-аккаунта. Права: zoliryzik.zlink и zoliryzik.zunlink.

Команды в Discord

Бот ZLDiscord добавляет слеш-команды и текстовые команды прямо в ваше Discord-сообщество:

• /zevent — создание опроса (требуются роли администратора).
• /zcc <имя> — запуск кастомной команды из Discord.
• !embed — создание Embed-сообщения (требуются роли администратора).
• /link <код> — привязка аккаунта через личные сообщения бота.
• /unlink — отвязка аккаунта.

Плейсхолдеры для PlaceholderAPI

ZLDiscord тесно интегрируется с PlaceholderAPI, позволяя отображать статус голосового чата и данные из DataStore в любых плагинах, поддерживающих плейсхолдеры. Убедитесь, что PlaceholderAPI установлен на сервере. Доступные плейсхолдеры:

• %zoliryzik_in_vc% — возвращает «В голосовом чате», «Не в голосовом чате» или «Не привязан» в зависимости от статуса участника Discord.
• %zoliryzik_attr_member_<ключ>% — атрибут привязанного участника Discord.
• %zoliryzik_attr_player_<ключ>% — атрибут игрока.
• %zoliryzik_attr_bot_<ключ>% — атрибут бота.

Практические примеры использования

Создание голосования для события

Представьте, что вы хотите организовать осаду корабля и дать игрокам возможность проголосовать за участие прямо в Discord. Всё, что нужно, — ввести в чат Minecraft команду:

/zevent "Осада корабля" "boat run" "20m" "0000000000000000000"

После этого в указанном Discord-канале появится опрос, и по истечении 20 минут автоматически выполнится команда boat run. Игроки видят результаты голосования в реальном времени, а администратору не нужно вручную отслеживать каждый шаг.

Отправка Embed-сообщения в Discord

Хотите красиво анонсировать событие с координатами и описанием? Используйте /zembed:

/zembed "Осада корабля" "Осада корабля" "Событие начинается! Координаты X: 0 Y: 0" "0000000000000000000"

В результате в Discord-канал упадёт стильное Embed-сообщение с заголовком, текстом и, при желании, картинкой. Это отличный способ держать сообщество в курсе событий сервера.

Работа с атрибутами и кастомные команды

Плагин позволяет хранить любые данные прямо в атрибутах. Например, чтобы выдать игроку 100 монет:

/zattr set player balance 100

А затем проверить баланс:

/zattr get player balance

Кастомные команды открывают безграничные возможности. Создадим команду heal, которая лечит игрока и оповещает весь сервер:

/zcc create heal "<do mc.command('effect give ' + _player_name + ' regeneration 10 5')><do mc.broadcast('&a' + _player_name + ' был исцелён!')>"

Теперь любой игрок с правами может использовать /zcc heal для мгновенного восстановления здоровья с публичным уведомлением.

Права и безопасность

Все функции плагина защищены системой разрешений. Основные пермишены:

• zoliryzik.use — базовое право использования.
• zoliryzik.zlink и zoliryzik.zunlink — привязка аккаунтов.
• zoliryzik.zembed и zoliryzik.zembed_manage — создание Embed-сообщений.
• zoliryzik.zcc — запуск кастомных команд.
• zoliryzik.zattr — работа с атрибутами.
• zoliryzik.zlongpoll — управление LongPoll.
• zoliryzik.zevent — создание голосований.

Гибкая настройка прав позволяет точно разграничить возможности модераторов, администраторов и обычных игроков.

Установка и совместимость

ZLDiscord работает на ядре сервера с версиями Minecraft от 1.16.5 до 1.20.x. Минимальная версия Java — 17. Обязательно установите PlaceholderAPI, иначе плейсхолдеры не будут работать. Сам плагин можно загрузить с официального сайта разработчика. Если вы предпочитаете удобство, лаунчер foxygame.net предлагает встроенный каталог модов и плагинов — достаточно выбрать ZLDiscord в списке и нажать установить. Это экономит время и исключает ошибки ручного копирования файлов.

Итоги

ZLDiscord — это универсальный инструмент для администраторов, которые хотят превратить сервер Minecraft в полноценную кросс-платформенную среду. Голосования, Embed-сообщения, кастомные команды с шаблонами, атрибуты и интеграция с PlaceholderAPI делают управление сервером простым и эффектным. Плагин активно развивается, а подробная документация и примеры позволяют быстро освоить все возможности. Если вы стремитесь к максимальной связке игры и Discord, ZLDiscord станет надёжным фундаментом для вашего проекта.