FreeMinecraftModelsのセットアップ
FreeMinecraftModelsは引き続き手動の.bbmodelインポートをサポートしていますが、現在のセットアップフローはNightbreak対応かつメニュー駆動です。
前提条件
- サーバー用のJava 21ランタイム
- FreeMinecraftModelsをインストールし、一度起動してデータフォルダを生成しておく
- 生成されたリソースパックをプレイヤーに配布する手段
ResourcePackManagerは推奨の配布経路です。FreeMinecraftModelsはパックを生成するだけで、自分自身ではホスティングしないからです。
初回フロー
| コマンド | 用途 |
|---|---|
/fmm setup | プレイヤー専用のコンテンツ管理／初回オンボーディングメニュー（初回起動時にプレイヤーが案内されるコマンド） |
/fmm recommendedplugins | FreeMinecraftModelsと相性の良いコンパニオンプラグインを表示します |
/fmm downloadall | 一括インストールヘルパー：最新のプラグイン更新とアクセス可能なすべてのNightbreakパックをダウンロードします |
/fmm downloadallcontent | アクセス可能なNightbreakパックの一括インストールヘルパー（コンテンツのみ） |
/fmm updatecontent | 古くなったNightbreakパックを一括更新するヘルパー |
/fmm downloadpluginupdate | 最新のプラグインjar更新のみをダウンロードします |
/nightbreaklogin <token> | 共通のNightbreakトークン登録 |
config.ymlにまだsetupDone: falseが残っている場合、freeminecraftmodels.*を持つプレイヤーは/fmm setupを案内する一度きりのログインリマインダーを受け取ります（メニューを開くとメッセージは恒久的に消えます）。このリマインダーは/fmm adminと/fmmも併せて案内します。
推奨ワークフロー
- FreeMinecraftModelsをインストールして、一度サーバーを起動します。
/nightbreaklogin <token>でNightbreakトークンをリンクします。/fmm setupを開いて、利用可能なパックと現在の状態を確認します。- トークンでアクセス可能なすべての公式パックをインストールしたい場合は、
/fmm downloadallを使用します（これは最新のプラグインjar更新も取得します）。 - 後から古くなった公式パックをリフレッシュするには
/fmm updatecontentを使用します。 - 生成された
output/FreeMinecraftModels.zipパックがプレイヤーに届くようにします。通常はResourcePackManager経由です。
サーバー自身に更新を取得させたい場合は、config.ymlでnightbreak.autoDownloadPluginUpdates: trueを設定します（デフォルトはfalse）。ダウンロードされたプラグインとコンテンツの更新は次回の再起動後に適用されます。設定を参照してください。
手動モデルインポート
直接モデルインポートは引き続き以下の経路で動作します：
plugins/FreeMinecraftModels/imports
このパスは以下の用途で引き続き有用です：
- ローカル開発
- Nightbreakから取得していないカスタムモデル
/fmm reloadを実行した際に、.bbmodelコンテンツを現在のランタイム形式へ変換すること
手動インポートと公式パッケージのダウンロードはどちらも、ランタイムモデルリストとリソースパックが再構築される前に、reload/importパスに依存することになります。
公式コンテンツパック
現在のプラグインには、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:が設定されたモデル）であり、Luaアイテムスクリプトの対象となります。
リソースパックに関するリマインダー
FreeMinecraftModelsは、何らかの方法で生成済みリソースパック出力をクライアントに届ける必要が常にあります。
現在の出力パスとResourcePackManagerとの統合については、リソースパック出力を参照してください。