Официальный плагин HyServers

Плагин HyServers

Официальный серверный плагин Hytale для HyServers.gg. Автоматическая отправка статуса, награды за голосование, таблицы лидеров и многое другое - без лишних настроек.

Всё, что тебе нужно

Один плагин заменяет несколько инструментов и упрощает размещение сервера.

Автоматические пинги статуса

Статус вашего сервера отправляется на HyServers каждые 5 минут по HTTP. Встроенный HyQuery-ответчик полностью заменяет отдельные плагины запросов.

  • Заменяет плагины HyQuery и OneQuery
  • HTTP пинги + HyQuery UDP ответчик
  • Аутентификация HMAC-SHA256

Награды за голоса и отзывы

Игроки голосуют на HyServers.gg, а ваш сервер мгновенно получает уведомление через защищённый TCP. Команды наград выполняются автоматически.

  • Мгновенные TCP уведомления
  • Очередь наград офлайн (7 дней)
  • Объявления о голосах на весь сервер
  • Команда /vote с кликабельной ссылкой

Выбор наград

Позвольте игрокам выбирать награду при голосовании. Настраивайте варианты наград на сайте или в config плагина.

  • Предметные награды с количеством
  • Кастомные команды (ранги, наборы, валюта)
  • Красочные карточки наград на странице голосования
  • Два режима config: на сайте или в плагине

Мультисерверные сети

Работает с Numdrassl, Lineage и другими прокси-решениями Hytale. Установите на хаб-сервер, и голоса будут пересылаться на все бэкенды.

  • Автоматическая пересылка голосов
  • Выполнение наград на каждом бэкенде
  • Аутентификация общим секретом

Таблицы лидеров голосования

Отслеживайте лучших голосующих за месяц и за всё время. Владельцы серверов могут видеть топ голосующих в своей панели управления.

  • Отслеживание за месяц и за всё время
  • Карточка в боковой панели
  • В будущем: команда /vote top в игре

Безопасность по умолчанию

Вся связь аутентифицирована с помощью HMAC-SHA256 и общего секрета. Никаких API-токенов для управления или ротации.

  • Подписи HMAC-SHA256
  • Защита от повторного воспроизведения по метке времени
  • Без открытых учётных данных

Смотри в действии

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

Настройка наград за голосование на странице редактирования сервера

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

Страница голосования с карточками выбора наград

Игроки выбирают награду при голосовании

Быстрый старт

Запустись менее чем за 5 минут.

Шаг 1

Скачай плагин

Скачай HyServersPlugin.jar и помести его в папку mods/ твоего сервера.

Шаг 2

Перезапусти сервер

Файл config будет создан по пути mods/HyServers/HyServersPlugin.json.

Шаг 3

Настрой на HyServers.gg

Перейди на страницу редактирования сервера, открой раздел «Голосование» и включи HyServers Plugin. Скопируй фрагмент config.

Шаг 4

Перезапусти и запускайся

Вставь config, установи тип запроса «HyServers Plugin» и перезапусти. Готово!

Конфигурация

Полный пример config со всеми доступными параметрами.

mods/HyServers/HyServersPlugin.json
{
  "ServerId": "your-server-uuid-from-hyservers-gg",
  "ApiBaseUrl": "https://hyservers.gg",
  "StatusPingEnabled": true,
  "HyQueryEnabled": true,
  "HyQueryPort": 5520,
  "ServerName": "My Server",
  "ServerPort": 5520,
  "MaxPlayers": 100,
  "ServerMotd": "A Hytale Server",
  "ServerVersion": "1.0",
  "ListenPort": 5520,
  "SharedSecret": "your-shared-secret-from-hyservers-gg",
  "VoteUrl": "https://hyservers.gg/servers/your-server/vote",
  "VoteCommands": [
    "give {player} Rock_Gem_Diamond 5",
    "msg {player} Thanks for voting!"
  ],
  "ReviewCommands": [
    "give {player} Rock_Gem_Emerald 10"
  ],
  "BroadcastVotes": true,
  "BroadcastMessage": "{player} just voted! Use /vote to support the server!"
}

ServerIdUUID вашего сервера с HyServers.gg (находится на странице редактирования).

SharedSecretГенерируется на странице редактирования сервера. Должен совпадать на обеих сторонах.

HyQueryEnabledВключает встроенный HyQuery UDP ответчик (заменяет отдельный плагин HyQuery).

StatusPingEnabledОтправляет статус сервера на HyServers.gg каждые 5 минут по HTTP.

VoteCommandsКоманды, выполняемые при голосовании игрока. {player} заменяется на имя игрока.

VoteBroadcastСообщение, транслируемое всем игрокам при голосовании.

Готов начать?

Скачай плагин, настрой сервер и начни получать голоса и пинги статуса за считанные минуты.