Hytale

最終更新日: 2026年1月29日

目次

テンプレート説明

Hytale（Early Access版）は、サンドボックス要素とRPG要素を融合したマルチプレイ対応のブロックベースゲームです。本テンプレートは、お客様ご自身でHytale専用サーバーをインストールするための自動セットアップ環境を提供します。Java実行環境とQUIC/UDPプロトコル対応のシステム構成が事前に構築されており、公式から入手したServer Softwareを用いてマルチプレイ環境を簡単にセットアップできます。

サーバーのインストールおよび起動には、お客様ご自身による以下の操作が必要です。
（1）Hytale公式サイトからのServer Softwareダウンロード
（2）CUIでのHytale EULA同意
（3）Hytaleアカウント認証（デバイスベース認証）

サーバー管理者は、公式EULAおよびServer Operator Policiesの内容を理解し、これらの規約に従ってサーバーを運用可能です。

スタートアップスクリプトのテンプレートを利用してサーバー作成を行う手順はご利用ガイドを参照してください。

注意

Hytaleサーバーの運用には以下の要件があります：

  • メモリ: 最小4GB、推奨6GB以上（プレイヤー数により変動）
  • Hytaleアカウント（サーバーファイルのダウンロードと認証に必須）
  • 1つのアカウントで最大100サーバーまで認証可能
  • サーバーファイルの再配布は禁止されています（EULA準拠）

仕様

対応OSイメージ

Ubuntu 24.04 LTS

主要ソフトウェア

ソフトウェア名 バージョン ライセンス 用途
Hytale Server Latest Hypixel Studios EULA ゲームサーバー本体
Java (Adoptium Temurin) 25 LTS GPLv2 + Classpath Exception Javaランタイム環境
hytale-downloader Latest 公式ツール サーバーファイルダウンローダー
screen Latest GPL-3.0 ターミナルマルチプレクサ
UFW Latest GPL-3.0 ファイアウォール管理

スタートアップスクリプト情報

項目 説明
アプリケーション利用ポート 5520/udp (QUICプロトコル)
インストールディレクトリ /opt/hytale
サーバーディレクトリ /opt/hytale/server
管理スクリプト /root/hytale-manage.sh
初期状態 サービス停止中（認証要件のため）

メモ

HytaleはQUICプロトコル（UDP）を使用します。TCPポート転送は不要です。ファイアウォールやルーターのポート転送設定では、必ずUDPプロトコルを指定してください。

その他

最小システム要件

  • CPU: x64またはarm64プロセッサ
  • メモリ: 最小4GB、推奨6GB以上（プレイヤー数により変動）
  • ディスク容量: 20GB以上（SSD推奨、NVMe最適）
  • ネットワーク: パブリックIPアドレス、2Mbps以上
  • Java: Java 25 LTS（スクリプトで自動インストール）

メモ

メモリ要件はプレイヤー数、表示距離設定、MOD使用により大きく変動します。本テンプレートでは「総メモリ – 1GB」を自動的に割り当てますが（最小1GB）、運用中のRAM・CPU使用率を監視し、必要に応じてプランをアップグレードしてください。

利用手順

メモ

スタートアップスクリプトにてアプリケーションのインストールが完了するまで数分かかります。インストール完了後、rootディレクトリに「hytale-info.txt」というファイルが作成されますのでご確認ください。ファイルが存在しない場合、作成されるまでしばらくお待ちください。

Step 0: セキュリティグループについて

ConoHa VPS(Ver.3.0)ではサーバー毎にIPアドレスまたはポートでトラフィックを制御するセキュリティグループ(仮想ファイアウォール)が設定されます。本テンプレートをご利用の場合は、予め利用するポートの通信許可設定が必要です。詳細はセキュリティグループを参照してください。

重要

Hytaleサーバーは初回起動時にOAuth2デバイス認証が必要です。テンプレート作成直後はサーバーファイルがダウンロードされておらず、サービスも停止状態です。以下の手順に従ってサーバーファイルをダウンロードし、認証を完了させてください。

Step 1: VPSへの接続

ConoHa VPSコントロールパネルで設定したrootパスワードまたはSSH Keyを使用してVPSに接続します。

パスワード認証でのSSH接続コマンド例
# ssh root@VPSのグローバルIPアドレス
鍵認証でのSSH接続コマンド例
# ssh -i 秘密鍵ファイルのパス root@VPSのグローバルIPアドレス

Step 2: サーバーファイルのダウンロード

Hytaleサーバーファイルをダウンロードします。このステップではHytaleアカウントでのOAuth2認証が必要です。

ダウンロードコマンド:

# /root/hytale-manage.sh download

認証手順:

  1. コマンド実行後、ブラウザでアクセスすべきURLとコードが表示されます
  2. 表示されたURL（https://accounts.hytale.com/device）にアクセス
  3. 表示されたコードを入力
  4. Hytaleアカウントでログイン
  5. 認証完了後、サーバーファイルのダウンロードが自動的に開始されます

メモ

ダウンロードが完了すると、/opt/hytale/server/ ディレクトリに以下のファイルが配置されます：HytaleServer.jar（サーバー本体）、Assets.zip（アセットファイル）、config.json（設定ファイル）、その他設定ファイル。

Step 3: サーバーの起動

サーバーファイルのダウンロードが完了したら、サーバーを起動します。

起動コマンド:

# /root/hytale-manage.sh start

サーバーはscreenセッション内で起動され、バックグラウンドで動作します。

Step 4: 初回認証（初回起動時のみ必須）

サーバーの初回起動時には、サーバー自体の認証が必要です。この認証により、サーバーがHytaleのサービスAPIと通信できるようになります。

