️ HyVote

Мощный плагин Hytale, который вознаграждает игроков за голосование по спискам серверов, используя протоколы Votifier V1 и V2.

Если вам нужна помощь, присоединяйтесь к нашим разногласиям! https://discord.gg/fWgDuCThj2

Особенности

• Обсуждение Reward Commands Выполнять команды сервера, когда игроки голосуют
• Трансляция сообщений Объявить голоса всем онлайн-игрокам с несколькими сообщениями
• Цветовая поддержка - Полное форматирование цветов с помощью тегов TaleMessage (<green>, <золото>, <aqua>и т.д.
• Уведомления о голосовании Отправка внутриигровых уведомлений UI избирателям
• Пользовательские звуки Играйте звуки, когда игроки получают вознаграждение за голосование
• Меню голосования - /голосовать Команда открывает GUI с кликабельными ссылками на сайт голосования и лучшими избирателями
• Голосование лидеров - /votetop Ежемесячные и все время лучшие избиратели
• Напоминания о голосовании Напомните игрокам, которые не голосовали в течение долгого времени.
• База данных голосования База данных JSON отслеживает голоса, ежемесячную статистику и ожидаемые вознаграждения.
• Двойной протокол Поддержка Votifier V1 (RSA) и V2 (HMAC-SHA256) на одном и том же порту
• Голосуйте за продвижение Голосование за другие серверы в вашей сети
• Система событий - Голосование получено Событие Для других плагинов для интеграции
• Полностью переводимый - Все сообщения, настраиваемые через JSON-конфигурации
• Режим Debug - Детальная регистрация для устранения неполадок

Команды

• /голосовать Открывает меню голосования с сайтами голосования и топ-избирателей
• /votetop В этом месяце лучшие избиратели с вашим рангом
• /votetop all Показывает лучших избирателей всех времен с вашим рангом
• Предыдущий /votetop Показаны лучшие избиратели предыдущего месяца
• /Гиво - Показывает команды администратора HyVote
• /hyvote test <player> Отправить тестовое голосование за игрока (разрешение): hytalist.hyvote.admin)
• /hyvote скачать - Перезагрузка всех конфигурационных файлов (разрешение): hytalist.hyvote.admin)
• /testvote <player> - Alias для тестирования, если он не взят другим плагином (разрешение: hytalist.hyvote.admin)

Цветовое форматирование

Все сообщения поддерживают цветные теги: <green>, <золото>, <aqua>, <red>, <желтый>, <серый>, <White>и т.д.

Пример: <green>%player%</green> <gray>voted on</gray> <gold>%service%</gold>

Смотреть все варианты в Обсуждение TaleMessage CurseForge

Config.json

Основная конфигурация для сервера Votifier и глобальной трансляции голосования.

{
"Порт": 8192,
"Хозяин": "0.0.0.0",
«Token»: «auto-generated-secure-token»
"DisableV1Protocol": ложный,
"BroadcastMessage": правда,
"BroadcastWhenOffline": правда,
"BroadcastMessages":
«<green>%player%</green> <gray> проголосовал за </gray> <aqua>%service%</aqua><gray>!</gray>».
"<gold>Vote with <aqua>/vote</aqua> and check your stats with <aqua>/votetop</aqua></gold>"
]
"DebugMode": ложный,
"CheckForUpdates": правда
?

• Порт - порт сервера Votifier (по умолчанию: 8192)
• ведущий - Связанный адрес (по умолчанию: "0.0.0.0")
• токен - Автоматический токен аутентификации V2
• Инвалидный протокол V1 - Протокол V1 (RSA) с отключением (по умолчанию: ложный)
• Трансляция Включить трансляцию глобального голосования для всех игроков (по умолчанию: правда)
• Трансляция Когда Оффлайн - Трансляция голосов, даже если избиратель находится в автономном режиме (по умолчанию: правда)
• Сообщения Сообщения, транслируемые всем игрокам на каждом голосовании
• DebugMode - Заготовка вербозы (по умолчанию: ложная)
• CheckForUpdates Проверка обновлений для стартапа (по умолчанию: правда)

