2026.11.13広告・PRを含む記事です

【マイクラ統合版】自分で立てたサーバーにアドオンを入れる方法!反映されないときの直し方も

統合版マイクラの洞窟の入口とマグマ、草ブロックが写った実ゲーム映像を背景にした、「統合版サーバーにアドオンを入れる」の記事見出しと副題、mcsrv24.comの表記。背景はバニラのゲーム画面で、アドオンを入れたサーバーの画面ではない。
  • mcaddonやmcpackをサーバーに置いたのに、アドオンが反映されない
  • Realmsのような追加ボタンがなく、どこに何を置けばいいか分からない
  • 今遊んでいるワールドを壊さずに、アドオンを足したい

自分で立てた統合版のサーバーには、アドオンを追加する画面がありません。

パックを展開して置き、ワールドの設定ファイルに登録し、サーバーを再起動すると反映されます。

一番簡単なのは、手元のマイクラでアドオンを有効にしたワールドを、そのままサーバーへ移す方法です。

Realmsで遊んでいる人は、管理画面から入れるRealms向けの手順を見てください。

管理人spaのアイコン
この記事を書いた人spa

マイクラサーバーの構築と運用を繰り返して4年。今もマイクラサーバー「spa77 Network」を運用中で、その経験をもとに記事100本以上を執筆。

結論:パックを置いてワールドに登録し、再起動すると反映される

アドオンをサーバーに入れる作業は、置く、登録する、再起動するの3つです。

置くのは、展開したパックのフォルダをサーバーのbehavior_packsかresource_packsに入れる作業です。

登録するのは、ワールドのフォルダにあるworld_behavior_packs.jsonかworld_resource_packs.jsonへ、パックの情報を書き足す作業です。

再起動するのは、サーバーに新しいパックを読み込ませるためです。

自分の状況によって、選ぶ方法が変わります。

状況選ぶ方法見る見出し
これから新しいワールドで遊ぶ、または実験的機能が要るアドオンを使う手元で有効にしたワールドごと移す方法1
今サーバーで遊んでいるワールドに足すパックを置いて登録する方法2
Aternosを使っているpacksフォルダへアップロードするレンタルサーバーやAternosで入れるとき
マーケットプレイスで買ったアドオンを使いたい自分のサーバーは公式のサポート対象外入れる前に確認すること

アドオンは、ビヘイビアーパックとリソースパックの組み合わせです。

ビヘイビアーパックはモブの動きやゲームのルールを変え、リソースパックは見た目を変えます。

まだサーバーを立てていない人は、自宅PCやAternosで統合版サーバーを動かす手順を先に済ませてください。

入れる前に確認すること

作業を始める前に、次の3つを確かめます。

  • マーケットプレイスで買ったアドオンではないこと
  • サーバーのバージョンに合うアドオンを選ぶこと
  • サーバーを止めてバックアップを取ること

マーケットプレイスで買ったアドオンはサポート対象外

マーケットプレイスのアドオンは、シングルプレイ、マルチプレイ、Realmsで使えます。

一方で、Realms以外の個人のサーバーは、公式のサポート対象に入っていません。

自分で立てたサーバーに入れるアドオンは、マーケットプレイス以外で配布されているものを選んでください。

マーケットプレイスで買ったアドオンを友達と遊びたいなら、Realmsの管理画面から入れる手順で進められます。

サーバーのバージョンに合ったアドオンを選ぶ

アドオンには、対応するマイクラのバージョンがあります。

配布ページに書かれた対応バージョンと、自分のサーバーのバージョンをそろえてから入れてください。

Aternosのサーバーには、シングルプレイのような古いアドオンの自動修正がなく、サーバーのバージョンに合ったアドオンだけが入ります。

あとでサーバーのバージョンを上げるときは、サーバーの更新手順のとおり、追加したパックも一緒に保管してから進めてください。

サーバーを止めてバックアップを取る

ファイルを置いたり書き換えたりする前に、サーバーを止めてください。

そのうえで、サーバーのフォルダごとコピーして残しておきます。

