웹훅을 설정하고 Hytale Server에 대한 알림

HytaleCharts는 연결할 수 있는 몇 가지 통합 옵션을 제공합니다. Hytale 서버 목록 Discord, 게임 서버 및 외부 도구. 서버의 플레이어 투표를 할 때 Discord 알림을받을 수 있습니다. Votifier를 통해 방아쇠 인게임 보상, 자신의 백엔드에 사용자 정의 웹훅을 불고, 심장부 플러그인으로 서버 상태를 유지하십시오. 이 가이드는 각 통합 스크래치에서 설정하는 방법을 다룹니다. 이 모든 기능은 서버 소유자 또는 팀 구성원으로 로그인 한 후 HytaleCharts에서 서버 편집 페이지에서 액세스 할 수 있습니다. Discord 투표 웹훅 Discord webhooks 는 Discord 채널에서 알림을 받거나, 즐겨 찾기, 또는 서버 목록에서 리뷰를 나타낸다. 디코드 Webhooks 설정 Discord 서버에서 webhook을 관리합니다. Server 설정으로 이동, 다음 통합, 다음 Webhooks. "New Webhook," 을 클릭하십시오 이름 (예를 들어, "HytaleCharts 표를"), 채널을 선택하고 webhook URL을 복사하십시오. HytaleCharts에서 webhook URL을 추가합니다. 서버의 편집 페이지로 이동하여 Discord Webhook 섹션을 찾아 URL을 붙여 넣으십시오. 설정을 저장합니다. 이름 * 차트는 이제 투표, 즐겨, 또는 검토 이벤트가 발생할 때마다 Discord 채널에 포함 된 형식을 보낼 것입니다. 지급 Each webhook 알림은 Discord로 전송됩니다. 이벤트의 유형 (최초, 좋아하는, 리뷰) 동작을 수행하는 플레이어의 사용자 타임스탬프 서버 이름과 링크를 다시 HytaleCharts listing Webhook 납품은 3개의 시도를 가진 재기 체계를 이용하고 retries 사이 5-second 백오프. 모든 시도가 실패하면 실패가 기록되고 HytaleCharts는 서버 당 연속 실패를 추적합니다. 웹훅 URL이 지속적으로 실패하면 (HTTP 오류 또는 시간 중단), 그것은 결국 그것을 업데이트하거나 수정할 수 있습니다. http://www.hytale.com/5e7ba23b50cbcd001176c66b_66___farm.jpg 서버의 종류를 보여주는 Hytale 농장은 지역 사회 참여 도구"로드 ="lazy"스타일 ="폭 : 100 %; 높이 : 자동; 국경 반경 : 8px; 마진 : 1.5rem 0;" /> Votifier: 게임 투표 보상 Votifier는 게임 서버에 직접 투표 알림을 보내는 프로토콜이며 HytaleCharts에 투표 할 때 플레이어를 보상 할 수 있습니다. 이름 * 차트는 세 개의 Votifier 변형을 지원합니다. Votifier v1 (RSA 암호화) 원래 Votifier 프로토콜은 RSA 암호화를 사용합니다. 투표가 캐스팅되면 HytaleCharts는 서버의 공개 키로 투표 메시지를 암호화하고 TCP를 통해 전송합니다. Votifier v1 설정: Votifier-compatible 플러그인 Hytale 서버 RSA 키 쌍을 강화 (폴더는 일반적으로 첫 번째 실행에 자동으로 수행) 당신의 public key 플러그인의 구성 에 Hytale 차트, 서버의 편집 페이지로 이동하고 "v1"에 Votifier 유형을 설정 서버의 host (IP 주소 또는 도메인), port (게임 포트가 아닌 Votifier 청취 포트), public key Save and use the "테스트 커넥션" button to check it works 투표 메시지는 표준 Votifier 형식을 따릅니다: VOTE\nHytaleCharts\n{username}\n{ip_address}\n{timestamp}\n, PKCS#1 v1.5 패딩 암호화. Votifier v2 (HMAC-SHA256) Votifier v2는 더 현대적인 프로토콜입니다. RSA 암호화 대신 HMAC-SHA256 서명을 공유 토큰으로 사용합니다. Handhake는 재생 공격을 방지하기 위해 서버에서 도전 문자열을 포함합니다. Votifier v2를 설정하려면: V2 호환 Votifier 플러그인 는 플러그인의 구성 파일에서 token (shared secret)을 공유합니다. 에 Hytale 차트, "v2"에 Votifier 유형을 설정 서버의 host, port 및 token를 입력하십시오. 저장하고 연결를 시험하십시오 v2 프로토콜은 TCP를 통해 연결되며, 도전 토큰으로 Handhake 인사를 읽습니다. 그러면 HMAC-SHA256과 서명된 JSON 페이로드를 포함하는 바이너리 패킷을 보냅니다. 페이로드에는 서비스 이름 ( "HytaleCharts"), 사용자 이름, IP 주소, 밀리 초의 타임 스탬프 및 도전 문자열이 포함됩니다. HTTP 전압 For Hytale-specific plugins that use HTTP 대신 raw TCP, HytaleCharts는 HTTP 엔드포인트 모드를 지원합니다. 플러그인 개발자를 위한 가장 간단한 프로토콜입니다. HTTP Votifier 설정: HTTP 엔드포인트를 수신하는 플러그인 설치 에 Hytale 차트, "HTTP"에 Votifier 유형을 설정 전체 endpoint URL (예: https://your-server.com:8080/vote) 플러그인이 토큰이 필요하면 토큰 필드에 입력합니다. HytaleCharts는 X-Votifier-Signature 헤더의 HMAC-SHA256 서명을 요청합니다. 저장 및 테스트 HTTP 요청은 JSON body를 serviceName, username, address, timestamp로 보냅니다. 필드. 모든 Votifier 유형에 대한 즉각적인 메모 Usernames는 Hytale의 사용자 이름 제한과 일치하기 위해 16자에 truncated. HytaleCharts는 플레이어의 Hytale 사용자 이름을 설정하면 Discord 사용자 이름을 사용합니다. Connection timeout은 5 초입니다. 서버가 5 초 이내에 응답하지 않으면 시도가 실패합니다. 실패 시도는 최대 3 배 exponential backoff (10s, 30s, 시도 사이 60s). HytaleCharts의 Test Connection 버튼을 사용하여 실제 투표를 필요로하지 않고 설정을 확인할 수 있습니다. 이 체크는 서버가 도달 할 수 있으며 예상 Votifier Handhake와 응답합니다. Generic 웹훅 자신의 백엔드 서비스, 봇, 또는 응용 프로그램에 투표 알림을 보내려면 일반 웹훅을 사용자 정의 URL 및 페이로드 템플릿을 정의 할 수 있습니다. 일반 웹훅 작업 서버의 편집 페이지에, 웹훅 구성 섹션로 이동 URL 의 끝점 을 입력하십시오. payload Template 을 설정하고 싶은 데이터 설정 투표 이벤트가 발생하면 HytaleCharts는 HTTP POST 요청을 URL로 설정된 페이로드로 보냅니다. 시스템에서 실제 값으로 교체되는 템플릿 변수를 지원합니다 (voter 사용자 이름, 서버 이름, 타임스탬프 등). Generic webhooks는 Discord webhooks와 동일한 재량 논리를 사용합니다: 진보적인 backoff (10s, 그 후에 retries 사이 30s)를 가진 3개의 시도. 모든 retries가 실패하면 실패는 서버에 대해 추적되고 영구적 인 실패는 대시보드에 떨어질 것입니다. Heartbeat Plugin: 온라인 상태 추적 HytaleCharts heartbeat 플러그인은 게임 서버에서 실행되며 주기적인 상태 업데이트를 보내서 항상 정확한 온라인/오프라인 상태와 플레이어 수를 보여줍니다. 이 작동하는 방법 플러그인은 하트비트를 https://hytalecharts.com/api/heartbeat로 보냅니다. 각 5 분 (또는 프리미엄 서버 20 초마다). 각 심박수 포함: 서버의 heartbeat secret (64character hex token) Current player count 과 max players A players array (username, UUID, world, ping) Server metadata like server name, MOTD, uptime, memory usage 목록의 설치 플러그인 과 세계 이름 설정 단계 심부 비밀을 강조합니다. 서버의 편집 페이지에서 Heartbeat 섹션으로 이동하고 "Generate Secret"를 클릭하십시오. 독특한 64character 토큰을 만듭니다. 플러그인 설치. 서버의 mods/에서 HytaleCharts 플러그인을 배치하십시오. 디렉토리. 플러그인 구성. 플러그인의 config.json 파일을 편집하고 비밀을 설정: 이름 * "secret": "YOUR_64_CHAR_HEARTBEAT_SECRET", "debug": 거짓 자주 묻는 질문 서버를 재시작합니다. 플러그인은 즉시 하트비트 전송을 시작합니다. HytaleCharts에서 확인. 서버의 편집 페이지를 확인; 그것은 마지막 심박수 타임스탬프를 표시하고 연결이 활성화되어 있음을 나타냅니다. 다 서버 집계 여러 서버 인스턴스를 실행하면 (lobby, 생존, 창조적) 같은 심박수 비밀을 공유, HytaleCharts는 자동으로 그들을 집계. IP 주소와 서버 이름에 의해 구분된 인스턴스를 식별하고, 각에서 최신 심박수를 취하며, UUID가 결합하여 이중 통화를 방지합니다. 목록에 표시된 총 플레이어 수와 최대 플레이어는 모든 인스턴스의 결합 값을 반영합니다. 온라인 상태 우선 순위 행복 차트는 우선 순위 시스템을 사용하여 서버의 온라인 상태를 결정합니다. 외부 쿼리 엔드포인트 (config, e.g., Nitrado 쿼리 API) Heartbeat 플러그인 (서버는 마지막 5 분 안에 수신된 경우 온라인으로 보여줍니다) UDP ping (폴백 서버 쿼리) 심베트 플러그인이 5 분 이상 침묵하고 외부 쿼리가 구성되지 않는 경우 서버는 UDP 핑 상태로 돌아갑니다. 공유 서버 API 토큰 HytaleCharts는 유권자 데이터, 서버 통계 및 기타 정보 프로그래밍을 쿼리 할 수있는 공공 API를 제공합니다. 그것을 사용하려면 API 토큰이 필요합니다. 당신의 API 토큰 서버의 편집 페이지로 이동 HytaleCharts API 섹션 API 토큰 Copy를 저장하고 안전하게 저장하십시오. 토큰은 공개 서버 API 엔드포인트에 모든 요청을 인증합니다. API 사용 는 API 요청의 Authorization 헤더에 있는 토큰을 포함합니다: GET /api/public/servers/{server_id}/voters 작성자: Bearer YOUR_API_TOKEN 공개 API는 최근의 유권자, 서버 통계 및 서버에서 사용자 정의 통합, 리더 보드 또는 보상 시스템을 구축하는 데 사용할 수있는 기타 데이터를 fetch 할 수 있습니다. 완벽한 API 문서 및 엔드포인트 세부 사항, Server API 페이지를 HytaleCharts에서 확인하십시오. 태그 일 가능한 원인Solution Discord webhook는Invalid webhook URLDelete를 보내고 Discord에서 webhook을 다시 생성한 다음 HytaleCharts에 URL을 업데이트합니다. Votifier 테스트는 "No response"Firewall가 Votifier 포트Votifier 포트를 차단하지 못했습니다 (게임 포트가 아닌) 방화벽 Votifier test는 "Invalid V2 Handhake"Server는 v1을 지원하지만 v2V1에 Votifier 유형을 변경하고 토큰 대신 RSA 공개 키를 제공합니다. Heartbeat not registeringWrong secret in plugin configDouble-check that secret in config. json은 HytaleCharts 정확히 보여준 것 Player count show 0Plugin version old than 1.5.0 Hytale 업데이트 Charts 플러그인을 최신 버전으로 전송하는 개별 플레이어 데이터 Webhook은 실패100+ 연속 실패Fix 엔드포인트 URL로 표시되어 테스트합니다. 성공적인 납품은 실패 카운터를 재설정합니다. 여러 가지 문제가 발생하면 연락처 양식를 HytaleCharts에서 확인할 수 있습니다. 서버의 webhook 로그와 heartbeat 역사를 확인하고 문제를 진단할 수 있습니다. 이 통합을 설정하는 것은 몇 분이 걸리지 만 서버가 HytaleCharts 및 커뮤니티와 어떻게 상호 작용하는지 크게 개선합니다. 적극적인 투표 알림 및 게임 보상을 제공하는 서버는 지속적으로 더 높은 참여를보고 투표자로부터 방문합니다. 다른 서버 목록를 찾아서 상위 서버가 통합 기능을 설명하는 방법을 확인하고, 당신이 설정한 것을 자신의 목록 언급하십시오.