Hytale 서버 설정 방법: 2026 완전 설치 및 구성 가이드

나만의 Hytale 서버를 호스팅할 준비가 되셨나요? 친구들을 위한 비공개 월드를 설정하든 공개 커뮤니티 서버를 시작하든, 이 포괄적인 가이드가 Java 설치부터 수백 명의 플레이어를 위한 성능 최적화까지 모든 과정을 안내합니다. 이 가이드를 마치면 플레이어가 참여할 수 있는 완전히 작동하는 Hytale 전용 서버가 완성됩니다. 시작해 봅시다. 시스템 요구 사항 설치를 시작하기 전에 서버 머신이 다음 최소 요구 사항을 충족하는지 확인하세요: 구성 요소최소권장 RAM4 GB8-16 GB CPU2코어4코어 이상 저장소10 GB SSD50+ GB NVMe SSD JavaJava 25Java 25 (Adoptium 권장) 아키텍처x64 및 arm64 지원 OSWindows, Linux 또는 macOS 리소스 사용량 이해 Hytale 서버의 리소스 소비는 플레이어 행동에 크게 의존합니다: CPU 사용량: 플레이어 수와 엔티티 수(NPC, 몹, 활성 생물)에 따라 결정 RAM 사용량: 로드된 월드 영역에 따라 결정 — 시야 거리가 높을수록, 플레이어가 개별적으로 탐험할수록 메모리 필요량 증가 프로 팁: 게임플레이 중 RAM과 CPU 사용량을 모니터링하여 서버의 일반적인 소비량을 파악하세요. CPU 사용량이 높다면 메모리 압력으로 인한 과도한 가비지 컬렉션일 수 있습니다 — Java의 -Xmx 매개변수를 조정해 보세요. 1단계: Java 25 설치 Hytale 서버에는 Java 25가 필요합니다. 안정적인 프로덕션용 빌드를 위해 Adoptium(이전 AdoptOpenJDK) 사용을 권장합니다. Java 25 다운로드 adoptium.net 방문 운영 체제에 맞는 JDK 25 설치 프로그램 다운로드 설치 프로그램을 실행하고 안내를 따름 설치 확인 터미널 또는 명령 프롬프트를 열고 실행: java --version 다음과 유사한 출력이 표시되어야 합니다: openjdk 25.0.1 2025-10-21 LTS OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS) OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing) 다른 버전이나 오류가 표시되면 Java 25가 올바르게 설치되고 시스템 PATH에 추가되었는지 확인하세요. 2단계: 서버 파일 획득 Hytale 서버 파일을 얻는 두 가지 방법이 있습니다: 옵션 A: 게임 설치에서 복사 (빠른 테스트) 빠른 설정을 위한 가장 쉬운 방법 — Hytale 런처 설치에서 직접 파일을 복사: 파일 위치: 운영 체제경로 Windows%appdata%\Hytale\install\release\package\game\latest Linux$XDG_DATA_HOME/Hytale/install/release/package/game/latest macOS~/Application Support/Hytale/install/release/package/game/latest Server 폴더와 Assets.zip을 전용 서버 위치에 복사합니다. 옵션 B: Hytale Downloader CLI (프로덕션 서버) 프로덕션 환경에서는 공식 Hytale Downloader CLI 도구를 사용하세요. 업데이트가 쉽고 자동화를 지원합니다: 공식 Hytale 지원 사이트에서 hytale-downloader.zip 다운로드 압축 해제 후 포함된 QUICKSTART.md 읽기 다운로더를 실행하여 최신 서버 파일 획득 주요 명령어: 명령어설명 ./hytale-downloader최신 릴리스 다운로드 ./hytale-downloader -print-version다운로드 없이 게임 버전 표시 ./hytale-downloader -patchline pre-release사전 릴리스 채널에서 다운로드 3단계: 서버 시작 서버 디렉터리로 이동하여 다음 명령으로 시작: java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip -XX:AOTCache 플래그는 서버와 함께 제공되는 사전 훈련된 Ahead-Of-Time 캐시를 사용하여 시작 시간을 크게 단축합니다. 최초 인증 첫 실행 후 서버를 인증해야 합니다. 서버 콘솔에서 실행: /auth login device 디바이스 인증 프롬프트가 표시됩니다: =================================================================== DEVICE AUTHORIZATION =================================================================== Visit: https://accounts.hytale.com/device Enter code: ABCD-1234 =================================================================== Waiting for authorization (expires in 900 seconds)... 브라우저에서 표시된 URL 방문 Hytale 계정으로 로그인 콘솔에 표시된 코드 입력 콘솔로 돌아가면 "Authentication successful!"이 표시됨 중요: 각 Hytale 게임 라이선스는 최대 100대의 서버를 지원합니다. 대규모 배포의 경우 추가 라이선스를 구매하거나 서버 제공업체 계정을 신청하세요. 4단계: 포트 및 방화벽 구성 Hytale은 UDP 기반 QUIC 프로토콜을 사용합니다(TCP가 아님). 이는 방화벽 및 포트 포워딩 구성에 중요합니다. 기본 포트 기본 포트는 5520입니다. 다른 포트를 사용하려면: java -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:3500 포트 포워딩 라우터 뒤에서 호스팅하는 경우 UDP 포트 5520(또는 사용자 정의 포트)을 서버 머신으로 포워딩하세요. TCP 포워딩은 필요하지 않습니다. 방화벽 구성 Windows (관리자 권한으로 PowerShell 실행): New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow Linux (iptables): sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT Linux (ufw): sudo ufw allow 5520/udp NAT 고려 사항 QUIC은 대부분의 시나리오에서 NAT 통과를 잘 처리합니다. 플레이어가 연결에 문제가 있는 경우: 포트 포워딩이 TCP가 아닌 UDP용으로 설정되었는지 확인 대칭 NAT 구성은 문제를 일으킬 수 있음 — VPS 또는 전용 서버를 고려 캐리어 등급 NAT 뒤의 플레이어(모바일에서 흔함)는 클라이언트로 정상 연결 가능 서버 파일 구조 서버의 파일 구조를 이해하면 관리와 문제 해결에 도움이 됩니다: 경로설명 .cache/최적화된 파일 캐시 logs/서버 로그 파일 mods/설치된 모드 universe/월드 및 플레이어 저장 데이터 bans.json차단된 플레이어 목록 config.json서버 구성 permissions.json권한 구성 whitelist.json화이트리스트 플레이어 월드 구조 월드는 universe/worlds/에 저장됩니다. 각 월드에는 다음 설정이 포함된 자체 config.json이 있습니다: 월드 시드 및 생성 유형 PvP 활성화/비활성화 낙하 데미지 설정 NPC 스폰 동작 필수 플러그인 각 월드는 자체 메인 스레드에서 실행되며, 병렬 작업은 공유 스레드 풀에 분산됩니다. 모드 설치 Hytale 서버에 모드를 추가하는 것은 간단합니다: CurseForge 또는 기타 신뢰할 수 있는 소스에서 모드(.zip 또는 .jar 파일) 다운로드 서버의 mods/ 폴더에 모드 파일 배치 서버 재시작 참고: 많은 모드가 서버 측에서만 작동합니다 — 서버에 참여하는 플레이어는 수동 설치 없이 자동으로 모드 콘텐츠를 받습니다. 성능 최적화 시야 거리 시야 거리는 RAM 사용량의 주요 결정 요인입니다. 기본 시야 거리 384블록(12청크)은 Minecraft의 약 24청크에 해당합니다. 권장 사항: 소규모 서버(1-10명): 기본 설정으로 충분 중규모 서버(10-50명): 8-10 청크로 제한 고려 대규모 서버(50명 이상): 6-8 청크로 제한하고 리소스 모니터링 권장 플러그인 주요 호스팅 제공업체에서 서버 관리에 유용한 플러그인을 유지 관리합니다: 플러그인설명 Nitrado:WebServer웹 애플리케이션 및 API용 기본 플러그인 Nitrado:QueryHTTP를 통해 서버 상태 공개(플레이어 수 등) Nitrado:PerformanceSaver리소스에 따라 시야 거리를 동적으로 제한 ApexHosting:PrometheusExporter상세한 서버 및 JVM 메트릭 공개 개발 중 Sentry 비활성화 플러그인을 개발 중인 경우 개발 오류 전송을 방지하기 위해 크래시 리포팅을 비활성화하세요: java -jar HytaleServer.jar --assets Assets.zip --disable-sentry 서버 명령어 참조 사용 가능한 모든 서버 인수 보기: java -jar HytaleServer.jar --help 주요 인수: 인수설명 --assets <path>Assets.zip 경로 (기본값: ../HytaleAssets) --bind <address:port>수신 주소 (기본값: 0.0.0.0:5520) --auth-mode <mode>인증 모드: authenticated 또는 offline --backup자동 백업 활성화 --backup-dir <path>백업 디렉터리 위치 --backup-frequency <minutes>백업 간격 (기본값: 30) --disable-sentry크래시 리포팅 비활성화 멀티서버 아키텍처 Hytale은 서버 간 플레이어 라우팅을 기본 지원합니다 — BungeeCord 같은 리버스 프록시가 필요하지 않습니다. 플레이어 전송 연결된 플레이어를 선택적 데이터 페이로드와 함께 다른 서버로 전송: PlayerRef.referToServer(host, port, optionalData) 보안 참고: 페이로드는 클라이언트를 통과하므로 변조될 수 있습니다. 수신 서버에서 진위를 확인하기 위해 암호화 서명(예: 공유 시크릿을 사용한 HMAC)을 사용하세요. 연결 리다이렉트 연결 핸드셰이크 중 플레이어를 다른 서버로 리다이렉트하여 로드 밸런싱 또는 지역 라우팅을 구현합니다. 연결 해제 폴백 플레이어가 예기치 않게 연결 해제되면(서버 충돌, 네트워크 문제), 클라이언트는 메인 메뉴로 돌아가는 대신 사전 구성된 폴백 서버에 자동 재연결합니다. 서버 목록에 등록하기 서버가 실행되면 플레이어에게 알리세요: HytaleCharts에 등록: 서버를 추가하여 무료로 서버 목록에 노출 공식 서버 검색: Hytale 내장 서버 브라우저에 참여 (출시 예정) 커뮤니티 구축: Discord 서버와 소셜 미디어 존재감 구축 랭킹 향상 팁: 높은 가동률 유지 (99% 이상) 서버를 최신 버전으로 업데이트 관련 키워드가 포함된 매력적인 서버 설명 작성 플레이어에게 서버 투표 독려 일반적인 문제 해결 플레이어가 연결할 수 없음 방화벽이 5520 포트에서 UDP를 허용하는지 확인 포트 포워딩이 UDP(TCP가 아닌)로 설정되었는지 확인 서버가 인증되었는지 확인 플레이어가 서버와 동일한 게임 버전인지 확인 높은 메모리 사용량 시야 거리 줄이기 최대 플레이어 수 제한 메모리 집약적 모드 확인 -Xmx 매개변수 적절히 조정 서버 렉 엔티티 수 모니터링 (과다한 몹/NPC) 피크 시간대 CPU 사용량 확인 성능 모니터링 플러그인 사용 지속적으로 최대 부하인 경우 하드웨어 업그레이드 고려 인증 문제 /auth login device 재실행 Hytale 계정이 정상 상태인지 확인 라이선스당 100대 서버 제한을 초과하지 않았는지 확인 핵심 요약 Java 25 필요: 안정적인 빌드를 위해 Adoptium 사용 UDP 포트 5520: QUIC 프로토콜은 TCP가 아닌 UDP 필요 인증 필요: 첫 실행 후 /auth login device 실행 시야 거리 = RAM: 시야 거리를 줄여 메모리 사용량 감소 AOT 캐시: -XX:AOTCache=HytaleServer.aot로 빠른 시작 모드 폴더: mods/에 모드를 넣고 재시작 네이티브 멀티서버: 서버 간 전송에 프록시 불필요 Hytale 서버가 플레이어를 맞이할 준비가 되었습니다. HytaleCharts에 등록하여 커뮤니티를 구축하세요!