Hytaleは公式の専用サーバーをHytaleServer.jarとして提供しています(Java 25、4GB以上のメモリ、QUIC上のUDP 5520)。Hytaleアカウントでの認証が必要です。アーリーアクセスのため、Hytaleサポートの公式マニュアルを確認してください。以下はサポートとホスティング業者のガイドを照合した内容です。
手順ごとのインストール
マシンを確認:Java 25 (x64/arm64), 4 GB RAM min.。
サーバーファイルを入手:ゲームのインストールからServerフォルダ(HytaleServer.jar入り)とAssets.zipを取得するか、公式のHytale Downloader(コード認証)を使います。
Java 25をインストールし、java -versionで確認します。
java -jar HytaleServer.jar --assets Assets.zipを実行します。config.json、logs/、universe/は初回起動時に作成されます。
コンソールで/auth login deviceを実行し、accounts.hytale.com/deviceでコードを承認してから/auth persistence Encryptedを実行します。
サーバー停止中にconfig.json(ServerName、MOTD、Password、MaxPlayers、MaxViewRadius)を編集します。
ファイアウォールとルーターでポート 5520/UDP を開放します。
コンソール上部に表示されるアドレス(IP:5520)で参加します。DNS SRVレコードは未対応のため、Aレコードを使ってください。
自動起動(タスクスケジューラまたはsystemdサービス)を設定します。
universe/のバックアップと更新をスケジュールします。
必要条件
- Java 25(x64またはarm64)。メモリ4GB以上。RAMを左右するのは視界距離(MaxViewRadius、最大12チャンク推奨)
- ゲームを所有するHytaleアカウント。1ライセンスにつきサーバーは500台まで
- クライアントとサーバーは同じプロトコルバージョンが必要
ローカル環境へのインストール(Windows)
フォルダ(例:C:\HytaleServer)を作成し、%appdata%\Hytale\install\release\package\game\latestからServerフォルダとAssets.zipをコピーしてコマンドを実行します。ゲームと同じPCで動かす場合は合計16GB以上のRAMが必要です。
cd C:\HytaleServer
java -Xms4G -Xmx4G -jar HytaleServer.jar --assets Assets.zipLinux VPS/専用サーバーへのインストール
Ubuntu/Debianでは非rootユーザーを作成し、Java 25(例:Eclipse Temurin 25)を入れ、Hytale Downloaderでサーバーを取得します(コード認証、トークンは.hytale-downloader-credentials.jsonに保存。認証エラー時はこのファイルを削除)。Downloaderの詳細オプションはここでは扱わないため、ヘルプを参照してください。
sudo adduser --disabled-password --gecos "" hytale
sudo -iu hytale
mkdir -p ~/hytale-server && cd ~/hytale-server
java -version # doit afficher 25 / must show 25
java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip開放するポート
- 5520/UDP:既定のゲームポート(QUIC)。--bindで変更可、TCPの開放は不要
Linuxファイアウォール(ufw)
Ubuntu/Debianでは、締め出されないよう先にSSHを許可し、続いてゲームのポートを許可します。
sudo ufw allow OpenSSH
sudo ufw allow 5520/udp
sudo ufw enable
sudo ufw statusWindowsファイアウォール(netsh)
管理者権限のPowerShell(または管理者のcmd)で実行します。
netsh advfirewall firewall add rule name="Hytale 5520/UDP" dir=in action=allow protocol=UDP localport=5520プロバイダーのファイアウォールとポート転送(NAT)
サーバーをOVH・Hetzner・Scalewayなどに置く場合は、同じポートをネットワークファイアウォール(セキュリティグループ)でも開放します。自宅運用ではルーターからマシンの固定ローカルIPへポート転送(NAT)してください。確認は外部(モバイル回線や友人)から行います。自宅ネットワーク内のテストでは判断できません。
自動起動と監視
/etc/systemd/system/<name>.service を作成し、sudo systemctl daemon-reload && sudo systemctl enable --now <name> を実行します。ログは journalctl -u <name> -f。
[Unit]
Description=Hytale server
After=network-online.target
Wants=network-online.target
[Service]
User=hytale
WorkingDirectory=/home/hytale/hytale-server
ExecStart=/usr/bin/java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip
Restart=on-failure
RestartSec=15
[Install]
WantedBy=multi-user.targetWindowsでの自動起動(タスクスケジューラ)
「スタートアップ時」に起動スクリプトを実行するタスクを作成し、最上位の特権と「ユーザーがログオンしているかどうかにかかわらず実行する」を設定します。
更新・バックアップ・再起動
サーバーを停止し、Hytale Downloaderを再実行して再起動します。大きな更新の前にuniverse/をバックアップしてください。 サーバーは起動のたびに新バージョンを確認するため、通常は再起動で更新されます。パッチライン(release/pre-release)を切り替える前にバックアップしてください。プレリリースのワールドは古いビルドで開けない場合があります。
# backup
tar czf ~/backup-$(date +%F).tar.gz -C ~/server universe/サーバーの登録と見つけ方
サーバーを公開したら、https://game-rank.com/jeux/hytale(このツールの運営サイト)に登録すると、プレイヤーが見つけてフォロー・投票できます。
トラブルシューティング
- 外部から接続できないがlocalhostでは動く場合:OSのファイアウォール、プロバイダーのファイアウォール、NAT転送のいずれかが未設定か、プロトコル(UDP/TCP)が違います。1層ずつ確認してください。
- ゲーム更新後に接続できない場合:クライアントとサーバーのバージョンを一致させる必要があります。サーバーを更新して再起動してください。
- サーバーがすぐ終了する場合:コンソールから起動してエラーを確認し、空きRAM・ディスク・必要なソフトウェアを確認してください。
- 「認証が必要」と出る、または再起動でログインが消える場合:/auth login deviceをやり直し、/auth persistenceを確認してください(Memoryは再起動で消えるためEncryptedを選択)。
- メモリ不足やラグ:RAMを増やす前にMaxViewRadius(/maxviewradius <半径>)を下げてください。
よくある質問
- Hytaleに公式専用サーバーはありますか?
- はい。HytaleサポートがHytaleServer.jarを文書化しています。アーリーアクセスのため、オプションや形式(config.jsonなど)は変わる可能性があります。
- config.jsonジェネレーターがないのはなぜですか?
- 文書化されているのは第三者による一部のフィールド(ServerName、MOTD、Password、MaxPlayers、MaxViewRadius、バックアップ)のみで公式スキーマはなく、創作は行いません。生成されたファイルをサーバー停止中に編集してください。
- 何をバックアップすべき?
- universe/フォルダ(ワールドとプレイヤーデータ)と、config.json、permissions.jsonです。
- アカウントなし(オフラインモード)で動かせますか?
- ガイドでは開発用に--auth-mode offlineが紹介されていますが、公開サーバーの通常の方法ではありません。--helpで確認してください。
