Hytale 서버 목록에서 온라인 플레이어 수를 표시하는 방법

플레이어가 Hytale 서버 목록을 탐색할 때, 하나의 숫자가 "참가"를 클릭할지 스크롤을 계속할지 결정합니다: 플레이어 수. 47/100 플레이어를 보여주는 서버는 활기차 보입니다. 아무것도 표시하지 않거나 "오프라인"만 표시하는 서버는 정상적으로 작동하더라도 유령 도시처럼 느껴집니다. HytaleCharts 는 Hytale 서버의 실시간 플레이어 수와 온라인 상태를 표시하는 세 가지 방법을 제공합니다. 각 방법은 정확도, 설정 노력, 기능 면에서 서로 다른 트레이드오프가 있습니다. 이 가이드는 세 가지 모두를 설명하여 설정에 적합한 것을 선택할 수 있도록 합니다. 세 가지 방법 한눈에 보기 방법플레이어 수업데이트 속도설정 노력적합한 용도 Heartbeat 플러그인정확한 수 + 플레이어 목록60초마다플러그인 설치자체 호스팅 서버 외부 쿼리정확한 수5분마다URL 설정Nitrado / 관리형 호스트 UDP 핑온라인/오프라인만주기적없음 (자동)기본 상태 폴백 방법 1: HytaleCharts Heartbeat 플러그인 (권장) Heartbeat 플러그인은 최고의 방법으로 Hytale 서버 목록에 플레이어 수를 표시합니다. Hytale 서버에서 실행되며 60초마다 온라인 플레이어의 정확한 수와 사용자 이름을 포함한 하트비트 신호를 HytaleCharts에 전송합니다. 보고 내용 플레이어 수 — 현재 접속 중인 플레이어 수 최대 플레이어 수 — 서버의 플레이어 제한 플레이어 목록 — 접속 중인 플레이어의 사용자 이름과 UUID 플러그인 버전 — HytaleCharts가 업데이트에 대해 경고할 수 있도록 내부 작동 방식 플러그인은 60초마다 POST 요청을 /api/heartbeat으로 전송합니다 요청에는 서버의 비밀 키가 포함됩니다 (64자 16진수 문자열) HytaleCharts가 비밀을 검증하고 서버의 플레이어 수와 상태를 업데이트합니다 5분 동안 하트비트가 수신되지 않으면 서버가 오프라인으로 표시됩니다 분석 및 플레이어 수 그래프를 위해 기록 데이터가 저장됩니다 설정 단계 하트비트 비밀 생성 — HytaleCharts에서 서버 편집으로 이동하여 Heartbeat 플러그인 섹션의 "하트비트 비밀 생성"을 클릭합니다 비밀 복사 — 한 번만 볼 수 있습니다 (분실 시 재생성 가능) HytaleCharts 플러그인 설치 서버의 mods/ 디렉토리에 배치합니다 플러그인 구성 — 플러그인 데이터 디렉토리에서 config.json를 생성하거나 편집합니다: { "secret": "YOUR_64_CHARACTER_SECRET_HERE", "debug": false } 서버 재시작 — 플러그인이 즉시 하트비트 전송을 시작합니다 HytaleCharts에서 확인 — 60초 이내에 서버가 플레이어 수와 함께 온라인으로 표시되어야 합니다 다중 인스턴스 지원 여러 서버 인스턴스(예: 로비 서버와 서바이벌 서버)를 실행하는 경우, 하트비트 시스템은 플레이어 수를 자동으로 집계합니다. 동일한 비밀 키를 공유하는 모든 인스턴스의 고유 플레이어가 병합되고 합계가 산출됩니다. 즉, Hytale 서버 목록의 항목이 전체 네트워크의 정확한 합계를 표시합니다. 시스템은 IP 주소와 월드 이름으로 고유 인스턴스를 식별하고, 각 소스에서 최신 하트비트를 가져오며, UUID로 플레이어를 병합하여 여러 인스턴스에 연결된 플레이어의 중복 계산을 방지합니다. 플러그인 업데이트 HytaleCharts는 플러그인 버전을 추적합니다. 새 버전이 사용 가능하면 서버 편집 페이지에 "업데이트 사용 가능" 경고가 표시됩니다. 플러그인을 최신 상태로 유지하면 API 변경에 대한 호환성이 보장되고 최신 버그 수정이 적용됩니다. 방법 2: 외부 쿼리 엔드포인트 (Nitrado 및 관리형 호스트) 모든 Hytale 서버 운영자가 커스텀 플러그인을 설치할 수 있는 것은 아닙니다. Nitrado, 컨테이너 기반 호스트 또는 쿼리 엔드포인트를 노출하는 프로바이더를 사용하는 경우, 외부 쿼리 시스템이 해결책입니다. 작동 방식 HytaleCharts에 서버의 플레이어 수를 JSON으로 반환하는 URL을 제공합니다 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가 즉시 폴링을 시작합니다 외부 쿼리 방법은 하트비트 플러그인보다 업데이트 빈도가 낮지만(5분마다 vs. 60초마다), 서버 측 수정이 필요 없습니다. 방법 3: UDP 핑 (자동 폴백) 하트비트 플러그인이나 외부 쿼리 엔드포인트를 구성하지 않은 경우, HytaleCharts는 UDP 핑으로 서버 상태를 확인합니다. 이는 설정이 필요 없는 수동 시스템입니다. 작동 방식 HytaleCharts가 서버의 공개 포트로 최소한의 QUIC 프로토콜 프로브를 전송합니다 (기본값: 5520) 응답이 수신되면 서버가 온라인 여러 번 재시도 후에도 응답이 없으면 서버가 오프라인 제한 사항 플레이어 수 없음 — UDP 핑은 온라인과 오프라인만 판별할 수 있으며 접속 플레이어 수는 알 수 없습니다 플레이어 목록 없음 — 개별 플레이어 데이터를 사용할 수 없습니다 타이밍 정확도가 낮음 — 상태 업데이트는 실시간 하트비트가 아닌 폴링 일정에 따라 달라집니다 UDP 핑은 기본으로 유용하지만, Hytale 서버 목록 랭킹을 올리려는 서버는 정확한 플레이어 수를 위해 하트비트 플러그인을 설치하거나 외부 쿼리를 구성해야 합니다. HytaleCharts가 서버 상태를 결정하는 방법 여러 방법을 사용할 수 있는 경우 HytaleCharts는 우선순위 시스템을 사용하여 신뢰할 데이터 소스를 결정합니다: 외부 쿼리 (최고 우선순위, 활성화된 경우) — 마지막 성공 폴링이 10분 이내이면 온라인 Heartbeat 플러그인 (구성된 경우) — 마지막 하트비트가 5분 이내이면 온라인 UDP 핑 (폴백) — 마지막 확인의 저장된 온라인/오프라인 결과 사용 즉, 하트비트 플러그인과 외부 쿼리를 모두 구성한 경우 외부 쿼리가 우선합니다. 대부분의 운영자는 둘 중 하나만 사용합니다. 플레이어에게 표시되는 내용 Hytale 서버 목록에서 서버 상태는 색상 배지로 표시됩니다: 플레이어 수가 있는 녹색 배지 (예: "온라인 — 47명 플레이어") — 온라인이고 플레이어가 감지된 경우 녹색 배지 ("온라인") — 온라인이지만 플레이어가 없거나 수를 사용할 수 없는 경우 빨간색 배지 ("오프라인") — 최근 하트비트, 쿼리 또는 핑 응답이 없는 경우 플레이어 수가 표시된 서버는 지속적으로 더 많은 클릭을 유도합니다. "온라인 — 23명 플레이어"를 표시하는 서버는 숫자 없이 "온라인"만 표시하는 서버보다 훨씬 매력적입니다. 이것이 하트비트 플러그인이나 외부 쿼리가 최고의 Hytale 서버. 문제 해결 문제가능한 원인해결 방법 서버가 실행 중임에도 "오프라인" 표시방화벽이 하트비트 또는 핑 차단서버가 hytalecharts.com으로 아웃바운드 HTTPS 요청을 보낼 수 있는지 확인 플레이어 수가 0에서 멈춤플러그인이 플레이어 이벤트를 추적하지 않음플러그인이 로드되었는지 확인(서버 로그 확인)하고 재시작 잠시 후 하트비트 중단플러그인 충돌 또는 언로드서버 로그에서 오류 확인, 필요 시 플러그인 재설치 외부 쿼리가 잘못된 수 표시엔드포인트가 오래된 데이터 반환브라우저에서 직접 JSON 응답 확인 다중 인스턴스 수가 너무 낮음인스턴스가 다른 비밀 사용모든 인스턴스가 동일한 하트비트 비밀을 공유해야 합니다 "업데이트 사용 가능" 경고플러그인이 오래됨HytaleCharts에서 최신 플러그인 버전 다운로드 모범 사례 최고의 Hytale 서버를 운영하는 운영자들이 따르는 패턴: 가능할 때마다 하트비트 플러그인 사용 — 가장 정확하고 반응성이 좋은 옵션입니다 현실적인 최대 플레이어 수 설정 — 과장된 상한(예: 999)은 부정직해 보이고 신뢰를 줄입니다 하트비트 상태 모니터링 — 서버 편집 페이지에서 정기적으로 오류 확인 플러그인 최신 상태 유지 — 오래된 플러그인은 API 변경 후 작동이 중지될 수 있습니다 외부 쿼리를 백업으로 사용 — 플러그인이 다운되면 작동하는 외부 엔드포인트가 상태 정확성을 유지합니다 도메인이 올바른지 확인 — UDP 핑 폴백은 구성된 도메인을 사용하므로 주로 하트비트를 사용하더라도 정확하게 유지하세요 시작하기 하트비트 플러그인으로 플레이어 수를 표시하는 데 5분도 걸리지 않습니다. 비밀을 생성하고, 플러그인을 설치하고, 설정에 비밀을 추가하고, 재시작합니다. Hytale 서버가 1분 이내에 실시간 플레이어 수와 함께 Hytale 서버 목록에 표시됩니다. Nitrado와 같은 관리형 호스팅 제공업체의 경우, 외부 쿼리는 더욱 간단합니다 — URL을 붙여넣기만 하면 HytaleCharts가 나머지를 처리합니다. 어떤 방법이든, 실제 플레이어 수를 표시하는 것은 서버의 가시성을 높이고 새로운 플레이어를 유치하기 위해 할 수 있는 가장 쉬운 일 중 하나입니다. Hytale 서버 목록에서 활성 플레이어 수를 표시하는 서버는 그렇지 않은 서버를 지속적으로 능가합니다.