メインコンテンツまでスキップ

手動インポートとゲーム内管理の比較

Nightbreak管理プラグインは現在、ゲーム内でのセットアップとコンテンツ管理を推奨していますが、手動インポートはフォールバックとして引き続き存在します。

推奨：ゲーム内管理​

以下が必要な場合は、セットアップメニューとリンクされたNightbreakトークンを使用してください：

  • アクセス対応のコンテンツ閲覧
  • ワンクリックまたはメニュー駆動のインストール
  • 一括ダウンロードおよび更新コマンド
  • 自動の古いパッケージチェック
  • 現在のコードベースに合ったワークフロー

以下のプラグインの推奨パスです：

  • EliteMobs
  • BetterStructures
  • FreeMinecraftModels
  • EternalTD
  • ResurrectionChest
  • WorldCannon

この6つはすべて共有インポーターを実行するため、6つとも以下の手動フォールバックにも対応しています。

フォールバック：手動インポート​

手動インポートは以下の場合に引き続き有用です：

  • パッケージのzipファイルを既にダウンロード済みの場合
  • サーバー間でファイルを移動する場合
  • テスト中にNightbreakからオフラインで作業したい場合
  • パッケージがゲーム内ダウンロードパス外で意図的に配布されている場合

Nightbreakの一括ダウンロードもプラグインの imports フォルダに保存されます。違いは、ゲーム内パスがアクセスチェックとダウンロードステップを代行してくれることです。

インポートフォルダマップ​

プラグインインポートフォルダ
EliteMobsplugins/EliteMobs/imports
BetterStructuresplugins/BetterStructures/imports
FreeMinecraftModelsplugins/FreeMinecraftModels/imports
EternalTDplugins/EternalTD/imports
ResurrectionChestplugins/ResurrectionChest/imports
WorldCannonplugins/CannonRTP/imports

WorldCannonのプラグインフォルダは CannonRTP という名前です。これはプラグインの 内部名であり、imports フォルダとインストール済みコンテンツの両方がここに置かれます。

手動インポートルール​

  • プラグイン固有のドキュメントで別途指定がない限り、ダウンロードしたパッケージはzipのままにしてください。
  • パッケージを正しい imports フォルダに配置してください。
  • プラグイン固有のドキュメントで必要とされている場合は、プラグインをリロードまたは再起動してください。
  • その後、セットアップメニューを再度開いてインストール状態を確認してください。

共有インポーターは以下を処理できます：

  • imports に配置された .zip パッケージ
  • pack.meta を含む特定の既に解凍済みのフォルダ
  • FreeMinecraftModels 用の .bbmodel ファイル

アーカイブは imports 内の隠しステージングフォルダに展開され、そこからのみインストールされます。FMMは成功時も失敗時もこのステージングフォルダを掃除するため、通常のインポート失敗では、中途半端に展開されたパッケージが隣に残るのではなく、再試行できる状態の元のzipが残ります。

インポーターが受け付けるもの​

pack.meta がコンテンツの行き先を決める​

パッケージは、対象とするプラグインプラットフォームを指定する pack.meta ファイルをトップレベルに同梱できます — elitemobs、betterstructures、freeminecraftmodels、eternaltd、extractioncraft、resurrectionchest、megablocksurvivors、worldcannon（cannonrtp や world_cannon も受け付けます）。この名前は大文字小文字を区別せずに照合され、前後の空白、改行コード、先頭のバイトオーダーマークは無視されるため、Windowsのエディタで保存したファイルでも問題なく動作します。

アーカイブに pack.meta がない場合は、そのアーカイブが置かれた imports フォルダを持つプラグイン向けのパッケージとして扱われます。

pack.meta がインポーターの知らないものを指定していた場合、そのパッケージは拒否され、修正して再試行できるようにzipは imports に残されます。

トップレベルのフォルダ名は認識可能である必要がある​

インポーターは、パッケージ内の各トップレベルフォルダを名前によって行き先へ振り分けます。一部の名前はすべてのプラットフォームで機能します：

フォルダ行き先
worldcontainerサーバーのワールドコンテナ（各サブフォルダが1つのワールドになります）
models または modelengineFreeMinecraftModelsのモデルフォルダ。ModelEngineのみがインストールされている場合はModelEngineのブループリントフォルダ
scriptsplugins/FreeMinecraftModels/scripts
pack.meta無視されます — コンテンツではなくメタデータです

それ以外はプラットフォームごとに解決されます（例：EliteMobsなら custombosses、customitems、content_packages、BetterStructuresなら schematics、spawn_pools、components）。

そのプラットフォームでインポーターが認識できないトップレベルフォルダがあると、部分的にインストールされるのではなくパッケージ全体が拒否され、アーカイブはそのまま残されます。パッケージがインポートできない場合、コンソールが問題のフォルダ名を示します。

失敗したインポートはロールバックされる​

インポートは1つのトランザクションとして適用されます。既存のファイルは置き換えられる前にバックアップされ、置き換えられるワールドフォルダは削除されるのではなく退避され、途中で失敗した場合はパッケージが触れたすべての行き先が復元されます。zipは imports に残るため、安全に再試行できます。ロールバック自体がファイルシステムのエラーに遭遇した場合、コンソールはロールバックが不完全であったことを明示的に報告し、再試行する前にログに記録された行き先を確認するよう指示します。

アーカイブが削除されるのは、インポートが完全にコミットされた後だけです。リロード後もパッケージが imports に残っている場合、それはインストールされなかったことをインポーターが伝えています — 理由についてはコンソールを確認してください。

重要な違い​

ゲーム内パス​

  • トークン対応
  • ロックされたコンテンツや古いコンテンツを表示可能
  • 一括操作後、通常は自動的にリロード
  • 現在意図されている管理ワークフローを反映

手動パス​

  • ゲーム内ダウンロードアクセスなしで動作
  • zipファイルを自分で管理する必要がある
  • プラグインのリロードが必要な場合がある
  • プラグインによっては、コンテンツがダウンロード済みだが有効化されていない状態になる可能性がある
  • ゲーム内アクセスフローがインストール時まで通常隠すパッケージ構造の問題が露出する可能性がある