Как показать количество онлайн-игроков в списке серверов Hytale

Когда игрок просматривает список серверов Hytale, одно число решает, нажмет ли он «Присоединиться» или продолжит прокрутку: количество игроков. Сервер, показывающий 47/100 игроков, выглядит живым. Сервер, не показывающий ничего — или просто «Офлайн» — выглядит как город-призрак, даже если работает нормально. HytaleCharts предлагает три способа отображения количества игроков в реальном времени и онлайн-статуса вашего сервера Hytale. Каждый метод имеет различные компромиссы в точности, сложности настройки и функциональности. Это руководство объясняет все три, чтобы вы могли выбрать подходящий для вашей конфигурации. Три метода в одном взгляде МетодКоличество игроковСкорость обновленияСложность настройкиЛучше всего для Плагин HeartbeatТочное количество + список игроковКаждые 60 секундУстановить плагинСамостоятельно размещенные серверы Внешний запросТочное количествоКаждые 5 минутУказать URLNitrado / управляемые хосты UDP пингТолько онлайн/офлайнПериодическиНет (автоматически)Базовый резервный статус Метод 1: Плагин Heartbeat HytaleCharts (Рекомендуется) Плагин heartbeat — это лучший способ показать количество игроков в список серверов Hytale. Он работает на вашем сервере Hytale и отправляет сигнал heartbeat в HytaleCharts каждые 60 секунд, включая точное количество онлайн-игроков и их имена пользователей. Что он сообщает Количество игроков — текущее количество подключенных игроков Максимум игроков — лимит игроков вашего сервера Список игроков — индивидуальные имена пользователей и UUID подключенных игроков Версия плагина — чтобы HytaleCharts мог предупредить вас об обновлениях Как это работает внутри Плагин отправляет POST-запрос на /api/heartbeat каждые 60 секунд Запрос включает секретный ключ вашего сервера (64-символьная шестнадцатеричная строка) HytaleCharts проверяет секрет, обновляет количество игроков и статус вашего сервера Если heartbeat не получен в течение 5 минут, сервер отмечается как офлайн Исторические данные сохраняются для аналитики и графиков количества игроков Шаги настройки Сгенерируйте секрет heartbeat — в HytaleCharts перейдите в «Редактировать сервер» и нажмите «Сгенерировать секрет Heartbeat» в разделе плагина Heartbeat Скопируйте секрет — вы увидите его только один раз (можете сгенерировать заново при потере) Установите плагин HytaleCharts на вашем сервере Hytale, поместив его в каталог mods/ вашего сервера Настройте плагин — создайте или отредактируйте config.json в каталоге данных плагина: { "secret": "YOUR_64_CHARACTER_SECRET_HERE", "debug": false } Перезапустите ваш сервер — плагин немедленно начнет отправлять heartbeat-сигналы Проверьте на HytaleCharts — ваш сервер должен отобразиться онлайн с количеством игроков в течение 60 секунд Поддержка нескольких экземпляров Если вы запускаете несколько экземпляров сервера (например, лобби-сервер и сервер выживания), система heartbeat автоматически агрегирует количество игроков. Все экземпляры с одним секретным ключом будут иметь объединенных уникальных игроков и суммированные итоги. Это означает, что ваша запись в список серверов Hytale показывает правильный итог по всей вашей сети. Система определяет уникальные экземпляры по IP-адресу и имени мира, берет последний heartbeat от каждого источника и объединяет игроков по UUID, чтобы избежать двойного подсчета при подключении к нескольким экземплярам. Обновления плагина HytaleCharts отслеживает версию вашего плагина. Если доступна более новая версия, на странице «Редактировать сервер» отобразится предупреждение «Доступно обновление». Поддержание актуальности плагина обеспечивает совместимость с изменениями API и предоставляет последние исправления ошибок. Метод 2: Внешняя точка запроса (Nitrado и управляемые хосты) Не все операторы серверов Hytale имеют доступ к установке пользовательских плагинов. Если вы используете Nitrado, контейнерный хост или любого провайдера с точкой запроса, система внешнего запроса — ваше решение. Как это работает Вы предоставляете HytaleCharts URL, который возвращает количество игроков вашего сервера в формате JSON HytaleCharts опрашивает этот URL каждые 5 минут Ответ анализируется, и количество игроков обновляется в списке серверов Если точка доступа становится недоступной, статус вашего сервера отражает изменение в течение 10 минут Поддерживаемые форматы ответов HytaleCharts автоматически определяет несколько форматов JSON, поэтому работает с большинством точек запроса без дополнительной настройки: Формат Nitrado { "Universe": { "CurrentPlayers": 15 }, "Server": { "MaxPlayers": 100 } } Стандартный формат { "player_count": 15, "max_players": 100 } Также поддерживает варианты camelCase (playerCount, maxPlayers) и сокращенные (online, max). Шаги настройки Найдите или настройте точку запроса у вашего хостинг-провайдера (Nitrado предоставляет её по умолчанию) В HytaleCharts перейдите в Редактировать сервер → Внешний запрос Введите полный URL вашей точки запроса Нажмите «Тестировать точку» для проверки, что ответ поддается анализу Сохраните — HytaleCharts немедленно начнет опрос Метод внешнего запроса обновляется реже, чем плагин heartbeat (каждые 5 минут против каждых 60 секунд), но не требует модификаций на стороне сервера. Метод 3: UDP пинг (Автоматический резерв) Если вы не настроили ни плагин heartbeat, ни внешнюю точку запроса, HytaleCharts попытается проверить статус вашего сервера через UDP пинг. Это пассивная система, не требующая настройки с вашей стороны. Как это работает HytaleCharts отправляет минимальный зонд протокола QUIC на публичный порт вашего сервера (по умолчанию: 5520) Если получен любой ответ, сервер отмечается как онлайн Если нет ответа после нескольких попыток, сервер отмечается как офлайн Ограничения Нет количества игроков — UDP пинг может определить только онлайн или офлайн, но не количество подключенных игроков Нет списка игроков — данные отдельных игроков недоступны Менее точное время — обновления статуса зависят от расписания опроса, а не от heartbeat-сигналов в реальном времени UDP пинг полезен как базовый уровень, но серверы, стремящиеся подняться в рейтинге список серверов Hytale должны установить плагин heartbeat или настроить внешний запрос для точного подсчета игроков. Как HytaleCharts определяет статус вашего сервера Когда доступны несколько методов, HytaleCharts использует систему приоритетов для определения, какому источнику данных доверять: Внешний запрос (наивысший приоритет, если включен) — онлайн, если последний успешный опрос был в пределах 10 минут Плагин Heartbeat (если настроен) — онлайн, если последний heartbeat был в пределах 5 минут UDP пинг (резерв) — использует сохраненный результат онлайн/офлайн последней проверки Это означает, что если у вас настроены и плагин heartbeat, и внешний запрос, внешний запрос имеет приоритет. Большинство операторов будут использовать одно или другое, но не оба. Что видят игроки В список серверов Hytale статус вашего сервера отображается в виде цветного значка: Зеленый значок с количеством игроков (например, «Онлайн — 47 игроков») — когда онлайн и обнаружены игроки Зеленый значок («Онлайн») — когда онлайн, но без игроков или количество недоступно Красный значок («Офлайн») — когда нет недавнего heartbeat, запроса или ответа на пинг Серверы с видимым количеством игроков стабильно привлекают больше кликов. Сервер, показывающий «Онлайн — 23 игрока», гораздо привлекательнее того, который просто говорит «Онлайн» без подсчета. Вот почему плагин heartbeat или внешний запрос важен для лучших серверов Hytale. Устранение неполадок ПроблемаВероятная причинаРешение Сервер показывает «Офлайн», хотя работаетФайрвол блокирует heartbeat или пингУбедитесь, что ваш сервер может выполнять исходящие HTTPS-запросы к hytalecharts.com Количество игроков застряло на 0Плагин не отслеживает события игроковПроверьте, что плагин загружен (проверьте логи сервера) и перезапустите Heartbeat прекращается через некоторое времяПлагин упал или был выгруженПроверьте логи сервера на ошибки, переустановите плагин при необходимости Внешний запрос показывает неправильное количествоТочка возвращает устаревшие данныеПроверьте JSON-ответ непосредственно в браузере Количество мульти-экземпляров слишком низкоеЭкземпляры используют разные секретыВсе экземпляры должны использовать один и тот же секрет heartbeat Предупреждение «Доступно обновление»Плагин устарелСкачайте последнюю версию плагина с HytaleCharts Лучшие практики Операторы лучших серверов Hytale следуют этим практикам: Используйте плагин heartbeat всегда, когда возможно — это самый точный и отзывчивый вариант Установите реалистичный максимум игроков — завышенные лимиты (например, 999) выглядят нечестно и снижают доверие Следите за статусом heartbeat — периодически проверяйте страницу «Редактировать сервер» на наличие ошибок Обновляйте плагин — устаревшие плагины могут перестать работать после изменений API Используйте внешний запрос как резерв — если плагин выйдет из строя, работающая внешняя точка поддержит точность статуса Убедитесь, что ваш домен указан правильно — резервный UDP пинг использует ваш настроенный домен, поэтому поддерживайте его точность, даже если в основном используете heartbeat Начало работы Отображение количества игроков занимает менее пяти минут с плагином heartbeat. Сгенерируйте секрет, установите плагин, добавьте секрет в конфигурацию и перезапустите. Ваш сервер Hytale появится в список серверов Hytale с живым количеством игроков в течение минуты. Для управляемых хостинг-провайдеров, таких как Nitrado, внешний запрос ещё проще — просто вставьте URL, и HytaleCharts позаботится об остальном. В любом случае, отображение реального количества игроков — одна из самых простых вещей для увеличения видимости сервера и привлечения новых игроков. Серверы, показывающие активное количество игроков в список серверов Hytale стабильно превосходят тех, кто этого не делает.