認証手順:

  1. サーバーコンソールに接続: 
    # /root/hytale-manage.sh attach

    または

    # screen -r hytale
  2. コンソール内で認証コマンドを実行: 
    /auth login device
  3. 表示されたURLにアクセス:
    コンソールに表示されるURL（https://accounts.hytale.com/device）をブラウザで開き、表示されたコードを入力してください。
  4. 認証を永続化:
    認証完了後、以下のコマンドで認証情報を永続化します。これにより、サーバー再起動時に再認証が不要になります。

    /auth persistence Encrypted
  5. コンソールから抜ける:
    Ctrl+A を押した後、D を押します。サーバーはバックグラウンドで継続動作します。

重要

認証を永続化しない場合、サーバー再起動時に認証情報が失われます。必ず /auth persistence Encrypted を実行してください。1つのHytaleアカウントで最大100サーバーまで認証可能です。大規模運用の場合は、Server Providerアカウントの申請をご検討ください。

Step 5: クライアントからの接続

認証が完了したら、Hytaleクライアントから接続できます。

接続情報:

  • サーバーアドレス: <VPSのIPアドレス>:5520

Step 6: サーバーステータスの確認

サーバーの動作状況を確認します。

ステータス確認:

# /root/hytale-manage.sh status

以下の情報が表示されます：

  • サーバーの動作状態（RUNNING/STOPPED）
  • サーバーディレクトリパス
  • 使用ポート番号
  • 割り当てメモリ量
  • サーバーファイルの存在確認

管理スクリプト一覧

インストール後、以下の管理スクリプトが利用可能です。

スクリプト名 機能 使用例
start サーバー起動 # /root/hytale-manage.sh start
stop サーバー停止 # /root/hytale-manage.sh stop
restart サーバー再起動 # /root/hytale-manage.sh restart
status ステータス確認 # /root/hytale-manage.sh status
attach サーバーコンソールに接続 # /root/hytale-manage.sh attach
download サーバーファイルダウンロード # /root/hytale-manage.sh download
check-update アップデート確認 # /root/hytale-manage.sh check-update
version ゲームバージョン表示 # /root/hytale-manage.sh version
logs ログ表示 # /root/hytale-manage.sh logs

メモ

サーバーコンソールから抜ける際は、Ctrl+A, D を使用してください。Ctrl+C や exit コマンドを使用すると、サーバーが停止してしまいます。screenセッションから正しくデタッチすることで、サーバーはバックグラウンドで継続動作します。

セキュリティグループ設定

以下のポートを開放する必要があります。

ポート番号 プロトコル 用途 必須/オプション
22 TCP SSH オプション(任意)
5520 UDP Hytaleゲームサーバー 必須

重要

スタートアップスクリプトはUFWを使用してこれらのポートを自動的に設定します。ポート5520はUDPプロトコルで開放されます。TCPポートの開放は不要です。カスタムポートを使用する場合は、サーバー起動時に --bind <port> オプションを指定し、対応するUDPポートを開放してください。

オプション設定

サーバー設定のカスタマイズ

サーバーの設定は以下のファイルで管理されています：

  • /opt/hytale/server/config.json – メインサーバー設定
  • /opt/hytale/server/permissions.json – 権限設定
  • /opt/hytale/server/whitelist.json – ホワイトリスト
  • /opt/hytale/server/bans.json – BANリスト

設定変更後はサーバーを再起動してください：

# /root/hytale-manage.sh restart

MODのインストール

MODファイルを /opt/hytale/server/mods/ ディレクトリに配置し、サーバーを再起動します。

# cp your-mod.jar /opt/hytale/server/mods/
# /root/hytale-manage.sh restart

メモ

MODの使用はサーバーのメモリとCPU使用率を増加させます。リソース不足が発生する場合は、VPSプランのアップグレードをご検討ください。

サーバーアップデート

Hytaleサーバーの新バージョンが利用可能な場合、以下の手順でアップデートできます：

  1. アップデート確認: 
    # /root/hytale-manage.sh check-update
  2. サーバー停止: 
    # /root/hytale-manage.sh stop
  3. 最新版ダウンロード: 
    # /root/hytale-manage.sh download
  4. サーバー起動: 
    # /root/hytale-manage.sh start

ワールドデータのバックアップ

定期的なバックアップを推奨します：

# /root/hytale-manage.sh stop
# cd /opt/hytale/server
# tar -czf /opt/hytale-backup-$(date +%Y%m%d).tar.gz universe/ config.json permissions.json whitelist.json bans.json
# /root/hytale-manage.sh start

トラブルシューティング

サーバーが起動しない場合

# /root/hytale-manage.sh status
# /root/hytale-manage.sh logs
# ls -la /opt/hytale/server/

接続できない場合

# ufw status
# ss -uln | grep 5520

サーバーログで “Authentication successful” メッセージを確認してください。

認証エラーが発生する場合

サーバーコンソールに接続し、再認証を実行してください：

# /root/hytale-manage.sh attach
/auth login device
[ブラウザで認証完了]
/auth persistence Encrypted
Ctrl+A, D

アプリケーションの具体的な利用方法につきましては、サービス開発元やサービス提供元の公式サイト、Wikiなどで最新情報をご確認ください。

サイト名 URL 説明
Hytale公式サイト https://hytale.com/ ゲーム情報・最新ニュース
Hytale Server Manual https://support.hytale.com/hc/en-us/articles/45326769420827 公式サーバーマニュアル
Hytale EULA https://hytale.com/eula エンドユーザーライセンス契約
Hytale Server Operator Policies https://hytale.com/server-policies サーバー運営者向けポリシー
Adoptium (Temurin) https://adoptium.net/ Java 25 LTSダウンロード

おトクなキャンペーン情報