バックアップの取り方は、ワールドのバックアップと復元で説明しています。

方法1:アドオンを有効にしたワールドをサーバーへ移す

手元のマイクラでアドオンを有効にしたワールドを作り、書き出したワールドをサーバーへ置く方法です。

パックを1つずつ置く作業も、JSONの編集も要りません。

ここでは、Windows版のマイクラで書き出す前提で説明します。

Windows版で書き出せない人は、パックを1つずつ置く方法2で進めてください。

サーバーは、一度起動しておいてください。

初回の起動で、worlds、behavior_packs、resource_packsのフォルダが作られます。

手順1:手元のマイクラでアドオン入りのワールドを作る

ダウンロードしたmcaddonを開いて、マイクラに取り込みます。

次に、新しいワールドの作成画面で、リソースパックとビヘイビアーパックを有効にします。

実験的機能が要るアドオンなら、この作成画面の設定で実験的機能もオンにしてください。

オンにしたワールドは戻せないので、先に「実験的機能が必要なアドオンを入れるとき」の節を読んでおきます。

手順2:ワールドをmcworldファイルに書き出す

ワールド一覧で作ったワールドの編集画面を開き、ワールドをエクスポートします。

保存先はデスクトップなど、すぐ見つけられる場所にしてください。

.mcworldという拡張子のファイルができれば、書き出しは完了です。

アドオンを有効にしたワールドを書き出すと、有効にしたパックもファイルの中へ一緒に入ります。

手順3:展開してサーバーのworldsフォルダへ置く

.mcworldは、ワールドのファイル一式をまとめたzipです。

拡張子を.zipに変えて展開し、できたフォルダの名前をaddon_worldのような英数字の名前にしておきます。

サーバーを止めてから、そのフォルダをサーバーのworldsフォルダへコピーしてください。

コピーしたフォルダの中に、behavior_packsとresource_packs、world_behavior_packs.jsonとworld_resource_packs.jsonがあれば成功です。

手順4:level-nameを合わせて起動する

server.propertiesのlevel-nameを、コピーしたフォルダの名前に書き換えます。

大文字と小文字まで、フォルダ名と一致させてください。

server.propertiesの開き方は、server.propertiesの設定一覧で説明しています。

level-name=[コピーしたフォルダの名前]

保存したらサーバーを起動し、マイクラから参加します。

アドオンの追加ブロックやモブ、見た目が出ていれば、導入できています。

うまくいかないときは、level-nameを元の値に戻して起動すると、前のワールドで立ち上がります。

方法2:今のワールドにアドオンを追加する

すでにサーバーで遊んでいるワールドに、パックを置いて登録する方法です。

ワールドを入れ替えないので、建築や持ち物はそのまま残ります。

手順1:mcaddonを展開してパックを取り出す

.mcpackは、リソースパックかビヘイビアーパックをzipにしたものです。

.mcaddonは、.mcpackや.mcworldを入れたzipです。

そのため、拡張子を.zipに変えると、通常のzipとして展開できます。

mcaddonの中にmcpackが入っていたら、そのmcpackも同じ手順で展開してください。

展開した各パックのフォルダの直下に、manifest.jsonがあります。

manifest.jsonのmodulesに書かれたtypeを見ると、どちらのパックか分かります。

typeがdataならビヘイビアーパック、resourcesならリソースパックです。

scriptは、スクリプトで動く部分があることを示します。

手順2:パックをサーバーのフォルダへ置く

ビヘイビアーパックはbehavior_packs、リソースパックはresource_packsに入れます。

置き場所は、サーバー直下と、ワールドのフォルダの中の2か所があります。

サーバー直下に置いたパックは、すべてのワールドで使えます。

ワールドのフォルダの中に置いたパックは、そのワールドを動かしている間だけ使えます。

特定のワールド専用でなければ、サーバー直下に置くのが基本です。

パックのフォルダの直下に、manifest.jsonが来る形にしてください。