Примечание: RSA-ключи для протокола V1 генерируются автоматически. rsa/publickey и rsa/private.key.

Вознаграждение. Джонсон

Конфигурация вознаграждения с двумя системами: Вознаграждение (независимые рулоны) и Случайная награда (взвешенный выбор, один результат). Настройка "Включено": ложное Отключить все вознаграждения (полезно для серверов хабов, которые транслируют только голоса).

{
"Включено": правда,
"Награды":
{
"WaitForPlayer": правда,
"Команда":
"Дайте % игрока % Rock_Gem_Diamond - количество 1",
"дай % игроку % Rock_Gem_Emerald --количество 5.
]
?
{
"Шанс": 50.0,
"WaitForPlayer": правда,
"Команда":
"дай % игроку % Ингредиент_Бар_Серебряный - количество 5
]
?
{
"Разрешение": "vip.example",
"Команда":
«Деньги дают % игрокам % 5000»
]
?
]
"RandomReward": {
"Включено": ложное,
"Уровни": []
?
?

Вознаграждение

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

• Шанс - Возможность запуска этой группы, 0-100 (по умолчанию: 100)
• Исполнитель: WaitForPlayer Очередь команд и сообщений игрока до тех пор, пока игрок не выйдет в Интернет (по умолчанию: ложные). Рекомендуется для давать команды. Ожидание вознаграждения истекает через 3 дня.
• Разрешение Требуемое разрешение; группа пропускается, если игрок находится в автономном режиме или не имеет разрешения (факультативно)
• командование Список команд для выполнения (массив строк)
• Сообщения Сообщения транслируются всем онлайн-игрокам, когда эта группа запускает (необязательно). Отправляется немедленно, даже если избиратель находится в автономном режиме.
• Игровые сообщения - Сообщения, направленные непосредственно избирателю при запуске этой группы (факультативно). Если избиратель офлайн и Исполнитель: WaitForPlayer Это правда, сообщения стоят в очереди и доставляются, когда игрок присоединяется.

Случайная награда

Взвешенная система, в которой один Выбирается на голосование (или ничего). Полезно для наград в стиле ящика / лута. Все шансы на уровне суммируются — если сумма меньше 100, остальная часть — это шанс ничего не получить.

Пример с уровнями, суммирующими до 30 (70% шансов получить ничего):

"RandomReward": {
"Включено": правда,
"Уровни":
{
"Шанс": 20.0,
"WaitForPlayer": правда,
"Команда": ["дайте %-плеер% Rare_Crate - количество 1"],
"PlayerMessages": [<aqua> Вы получили <white>Rare</white> crate!</aqua>
?
{
"Шанс": 10.0,
"WaitForPlayer": правда,
«Commands»: [»give %player% Legendary_Crate — количество] 1"]
"PlayerMessages": [<gold> Вы получили <white>Legendary</white> crate!</gold>
«BroadcastMessages»: [<gold>%player%</gold> <gray>found a</gray> <gold>Legendary</gold> <gray>crate!</gray>
?
]
?

Каждый уровень поддерживает те же варианты, что и группы вознаграждения: Шанс (вес), Исполнитель: WaitForPlayer, Разрешение, командование, Сообщения, Игровые сообщения.

Уровни с a Разрешение Требование исключено из списка для игроков, у которых нет разрешения - остальные уровни сворачиваются, как будто ограниченного уровня не существует.

️ Помещики

Используйте их в командах и сообщениях. %placeholder % и [заместитель] Поддерживаемые форматы:

• % игроков % Имя пользователя игрока, проголосовавшего
• % сервисное обслуживание % - Наименование службы голосования
• %адрес % - IP-адрес избирателя
• %timesamp % - Unix временная метка голосования

. уведомление. Джонсон

Настройка уведомлений, отправляемых игрокам при голосовании. Поддерживает несколько типов уведомлений.

{
Название: {
"Включено": ложное,
«Название»: «<green>Reward Received!</green>»
«Подзаголовок»: «<gray>Спасибо за голосование по </gray> <aqua>%service%</aqua><gray>!»
"Второй период": 3,
"FadeInSeconds": 0,5,
"FadeOutSeconds": 0,5
?
"Уведомление": {
"Включено": правда,
«Название»: «<green>Reward Received!</green>»
"Описание": "<gray>Спасибо за ваш голос по </gray> <aqua>%service%</aqua><gray>!"
«Икона»: «Rock_Gem_Diamond»
?
"Чат": {
"Включено": ложное,
"Сообщения":
"<green>Reward Received!</green>"
"<gray>Спасибо за ваш голос по </gray> <aqua>%service%</aqua><gray>!</gray>"
]
?
"Звук": {
"Включено": правда,
"Имя": "SFX_Player_Pickup_Item"
?
?

Название Варианты (Большой текст на экране)

• включенный Название шоу на экране (истинное/ложное, по умолчанию: ложное)
• Название - Основной текст заголовка, поддерживает цвета и заполнители (струна)
• Подзаголовок - Текст подзаголовка (струна)
• Продолжительность второй Как долго название остается на экране (целое число)
• FadeInSeconds - Fade in duration (плавание)
• FadeOutSecond - Fade out duration (плыть)

Варианты уведомлений (небольшие всплывающие окна)

• включенный - Показать всплывающее окно уведомления (правда / ложь, по умолчанию: правда)
• Название - Название уведомления, поддерживает цвета и заполнители (струна)
• Описание - Описание уведомлений, поддерживает цвета и заполнители (струны)
• икона - Иконка элемента для отображения (струна)

Чат опционы

• включенный Отправляйте сообщения в чат избирателя (правда / ложь, по умолчанию: ложные)
• Сообщения - Массив сообщений для отправки, поддерживает цвета и заполнители (массив строк)

Звуковые опции

• включенный - воспроизведение звука при голосовании (правда/ложь, по умолчанию: правда)
• Имя - Звуковое название мероприятия, например. SFX_Player_Pickup_Item (струна)

voteCommand.json

Конфигурировать /голосовать командовать и голосовать по ссылкам сайта. Вы можете переключать UI, Chat или оба.

{
"Включено": правда,
"VoteLinks": {
"Hytalist.com":https://hytalist.com/test-server?nick=%player%"
"AnotherServerList":https://exmple.com"
?
"UI": {
"Включено": правда,
"Название": "Голосуйте за сервер",
«VoteLinkTitle»: «Vote Link (Copy and open in Browser)»
«VoteLinkDescription»: «Нажмите на сайт выше, чтобы увидеть ссылку для голосования»
?
"Чат": {
"Включено": правда,
«Глава»: «<gray>=========== <green>Голосуйте за ссылки</green> ========</серый>
"Формат": "<yellow>#[</yellow><aqua>%%iterator%</aqua><yellow>]</yellow><white><click:%siteUrl%>%siteUrl%</click></white>"
«Footer»: «<gray>==========================================================================================
?
?

Варианты

• включенный - Включить/отключить команду /vote полностью (правда/ложь)
• Голосуйте Линкс Карта имен сайтов для голосования URL (объект)

Варианты UI

• включенный - Показать результаты голосования (правда/ложь)
• Название - Заголовок отображается в верхней части GUI (струна)
• VoteLinkTitle - Ярлык над текстовым полем URL (струна)
• VoteLinkОписание - Текст в поле URL перед выбором (струна)

Чат опционы

• включенный Отправьте ссылки для голосования в чат (правда / ложь)
• Заголовок Сообщение, отображаемое перед ссылками, поддерживает цвета (струна)
• Формат Формат для каждой ссылки с заполнителями: %iterator % (число, начинающееся с 1), %site url%, %site Имя % (струна)
• флюгер Сообщение, отображаемое после ссылок, поддерживает цвета (струна)

The % игроков % Заполнитель в URL-адресах будет заменен именем пользователя игрока (оба % игроков % и {игрок} форматы работы.

voteTopCommand.json

Конфигурировать /votetop командные доски. Вы можете переключать UI, Chat или оба (UI включен по умолчанию).

{
"Включено": правда,
"UI": {
"Включено": правда,
"Ограничение": 25,
"Титул": "Высшие избиратели",
«MonthlyTitle»: «Этот месяц»
«Предыдущий месяц»: «Предыдущий месяц»
«AllTimeTitle» — «Все время»
«YourRankLabel» — «Ваш ранг»
"Новости": "Никаких голосов пока не зафиксировано",
«NoRankYet»: «Голосуй, чтобы тебя оценили!»
«PlayerDescription»: «%votesThisMonth% в этом месяце / %votes% всего»
?
"Чат": {
"Включено": ложное,
"Ограничение": 10,
«Глава»: «<gray>==========</gray> <green>Лучшие избиратели</green> <gray>(%period%)</gray> <gray>=======</gray>,
«Формат»: «<yellow>#%rank%</yellow> <aqua>%player%</aqua> <gray> (голоса: %votes%)</gray>»,
"Footer": "<серый>------------------------------------------------------------------------------------------------------------------------------------------------"----------------------------------------------------------------------------------------------------
«YourRankFormat»: «<gray>Ваш ранг:</gray> <aqua>#%rank%</aqua> <gray>(голоса: %votes%)</gray>»,
"NoVotesYet": "<gray>No votes recorded yet.</gray>"
«NoRankYet»: «<gray>Ваш ранг:</gray> <dark_gray>» Пока нет голосов </dark_gray>
?
?

Варианты

• включенный Включить / отключить команду /votetop полностью (правда / ложь)

Варианты UI

• включенный - Показать лучший GUI с 3 вкладками: Этот месяц, предыдущий месяц, все время (правда / ложь, по умолчанию: правда)
• предел - Максимальное количество лучших избирателей (целое число, по умолчанию: 25)
• Название - Заголовок отображается в верхней части GUI (струна)
• Ежемесячный титул - Метка для вкладки текущего месяца (струна)
• Предыдущий MonthTitle - Метка для вкладки предыдущего месяца (струна)
• Название AllTime - Label for the all-time tab (строка)
• YourRankLabel - Метка выше ранга игрока (струна)
• NoVotesYet - Сообщение, когда голоса не записаны (строка)
• NoRankYet Сообщение, когда игрок не имеет ранга (струн)
• Игровое описание Описание, приведенное ниже каждого имени игрока с заполнителями: %votesThisMonth%, % голос % (струна)

Чат опционы

• включенный Отправьте таблицу лидеров в чат (истинно/ложно, по умолчанию: ложно)
• предел - Максимальное количество лучших избирателей (целое число, по умолчанию: 10)
• Заголовок - Заголовок сообщения % период % «Январь 2025» или «Все время» (струна)
• Формат Формат для каждого входа избирателя с держателями мест: % ранг %, % игроков %, % голос % (струна)
• флюгер - Фотер-сообщение (струна)
• Ваш RankFormat Формат для показа собственного ранга игрока (струна)
• NoVotesYet - Сообщение, когда голоса не записаны (строка)
• NoRankYet Сообщение, когда игрок не имеет ранга (струн)

Напоминание.json

Настройка напоминаний для игроков, которые не голосовали в последнее время.

{
"Включено": правда,
"Послезавтра": 24,
"Вторая задержка": 60,
"CheckIntervalSeconds": 60,
Название: {
"Включено": правда,
"Название": "Напоминание голоса",
«Подзаголовок»: «Использовать /голосовать за поддержку сервера!»,
"Второй период": 3,
"FadeInSeconds": 0,5,
"FadeOutSeconds": 0,5
?
"Уведомление": {
"Включено": ложное,
"Название": "<gold>Vote Reminder</gold>",
«Описание»: «<серый> Вы не голосовали какое-то время!</серый> <aqua>Использовать/голосовать</aqua>»,
«Икона»: «Rock_Gem_Diamond»
?
"Чат": {
"Включено": ложное,
"Сообщения":
«Вы не голосовали какое-то время!»
<gray>Поддержать сервер путем голосования: </gray> <aqua>/vote</aqua>
]
?
"Звук": {
"Включено": правда,
"Имя": "SFX_UI_Quest_Objective_Complete"
?
?

Варианты

• включенный - Включить/отключить напоминания о голосовании (истинно/ложно)
• Через несколько часов Напомните игрокам, которые не голосовали в X-часах (целое число, по умолчанию: 24)
• Задержка во втором Подождите X секунд после того, как игрок присоединится, прежде чем проверить (целое число, по умолчанию: 60)
• Проверьте IntervalSeconds Как часто проверять напоминания (целое число, по умолчанию: 60)

Название Варианты (Большой текст на экране)

• включенный Название шоу на экране (истинное/ложное, по умолчанию: истинное)
• Название - Основной заголовок текста (струна)
• Подзаголовок - Текст подзаголовка (струна)
• Продолжительность второй Как долго название остается на экране (целое число)
• FadeInSeconds - Fade in duration (плавание)
• FadeOutSecond - Fade out duration (плыть)

Варианты уведомлений (небольшие всплывающие окна)

• включенный Показать всплывающее окно уведомления (истинное/ложное, по умолчанию: ложное)
• Название - Заголовок уведомления, поддерживает цвета (струна)
• Описание - Описание уведомлений, поддерживает цвета (струна)
• икона - Иконка элемента для отображения (струна)

Чат опционы

• включенный Отправляйте напоминания в чат (правда / ложь, по умолчанию: ложные)
• Сообщения - массив сообщений для отправки (массив строк)

Звуковые опции

• включенный - воспроизведение звука с напоминанием (правда/ложь, по умолчанию: правда)
• Имя - Звуковое название мероприятия (струна)

Пересылка. Джонсон

Голосуйте за другие серверы в вашей сети. Полезно для настроек в стиле BungeeCord / Velocity, где вы хотите, чтобы голоса, полученные на прокси-сервере, передавались на серверы бэкэнда или наоборот.

{
"Включено": ложное,
"Цели":
{
"Хозяин": "127.0.0.1",
"Порт": 8192,
«Token»: «target-server-token»
?
{
"Хозяин": "192.168.1.100",
"Порт": 8192,
«Токен»: «другой сервер-токен»
?
]
?

Варианты

• включенный - Включить/отключить переадресацию голосов (истинно/ложно, по умолчанию: ложно)
• Цели - массив целевых серверов для переадресации голосов

Целевые варианты

• ведущий IP-адрес или имя хоста целевого сервера (струна)
• Порт - порт Votifier целевого сервера (целое число, по умолчанию: 8192)
• токен - Токен Votifier V2 целевого сервера (струна)

Как это работает

1. Когда HyVote получает голос, он обрабатывает его локально (награды, трансляции и т. д.).
2. Если переадресация включена, она отправляет голосование на все настроенные цели.
3. Форвардинг использует протокол Votifier V2 с аутентификацией HMAC-SHA256
4. Каждый целевой сервер получает голос, как если бы он пришел непосредственно с сайта голосования.
5. Продвижение вперед происходит асинхронно и не замедляет обработку местных голосов.

Пример использования Cases

• Прокси-сервер BackendПолучите голоса на вашем прокси-сервере и перейдите на игровые серверы
• Hub — игровые серверыГолоса вперед от сервера хаба до нескольких серверов игрового режима
• избыточность: Передние голоса на резервный сервер для регистрации / статистики

Примечание: На целевом сервере должен работать HyVote (или другой плагин Votifier V2). Убедитесь, что токен соответствует конфигурации целевого сервера.

Статистика голосования

HyVote автоматически отслеживает статистику голосования база данных папка:

• Голосование.json - Магазины общего количества голосов на одного игрока (все время)
• Источник: YYYY-MM.json - Ежемесячные файлы голосования (например, Голосование-2025-01.json)
• _rewards.json - Очередь вознаграждений для офлайн-игроков (авто-очистка через 3 дня)

Эти данные полномочия:

• /votetop Команда, показывающая ежемесячные таблицы лидеров
• /votetop all Команда, показывающая все время таблицы лидеров
• Топ-3 избирателей, представленных в /голосовать Меню UI
• ранг игрока, показанный в нижней части таблицы лидеров

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

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

Для Votifier V2 (рекомендуется)

1. Получи свой токен из config.json (автогенерируется при первом запуске)
2. Настройка списка серверов с:
   • IP/Host: Ваш сервер IP
   • Порт: 8192 (или конфигурированный порт)
   • Токен: Копия с конфигураций. Джонсон
   • Протокол: Водитель V2

Votifier V1 (Наследие)

1. Получите публичный ключ из rsa/publickey (автогенерируется при первом запуске)

2. Настройка списка серверов с:

   • IP/Host: Ваш сервер IP
   • Порт: 8192 (тот же порт, что и V2)
   • Публичный ключ: Копирование контента от общественности. ключ
   • Протокол: Водитель V1

3. Испытание установки позволяя DebugMode и голосование

Устранение неполадок

Голоса не принимаются

1. ► Включить DebugMode вfig.json
2. ✅ Проверьте брандмауэр - убедитесь, что порт Votifier открыт
3. Проверьте совпадения токенов между конфигурацией и сайтом голосования
4. ✅ Проверьте журналы сервера для Гипотеза сообщения

Общие вопросы

• "Недействительная подпись" (V2) - Несоответствие токенов, проверьте токен на сайте голосования
• «Не удалось расшифровать» (V1) - Несоответствие открытого ключа, копирование полного контента из rsa/public. ключ
• "Нет ответа" - Проверьте конфигурацию брандмауэра/порта

для разработчиков

Полная документация API доступна по адресу github.com/hytalist/hyvote-api. API позволяет получать голоса игроков, ежемесячную статистику, рейтинги и многое другое.

установка

Добавьте API HyVote в свой проект:

Котлин ДСЛ (Kotlin DSL)

репозитории {
maven { url = uri()https://jitpack.io") }
?

зависимости {
compileOnly («com.github.hytalist:hyvote-api:1.6.0»)
?

Грейдл (Groovy)

репозитории {
{url }https://jitpack.io " ?
?

зависимости {
составлять Только 'com.github.hytalist:hyvote-api:1.6.0 "
?

Мэйвен

<репозитории>
<репозиторий>
<id>jitpack.io</id>
<url>https://jitpack.io&lt;/url&gt;     </Repository>
</repositories>

<зависимости>
<зависимость>
<groupId>com.github.hytalist</groupId>
<artifactId>hyvote-api</artifactId>
<version>1.6.0</version>
<scope>предоставлено </scope>
</зависимость>
</зависимость>

Голосование получено Событие

Слушайте события голосования из других плагинов:

Java

Импорт com.hytalist.hyvote.event.Vote событие;
Импорт com.hytalist.hyvote.model. Голосовать;

@Override
Публичная установка void() {
eventRegistry.registerGlobal (VoteReceivedEvent.class, event -> {)
Голосование = event.getVote();
Струнный игрок = vote.getUsername();
струнный сервис = vote.getServiceName();

// Отменить вознаграждение по умолчанию
event.setCancelled (правда)

// Работа с пользовательской логикой
}
?

Котлин

Импорт com.hytalist.hyvote.event.Vote Событие

Override Fun Setup (альбом) {
eventRegistry.registerGlobal (VoteReceivedEvent::class.java)
val vote = event.vote
val player = vote.username
val service = vote.service

// Отменить вознаграждение по умолчанию
event.setCancelled (правда)

// Работа с пользовательской логикой
?
?

Кредиты

• Протокол на основе спецификации NuVotifier
• Цветовое оформление powered by TaleMessage

Сделано для сообщества Hytale