Windows、Linux、macOSでHytaleにmodをダウンロードしてインストールする方法を解説するガイドです。
Hytaleのmod制作は、このサイトで紹介している他のほとんどのゲームとは仕組みが異なり、何かをダウンロードする前にその違いを理解しておく価値があります。Hypixel Studiosは、Hytaleをサーバーサイド優先で構築しました。modはワールドをホストする者がインストールするものであり、プレイヤー各自がインストールするものではありません。また、スタジオはクライアントmodを一切サポートする意図がないとはっきり述べています。
これは制限が多いように聞こえますが、それによって得られるものを理解すれば話は違ってきます。つまり、何もインストールすることなく、mod導入済みのHytaleサーバーに参加できるのです。クライアントパックも、バージョンの調整も、ランチャープロファイルも不要です。
今回の例はBetterMapで、ゲーム内マップに永続的な探索記録、ウェイポイント、洞窟のレンダリングを追加するサーバープラグインです。
必要なもの
- Windows、Linux、macOSのいずれかで動作するPC。Hytaleはこの3つすべてにネイティブビルドがあります。
- hytale.comから購入したHytale本体。このゲームはアーリーアクセス中で、Steamでは配信されていません。
- インストールするものに応じた十分な空き容量。モデルやテクスチャの多いアセットパックは容量が大きくなりがちですが、プラグインは通常小さめです。
.zip解凍ツール。ただし多くの場合、そもそも解凍の必要はありません。
注意 - Hytaleは2026年1月からアーリーアクセス中で、今もなお急速に開発が進んでいます。Hypixel Studiosはmod制作ツールの現状について率直に自己批判しており、ドキュメントの不足や、まだ粗削りなシステムがあることを認めています。今後仕様が変わることを想定し、アップデート後にmodが動かなくなることも時折あると考えておいてください。
サーバーサイドmod制作の仕組み
Hypixel Studiosはmod制作戦略を発表した際にいくつかの原則を示しており、そのうち2つがこのガイドの内容すべてに関わってきます。
- サーバーサイド優先。 Hytaleのmod制作はすべて、サーバーのホストまたはゲームのホストを基盤としています。外部modをダウンロードしたり、クライアントパックを調整したりすることなく、mod導入済みのHytaleサーバーに参加できるべきだ、という考え方です。
- 1つのコミュニティ、1つのクライアント。 サーバーごとに専用の改造クライアントが必要になるようなエコシステムを避けたいという方針です。これにより、クライアントは安定して統一された状態を保ちつつ、多様性はサーバー側が提供します。
実際には、これはmodがホストによって一度だけインストールされ、接続してくる全プレイヤーが完全にバニラのクライアントのまま、modが適用された体験を得られることを意味します。
シングルプレイもサーバーの一種
これを理解すると、他のすべてが腑に落ちます。
Hytaleには従来の意味での独立したシングルプレイモードはありません。シングルプレイのワールドを作成すると、あなた専用のローカルサーバーに参加していることになります。つまり「ホスト」はあなた自身であり、シングルプレイ用にmodをインストールする操作は、サーバーにインストールするのと同じ作業を、別のフォルダに対して行うだけです。
その後、どのmodを使うかをセーブデータごとに選択できます。これは実に良くできた仕組みで、あるワールドは大幅改造版、別のワールドはバニラのまま、というようにプロファイルの切り替えなしで両立できます。
他人のmod導入済みサーバーに参加する
何もインストールする必要はありません。サーバーに接続してプレイするだけです。
ホストのプラグインとアセットパックが体験を左右し、あなたのクライアントはサーバーから送られてくる内容をそのままレンダリングします。だからこそ、ゲーム内のサーバーブラウザは互換性チェックを行い、実際に参加できるサーバーだけを表示できるのです。
Hytale mod の4つの種類
Hytaleのmod制作は技術的に4つのカテゴリーに分かれており、どのカテゴリーに該当するかを知っておくと、何が起こるかを予想しやすくなります。
| 種類 | 形式 | 内容 |
|---|---|---|
| サーバープラグイン | Java .jar |
サーバーをプログラムで拡張する。ミニゲーム、経済システム、コマンド、独自ロジックなど。最も強力なカテゴリー。 |
| データアセット | JSON | ブロック、アイテム、NPC、ワールド生成、ルートやドロップテーブルなど、コアコンテンツを定義する。 |
| アートアセット | モデル、テクスチャ、サウンド | あらゆるものの見た目や音を定義する。HytaleはモデルやアニメーションにBlockbenchをサポートしている。 |
| セーブファイル | ワールドとプレハブ | ワールド全体、またはクリエイティブツールやワールド生成で使われるプレビルドされた構造物。 |
アセットパックは、上記の中間の2つをまとめるパッケージ形式です。アセットパックとは、内部にmanifest.jsonを含むzipファイルまたはフォルダで、基本ゲームを上書きまたは追加するカスタムアセット群を含んでいます。ゲーム内のAsset Editorで作成することも、ファイルブラウザで手作業で作成することもできますが、フォルダ構成が厳密なため、スタジオはエディタの使用を推奨しています。
BetterMapはサーバープラグインなので、最初のカテゴリーに該当します。
注意 - HytaleにはLuaやその他のテキストベースのスクリプティングは存在せず、スタジオは今後も導入しないと述べています。彼らの計画は、Unreal Blueprintsの精神に則ったビジュアルスクリプティングと、プログラマー向けのJavaです。
modの配置場所
重要な場所は2つあります。
グローバルmodフォルダは、すべてのワールドで使用されます:
C:\Users\<user>\AppData\Roaming\Hytale\UserData\Mods
ワールドごとのmodフォルダは、各セーブデータにも存在します:
C:\Users\<user>\AppData\Roaming\Hytale\UserData\Saves\<World Name>\mods
LinuxとmacOSでは、UserDataフォルダはそのシステムに対応するアプリケーションデータの場所にあり、その下の構造は同じです。
グローバルのModsフォルダに入っているものはどのワールドからも利用できます。ワールド自身のmodsフォルダに入っているものは、そのワールド専用です。
ヒント - Windowsでは、File Explorerのアドレスバーに%appdata%\Hytale\UserDataと貼り付けると、直接そこに移動できます。
シングルプレイ用にmodをインストールする
- CurseForgeのHytaleセクションにアクセスし、MODを探します。このガイドではBetterMapを使用します。
- ダウンロードします。
UserData\Modsフォルダを開きます。- ダウンロードしたファイルをそこに入れます。アセットパックはZIPのままでも展開してフォルダにしてもよく、プラグインは
.jarのまま入れます。 - Hytaleを起動します。
- New World メニューを開き、Options の下を確認します。インストール済みのMODやアセットパックがそこに表示されます。
- そのワールドで使いたいものを有効にして、ワールドを作成します。
見落とされがちなのが最後のステップです。MODをフォルダに入れることで利用可能になりますが、実際に使うかどうかはワールド作成時にワールドごとに選択します。
CurseForgeが主要な配布先となっているのは、Hypixel StudiosがCurseForgeと組んで賞金10万ドルのNew Worlds Modding Contestを開催したことを考えれば不思議ではありません。2026年初頭時点で、プラットフォーム上には5,000件以上のHytale MODがあり、合計ダウンロード数は2,000万を超えています。
専用サーバーへのMODのインストール
他の人のために運営するサーバーでも考え方は同じで、対象となるフォルダがサーバー自身のものになるだけです。
- MODをダウンロードします。
- サーバーの
modsディレクトリに入れます。 - サーバーを再起動します。
BetterMapは必要なものをすべてそこに保持し、初回起動時に設定とデータ用の mods/bettermap/ を作成します。
サーバーに接続するプレイヤーは何もインストールする必要がありません。それこそがこのモデルの要点です。
そもそもサーバーを立てようとしている場合は、別途Hytaleサーバーガイドで解説しています。
TMC Appを使ったインストール
Hytale用のMODマネージャーはまだ存在しないため、ここで触れておく価値があります。The TMC Appは私たち独自のMODマネージャー兼サーバーブラウザで、ワンクリックインストールとサンドボックス機能を備えています。サンドボックスとはゲームごとに名前を付けたMODプロファイルで、それぞれ独自のロード順とデプロイ方法を持ち、何も再ダウンロードすることなく切り替えられます。
Hytaleはまだサポート対象ゲーム一覧には入っていませんが、相性は良いはずです。このアプリはゲームのMODがどこに置かれ、どう起動されるかを把握することで動作し、そのどちらもコードではなく4つのJSONファイルで定義されます。ローダーが介在しないHytaleの UserData\Mods フォルダは、このシステムにとってこれ以上ないほどシンプルな対象です。サンドボックスも、Hytaleのワールドごとのmod選択にきれいに対応するはずです。
正直なところを言うと、このアプリはまだ非常に初期の開発段階です。 READMEにも部分的にしかテストされていないと明記されており、それを取り繕うつもりはありません。Hytale自体もアーリーアクセスで毎週のように変化しているので、これは若い者同士が向き合っている状態です。それでも構わないという方は、試してフィードバックをいただけると本当に助かります。
これはgithub.com/modcommunity/tmc-appでGPL-3.0のもとオープンソースとして公開されています。バグ報告や機能要望はissueトラッカーへどうぞ。プルリクエストも歓迎します。私たちが対応するより先にHytaleサポートを追加したい場合に備えて、リポジトリにはゲームごとのフォーマットについてのドキュメントもあります。
インストール方法：
- Linux: 1行のコマンドのみで、root権限もパッケージマネージャーも不要です。
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows: リリースページから
setup.exeまたはsetup.msiを入手します。ポータブル版もありますが、ランチャーへの登録やtmc://リンクハンドラーの登録は行われません。 - macOS: 同じリリースページから
.dmgを入手します。
MODの設定
統一された標準規格はありませんが、よくあるパターンとしては、MOD自身の mods 以下のフォルダ内にJSON設定ファイルを置く形です。
BetterMapは良い例です。設定は mods/bettermap/config.json にあり、探索範囲、マップの品質、更新頻度、探索情報をプレイヤー間で共有するかどうかといった項目を公開しています。
{
"explorationRadius": 16,
"updateRateMs": 500,
"mapQuality": "MEDIUM",
"shareAllExploration": false,
"radarEnabled": true
}
よく作り込まれたプラグインには、管理者向けコマンドと権限も追加されています。BetterMapは /bm コマンドを登録しており、その中には再起動なしで設定変更を反映できる /bm reload も含まれていますが、一部の設定には完全な再起動が必要になると注記されています。
MODのCurseForgeの説明文を読みましょう。Hytaleのmodding文化はまだ若く、そのページが唯一のドキュメントであることも非常に多いです。
ワールドごとのMOD
アセットエディターでゲーム内作成されたアセットパックは、グローバルフォルダではなくそのワールド自身の mods フォルダに保存されます。何かを制作している最中は便利ですが、2つ目のワールドを始めて自分のパックがどこにあるか分からなくなったとき、初めて戸惑うポイントでもあります。
あるワールドで作ったパックを別のワールドで使うには、次の場所からコピーします：
UserData\Saves\<World Name>\mods
次にコピー先はこちらです：
UserData\Mods
一度グローバルフォルダに入れれば、以降作成するすべての新しいワールドのオプションに表示されるようになります。
対応プラットフォーム
HytaleはWindows、macOS、Linuxでアーリーアクセスを開始しており、それが全てです。コンソール版やモバイル版はなく、Steamでの配信もありません。
これら3つのデスクトッププラットフォーム間でのクロスプラットフォームプレイは実現されており、より広範なクロスプラットフォーム対応もゲームが再取得された時からの計画に含まれていますが、現時点でMODをインストールできるのはデスクトップのみです。
MODの更新と削除
Hytale向けのMODマネージャーはまだ存在しないため、どちらも手作業になります。
- 更新: CurseForgeから新しいバージョンをダウンロードし、
Mods内の古いファイルを置き換えます。設定が引き継がれるかどうかはMODのページで確認してください。 - 削除:
Modsからファイルを削除するか、あるいは対象ワールドでそのMODのチェックを外すだけでも構いません。 - 特定のワールドだけ無効化: ファイルはそのままにしておき、そのワールドのオプションでチェックを外します。
WARNING - ブロック、アイテム、クリーチャーを追加していたMODを、それらを使用しているワールドから削除すると、他のブロック系ゲームと同様にそのワールドが不正な状態になることがあります。既存のワールドからMODを取り除く前に、セーブフォルダをバックアップしてください。
トラブルシューティング
MODがNew Worldのオプションに表示されません。 フォルダが間違っています。UserData\Mods か、そのワールド自身の mods フォルダに入っている必要があり、アセットパックには有効な manifest.json が必要です。
MODをインストールしたのに、すでにあるワールドに変化がありません。 MODはワールド作成時に選択されるものです。既存のワールドは新しくインストールされたMODを自動的には取り込みません。
ゲーム内で作ったパックが別のワールドに見当たりません。 アセットエディターのパックは作成したワールドに保存されます。グローバルの Mods フォルダにコピーしてください。
プラグインは読み込まれるがコマンドが何も反応しない。 パーミッションを確認してください。Hytaleのプラグインはパーミッションノードを使用しており、コマンドを実行するには通常OP権限か明示的な付与が必要です。
Hytaleのアップデート後に全部おかしくなった。 この段階では想定内です。Hytaleは毎週プレリリースパッチを配信し、それらを数週間ごとに安定版としてまとめてリリースしているため、Modが追いつくには時間がかかります。
参加するにはModをインストールする必要があるとプレイヤーに言われた。 そんなことはありません。もしそう言われたなら、それは別のゲームの仕組みの話をしているだけです。
クライアントMODは使えますか? いいえ。クライアントMODのサポートはなく、スタジオも今後予定はないと明言しています。
まとめ
Hytaleのmodding は、たった一つの考え方に集約されます。ホストがインストールし、それ以外の人はただプレイするだけ。ファイルをUserData\Modsに置き、ワールド作成時にチェックを入れれば完了です。専用サーバーの場合も同じファイルをサーバー自身のmodsフォルダに置くだけです。
これは他のガイドで扱っているBepInExやMODローダーのセットアップとは根本的に異なるモデルであり、一度理解してしまえば手間ははるかに少なくなります。ツール群はまだ若く、ドキュメントも断片的であることはHypixel Studios自身も認めているので、状況が落ち着くまではMODの説明文やdocs.hytale.comを頼りにしてください。
何か協力したいと思ったら、TMC Appはオープンソースで、まだ開発の非常に初期段階にあります。フィードバックをいただけると本当にありがたいです。
関連項目
- Hytale on CurseForge
- Hytale Documentation - サーバー運用とMOD制作に関する公式ドキュメント。
- Creating Content in Hytale - アセットパック、ワールド生成、各種エディタについて。
- Hytale Modding Strategy and Status - moddingの現状と今後の方向性についてのスタジオ自身による説明。全文を読む価値あり。
- Official Hytale Discord
- Hytale Wiki
- TMC App
Hytaleはアーリーアクセス中で変化が速いため、このガイドは他のものより古くなりやすいです。もし記載内容が実際の挙動と合わなくなっていたら、報告いただくか、このガイドのGitHubリポジトリでプルリクエストを開いてください。
質問がある方、modding関連で何か手伝ってほしいことがある方は、ぜひDiscordサーバーにご参加ください!