Руководство по настройке плагина One Query
Узнайте, как настроить плагин One Query для отображения количества игроков в реальном времени, онлайн-игроков и информации о сервере в вашем листинге Hylist.
Supported Plugins
Hylist supports two query plugins. Install one of them (not both - they are mutually exclusive):
One Query
The recommended plugin with full feature support including plugin version and status info.
Hyvote
Alternative plugin with configurable exports. Lets you toggle exactly what data to expose.
Important: These plugins are mutually exclusive. Only install one of them - do not install both on the same server.
Что такое One Query?
These plugins enable server status queries using UDP. They share your game server port, so no additional ports or firewall configuration is needed. This allows Hylist to fetch real-time data about your server, including:
- Текущее количество игроков и максимум игроков
- Список онлайн-игроков с их именами и UUID
- Версия сервера и MOTD
- Список установленных плагинов
Шаг 1: Установка плагина
Download and install either One Query or Hyvote on your Hytale server:
- Скачайте последний JAR с страницы релизов GitHub
- Поместите JAR-файл в директорию plugins вашего сервера
- Перезапустите сервер
Дополнительная настройка не требуется! Плагин работает сразу после установки, используя порт вашего игрового сервера (5520).
Шаг 2: Добавление порта запроса в Hylist
Настройте порт запроса в панели управления Hylist:
- Перейдите на страницу редактирования сервера в панели Hylist
- Прокрутите до раздела «Порты запросов»
- Нажмите «Добавить порт запроса»
- Введите порт 5520 (или порт вашего игрового сервера, если он другой)
- При желании выберите тег для связи этого порта с игровым режимом
- Сохраните изменения
Несколько игровых режимов (прокси-сети)
Если вы запускаете несколько бэкенд-серверов, вы можете добавить несколько портов запросов — по одному для каждого игрового режима:
Port 5520 -> No tag (Lobby) Port 5521 -> PvP Port 5522 -> Survival Каждому бэкенд-серверу нужен свой экземпляр плагина One Query. Тег помогает посетителям понять, к какому игровому режиму относится каждый список игроков.
Проверка настройки
После настройки проверьте установку:
- Убедитесь, что ваш сервер онлайн и плагин One Query запущен
- Подождите несколько минут, пока Hylist опросит ваш сервер
- Посетите страницу вашего сервера на Hylist
- Вы должны увидеть количество игроков, онлайн-игроков, версию и информацию о плагинах
Если всё работает, вы увидите зелёный значок «Онлайн» и информацию об игроках в реальном времени на странице вашего сервера!
Устранение неполадок
Нет данных на Hylist?
- Убедитесь, что JAR плагина One Query находится в папке plugins
- Проверьте логи сервера на наличие ошибок плагина
- Убедитесь, что номер порта в Hylist совпадает с портом вашего сервера (по умолчанию: 5520)
- Подождите 5-10 минут, пока Hylist обновит данные сервера
Неправильное количество игроков или информация?
- Убедитесь, что порт запроса указывает на правильный сервер
- При использовании нескольких серверов убедитесь, что у каждого настроен свой порт
Why Server Query Matters for Your Listing
Adding server query to your Hytale server listing significantly improves your visibility and credibility on Hylist. Here's how real-time server data impacts your server's performance on the platform.
Higher Search Ranking
Servers with active query data appear higher in filtered searches. When players filter by "online only" or sort by player count, your server will only appear if query data is available. Without it, you're invisible to a significant portion of potential players.
Player Trust
Displaying real-time player counts and server status builds trust with potential players. A server showing "42 players online" is far more compelling than one with no data. Players are more likely to join and vote for servers they can verify are active.
Analytics Insights
Query data feeds into your server's analytics dashboard, showing player count trends over time. You can identify peak hours, track growth, and measure the impact of promotional campaigns or content updates.
Discord Integration
The Hylist Discord bot uses query data to display live player counts and server status in your Discord server. Without query configured, these stat channels will show limited information.