FreeMinecraftModels のセットアップ

FreeMinecraftModels は引き続き手动の .bbmodel インポートに対応していますが、現在のセットアップ手順は Nightbreak を前提としたメニュー駆動型です。

前提条件

• サーバーで Java 21 が利用できること
• FreeMinecraftModels をインストールし、一度起動してデータフォルダーを生成していること
• 生成されたリソースパックをプレイヤーへ配布する手段があること

ResourcePackManager は推奨される配布方法です。FreeMinecraftModels はパックを生成するだけで、自分では配信しません。

初回フロー

コマンド	目的
/fmm initialize	プレイヤー専用の初回セットアップメニュー
/fmm setup	プレイヤー専用のコンテンツ管理メニュー
/fmm downloadall	利用可能な Nightbreak パックをまとめて導入する補助コマンド
/fmm updatecontent	古くなった Nightbreak パックをまとめて更新する補助コマンド
/nightbreaklogin <token>	共通の Nightbreak トークン登録

config.yml にまだ setupDone: false が残っている場合、freeminecraftmodels.* を持つプレイヤーには /fmm initialize を実行するよう案内が表示されます。

推奨ワークフロー

1. FreeMinecraftModels をインストールし、サーバーを一度起動します。
2. /fmm initialize を実行します。
3. /nightbreaklogin <token> で Nightbreak トークンを連携します。
4. /fmm setup を開き、利用可能なパックと現在の状態を確認します。
5. トークンで利用できる公式パックをすべて導入したい場合は /fmm downloadall を使います。
6. 後で古くなった公式パックを更新するには /fmm updatecontent を使います。
7. 生成された output/FreeMinecraftModels.zip を、通常は ResourcePackManager 経由でプレイヤーに配布してください。

手動モデルインポート

直接インポートは次の場所を使って引き続き行えます:

plugins/FreeMinecraftModels/imports

このパスは次の用途で引き続き有効です:

• ローカル開発
• Nightbreak から取得しない独自モデル
• /fmm reload 実行時に .bbmodel コンテンツを現在のランタイム形式へ変換すること

手動インポートと公式パックのダウンロードは、どちらもランタイムのモデル一覧とリソースパックを再構築する前に、再読み込みまたはインポート処理を必要とします。

公式コンテンツパック

現在のプラグインには、Nightbreak 管理のプリメイドパックが 2 つ含まれています:

• BetterStructures Prop Pack
• EliteMobs Prop Pack

これらは /fmm setup に表示され、/fmm downloadall で一括ダウンロードでき、/fmm updatecontent で更新できます。

リソースパックに関する注意

FreeMinecraftModels では、生成されたリソースパック出力を何らかの方法で必ずクライアントへ届ける必要があります。

現在の出力パスと ResourcePackManager 連携については リソースパック出力 を参照してください。