[サーバーのフォルダ]/
├── behavior_packs/
│ └── [ビヘイビアーパックのフォルダ]/
│ ├── manifest.json
│ └── ...
├── resource_packs/
│ └── [リソースパックのフォルダ]/
│ ├── manifest.json
│ └── ...
└── worlds/
└── [level-name]/
├── world_behavior_packs.json
└── world_resource_packs.json

手順3:ワールドの設定ファイルに登録する

パックを置いただけでは、ワールドは読み込みません。

ワールドのフォルダにあるworld_behavior_packs.jsonに、ビヘイビアーパックを登録します。

リソースパックは、同じ形でworld_resource_packs.jsonに登録します。

登録に使う値は、パックのmanifest.jsonのheaderにあります。

{
"header": {
"uuid": "[ここのuuidを使う]",
"version": [1, 0, 0]
},
"modules": [
{
"type": "data",
"uuid": "[ここのuuidは使わない]"
}
]
}

world_behavior_packs.jsonは配列で、各要素にpack_idとversionを書きます。

pack_idにはheaderのuuid、versionにはheaderのversionを、配列のまま入れてください。

modulesの中にもuuidがありますが、そちらは登録に使いません。

[
{
"pack_id": "[manifest.jsonのheaderにあるuuid]",
"version": [1, 0, 0]
}
]

すでに別のパックが登録されているなら、既存の要素を消さずに、カンマでつないで足してください。

ファイルがまだないときは、新しく作ります。

手順4:サーバーを再起動して確認する

サーバーを再起動して、新しいパックを読み込ませます。

/reloadで反映できるのは、ビヘイビアーパックのスクリプトを書き換えたときだけです。

リソースパックや新しく登録したパックは、/reloadでは入らないので、再起動してください。

起動したらマイクラから参加して、追加ブロックやモブ、見た目が出ているかを見ます。

出ていなければ、後ろの「アドオンが反映されないときの原因と直し方」の節で、順に調べてください。

直せないまま友達と遊ぶ日になったら、作業の前に取ったバックアップへ戻して起動してください。

実験的機能が必要なアドオンを入れるとき

アドオンによっては、ワールドの実験的機能をオンにしないと動きません。

たとえばBeta APIsは、アドオンの中のbeta版APIモジュールを使えるようにする実験です。

server.propertiesには、実験的機能をオンにする項目がありません。

実験的機能は、ワールドごとの設定で切り替えます。

そこで、実験的機能が必要なアドオンは、手元で実験的機能をオンにしたワールドを作り、方法1でサーバーへ移してください。

すでにあるワールドで実験的機能を後から有効にするより、新しく作ったワールドを移すほうが安全です。

実験的機能を使ったワールドは、実験なしの状態に戻せません。

今のワールドで試す前に、必ずコピーを取ってください。

実験的機能が必要なアドオンの例は、統合版でWorldEditを使う方法で説明しています。

参加者にリソースパックを必ず適用させる

server.propertiesのtexturepack-requiredをtrueにすると、ワールドが使うリソースパックが参加者に強制されます。

既定の値はfalseです。

texturepack-required=true

編集したらサーバーを再起動して、設定を読み込ませてください。

Java版も含めたリソースパックの配布方法は、サーバーでリソースパックを配布する方法で説明しています。

レンタルサーバーやAternosで入れるとき

Aternosは専用のフォルダへアップロードするだけで処理されます。

ConoHa for GAME、XServer GAMEs、ロリポップ! for Gamersの統合版には、アドオン専用の追加画面がありません。

この3つは、ファイルマネージャーやSFTPでファイルを開き、方法2と同じ考え方でパックを置いて登録します。

サービスアドオン専用の機能入れ方
Aternospacksフォルダへのアップロードファイル画面のpacksフォルダへパックをアップロードすると、自動で処理される
ConoHa for GAMEなし。MOD追加はForgeとSpigotだけSFTPで/opt/minecraft_be_server内を開き、方法2の考え方で置く
XServer GAMEsなし。MOD導入機能の対象に統合版は含まれないゲームパネルのファイルマネージャーで、方法2の考え方で置く
ロリポップ! for Gamersなし。MODかんたんインストールはJava版専用ファイル管理で、方法2の考え方で置く

