FreeMinecraftModelsのセットアップ
FreeMinecraftModelsは引き続き手動の.bbmodelインポートをサポートしていますが、現在のセットアップフローはNightbreak対応かつメニュー駆動です。
前提条件
- サーバー用のJava 21ランタイム
- Minecraft 1.21.4以降。プラグインは
api-version: 1.21.4を宣言しており、古いバージョンでは読み込めません - FreeMinecraftModelsをインストールし、一度起動してデータフォルダを生成しておく。MagmaCoreはプラグインのjarに同梱されているため、別途インストールは不要です
- 生成されたリソースパックをプレイヤーに配布する手段
ResourcePackManagerは推奨の配布経路です。FreeMinecraftModelsはパックを生成するだけで、自分自身ではホスティングしないからです。
初回フロー
| コマンド | 用途 |
|---|---|
/fmm setup | プレイヤー専用のコンテンツ管理／初回オンボーディングメニュー（初回起動時にプレイヤーが案内されるコマンド） |
/fmm recommendedplugins | FreeMinecraftModelsと相性の良いコンパニオンプラグインを表示します |
/fmm downloadall | 一括インストールヘルパー：最新のプラグイン更新とアクセス可能なすべてのNightbreakパックをダウンロードします |
/fmm downloadallcontent | アクセス可能なNightbreakパックの一括インストールヘルパー（コンテンツのみ） |
/fmm updatecontent | 古くなったNightbreakパックを一括更新するヘルパー |
/fmm downloadpluginupdate | 最新のプラグインjar更新のみをダウンロードします |
/fmm applypluginupdate | ダウンロード済みのプラグイン更新を、サーバーを再起動せずに適用します |
/fmm forcereinstallcontent <package|all> | バージョンが最新でも、既存コンテンツを再ダウンロードする修復用コマンド |
/nightbreaklogin [token] | 共通のNightbreakアカウントのリンク。サーバーを承認するためのリンクを表示するか、貼り付けたトークンを保存します。権限は nightbreak.login |
/nightbreaklogout | このサーバーに保存したNightbreakトークンを削除 |
config.yml が setupDone: false の間、freeminecraftmodels.* を持つプレイヤーは毎回のログインから約10秒後、まだオンラインなら案内を受け取ります。/fmm setup を開くと、サーバー全体で setupDone: true が保存され、以後の案内が止まります。案内には /fmm admin と /fmm も含まれます。/fmm initialize の選択肢を完了してもセットアップ済みになりますが、この値はパックの導入や配布の成功を示すものではありません。
/fmm setupのツールバーにはPetsボタンもあり、ペットモードを、装飾用のペットとより多くのクリーチャーの間で切り替え、その選択をpets.ymlに保存します。
推奨ワークフロー
- FreeMinecraftModelsをインストールして、一度サーバーを起動します。
/nightbreakloginでサーバーをNightbreakアカウントにリンクし、表示されるリンクで承認します。/fmm setupを開いて、利用可能なパックと現在の状態を確認します。- トークンでアクセス可能なすべての公式パックをインストールしたい場合は、
/fmm downloadallを使用します（これは最新のプラグインjar更新も取得します）。 - 後から古くなった公式パックをリフレッシュするには
/fmm updatecontentを使用します。 - 初期化の成功を待ち、生成された
output/FreeMinecraftModels.zipがプレイヤーに届くことを確認します。通常はResourcePackManager経由です。生成成功後、FMMは有効なResourcePackManagerに通知しますが、通知だけではクライアントへの配布成功を確認できません。
操作によるパッケージのダウンロードは、コンテンツ変更後にFMMを再読み込みします。ダウンロードしたプラグインjarは、再起動後に反映されるか、/fmm applypluginupdateですぐに反映されます。/fmm reload は再構築前に定義済みアイテム、エンチャント、プロップのレシピを検証します。検証で拒否された場合、現在のカタログは有効なままなので、ファイルが適用されたと思い込まず結果を確認してください。
サーバー自身に更新を取得させたい場合は、config.ymlでnightbreak.autoDownloadPluginUpdates: trueを設定します（デフォルトはfalse）。ダウンロードされたプラグインとコンテンツの更新は次回の再起動後に適用されます。再起動せずにプラグインの更新を適用するには、nightbreak.applyPluginUpdatesWithoutRestartをwhen-emptyまたはimmediatelyに設定します（デフォルトはnever）。設定を参照してください。
手動モデルインポート
直接モデルインポートは引き続き以下の経路で動作します：
plugins/FreeMinecraftModels/imports
このパスは以下の用途で引き続き有用です：
- ローカル開発
- Nightbreakから取得していないカスタムモデル
/fmm reloadを実行した際に、.bbmodelコンテンツを現在のランタイム形式へ変換すること
手動インポートと公式パッケージのダウンロードはどちらも、ランタイムモデルリストとリソースパックが再構築される前に、reload/importパスに依存することになります。
単体の .bbmodel は imports/ に直接置きます。この経路はモデルディレクトリに変換済み .fmmodel を書き込み、元のインポートファイルを残すため、後の再読み込みでも再変換されます。隣に置いた単体の .yml は一緒に取り込まれません。pack.meta がない通常のサブフォルダも再帰的には取り込まれません。設定やスクリプト付きモデルには、有効な models/ と scripts/ ディレクトリ、または正しく梱包されたアーカイブを使います。モデル作成上の注意を参照してください。
公式コンテンツパック
現在のプラグインには、Nightbreak管理の既製パッケージが5つ同梱されています：
Basic Furniture Pack（プロップ）BetterStructures Prop Pack（プロップ）EliteMobs Prop Pack（プロップ）Craftenmine's Weapons Item Pack（カスタムアイテム）Craftenmine Tools Item Pack（カスタムアイテム）
これらは /fmm setup に表示され、/fmm downloadall で一括ダウンロード、/fmm updatecontent で更新できます。Craftenmineの2つのアイテムパックは material: を設定したカスタムアイテムで、現在のアイテム定義とエンチャント形式を使います。装備アイテム用スクリプトを含む古いパックには更新されたコンテンツが必要です。
リソースパックに関するリマインダー
FreeMinecraftModelsは、何らかの方法で生成済みリソースパック出力をクライアントに届ける必要が常にあります。
現在の出力パスとResourcePackManagerとの統合については、リソースパック出力を参照してください。