Посібник з налаштування плагіна 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.