Aternosでは、実験的機能が必要なアドオンなら、実験的機能をオンにしたワールドをアップロードします。

Aternosの手順は、Aternosのヘルプに載っています。

ConoHa for GAMEは、SFTPでつなぐために、SSH用のセキュリティグループを追加する必要があります。

接続の準備は、ConoHa for GAMEの統合版テンプレートのページで説明されています。

XServer GAMEsとロリポップ! for Gamersは、統合版の初期のワールドフォルダがBedrock levelやBedrock_levelのようにサービスごとの名前になっています。

登録するファイルは、server.propertiesのlevel-nameと同じ名前のフォルダに作ってください。

ロリポップ! for Gamersでのリソースパックの置き方は、ロリポップ! for Gamersの公式ブログに画面つきで載っています。

アドオンが反映されないときの原因と直し方

アドオンを入れたのに出てこないときは、次の6つを上から順に確かめてください。

登録したuuidがheaderのuuidと違う

world_behavior_packs.jsonのpack_idが、パックのmanifest.jsonのheaderにあるuuidと同じかを見比べてください。

modulesの中のuuidを写していると、一致しません。

headerのuuidに書き換えて、サーバーを再起動します。

versionがmanifest.jsonと一致していない

登録したversionが、manifest.jsonのheaderのversionと同じかを見比べてください。

versionは、[1, 0, 0]のように数字の配列で書きます。

パックを更新したあとは、数字が変わっていないかも確かめて、そろえます。

JSONの書き方が崩れている

カンマの抜け、括弧の閉じ忘れ、全体を[]で囲んでいないことが原因になります。

ファイルの拡張子が.json.txtになっていることもあるので、ファイル名の末尾も見てください。

直したら、サーバーを再起動します。

パックのフォルダが1段深くなっている

zipを展開したときに、フォルダの中にもう1つフォルダができて、manifest.jsonが1段深い場所にあることがあります。

behavior_packsやresource_packsの直下のフォルダを開いて、すぐ中にmanifest.jsonがあるかを見てください。

1段深いなら、中のフォルダを1つ上に移して、階層をそろえます。

level-nameが別のワールドを指している

server.propertiesのlevel-nameが、登録したワールドのフォルダ名と、大文字小文字まで一致しているかを見てください。

別のワールドを指していると、登録したファイルとは違うワールドが起動します。

フォルダ名に合わせて直し、サーバーを再起動します。

実験的機能がオフのワールドに入れている

実験的機能が必要なアドオンを、実験的機能がオフのワールドに入れていないかを見てください。

server.propertiesには実験的機能の項目がないので、サーバー側では切り替えられません。

手元で実験的機能をオンにしたワールドを作り、方法1で移してください。

まとめ:置いて登録し、再起動してから友達を呼ぶ

統合版のサーバーでは、パックを置いて登録し、再起動すると、アドオンが反映されます。

一番簡単なのは、手元で有効にしたワールドごとサーバーへ移す方法です。

友達が参加して、追加ブロックやモブ、見た目がワールドに出ていれば、導入は成功です。

遊び始めたら、アドオンを足したり入れ替えたりする前に戻せる地点を作れるよう、ワールドのバックアップと復元の手順で定期的に控えておいてください。

自宅のPCでサーバーを動かしていて、PCを止めた日も友達だけでアドオン入りのワールドに入りたいなら、ConoHa for GAMEを借りる方法があります。

Minecraft managerのMOD追加は統合版で使えないため、SSH用のセキュリティグループを追加してSFTPでつなぎ、この記事の方法2と同じ配置と登録をすることになります。

PCの電源を落とした夜も、友達だけでアドオン入りのワールドに入れます

PCを止めた日も遊べるサーバーを借りる

友達が増えて荒らしや重さが気になってきたら、公開前に整える設定のまとめで次に触る設定を選べます。