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を実行するようログイン時のリマインダーを受け取ります。
推奨ワークフロー
- FreeMinecraftModelsをインストールして、一度サーバーを起動します。
/fmm initializeを実行します。/nightbreaklogin <token>でNightbreakトークンをリンクします。/fmm setupを開いて、利用可能なパックと現在の状態を確認します。- トークンでアクセス可能なすべての公式パックをインストールしたい場合は、
/fmm downloadallを使用します。 - 後から古くなった公式パックをリフレッシュするには
/fmm updatecontentを使用します。 - 生成された
output/FreeMinecraftModels.zipパックがプレイヤーに届くようにします。通常はResourcePackManager経由です。
手動モデルインポート
直接モデルインポートは引き続き以下の経路で動作します：
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との統合については、リソースパック出力を参照してください。