FreeMinecraftModelsコマンド

config.yml の registerCraftingRecipes は既定で true です。購入専用にする場合は false にして再起動してください。有効で正常な項目はショップに残りますが、Bukkit のクラフトとプレイヤー用 /fmm クラフトメニューからは削除されます。このページのクラフト手順には true が必要です。

/freeminecraftmodelsまたは/fmmを使用します。

セットアップとコンテンツ管理

コマンド	用途
/fmm	プレイヤー向けにクラフタブルアイテムメニューを開きます（下記のクラフタブルアイテムメニュー参照）
/fmm admin	管理者コンテンツブラウザを開きます。インストール済みパック、フォルダ、モデル、カスタムアイテムを閲覧できます（権限：freeminecraftmodels.admin）
/fmm setup	プレイヤー専用のコンテンツ管理／初回セットアップメニューを開きます（初回起動時にプレイヤーが案内されるコマンド）
/fmm recommendedplugins	FreeMinecraftModelsと相性の良いコンパニオンプラグインを表示します（プレイヤー向けにはカタログメニューを開き、コンソール向けには一覧を出力します）
/fmm downloadall	最新のプラグイン更新と利用可能なすべての公式コンテンツをダウンロードします。コンテンツが変更された場合、FMMはそれを適用するためにリロードします。ダウンロードされたプラグインjarは、再起動後、/fmm applypluginupdateの実行後、またはnightbreak.applyPluginUpdatesWithoutRestartの設定に従って反映されます。Nightbreakトークンがない、または認証に失敗してプラグイン更新のステップが失敗した場合、コンテンツのステップは完全にスキップされます
/fmm downloadallcontent	利用可能なすべての公式コンテンツをダウンロードし（コンテンツのみ、プラグインjarの更新なし）、少なくとも1つのパッケージが変更されていればリロードします
/fmm updatecontent	古くなった公式コンテンツの更新をダウンロードし、少なくとも1つのパッケージが変更されていればリロードします（エイリアス：/fmm updateallcontent）
/fmm downloadpluginupdate	最新のプラグインjar更新のみをダウンロードします。/fmm applypluginupdateを実行するかnightbreak.applyPluginUpdatesWithoutRestartを設定しない限り、次回の再起動後に反映されます
/fmm applypluginupdate	ダウンロード済みのプラグイン更新を、サーバーを再起動せずに適用します。FMMと、それにdependまたはsoftdependしている有効なすべてのMagmaGuyプラグインが無効化され、jarが置き換えられた後、再度読み込まれて有効化されます。より新しい更新が待機していない場合や、他の作者のプラグインがFMMに依存している場合は拒否されます。新しいjarの有効化に失敗した場合は以前のjarが再度読み込まれ、更新は次回の再起動まで待機状態のまま残ります。プレイヤーとコンソールの両方を受け付けます（権限：freeminecraftmodels.*）
/fmm forcereinstallcontent <package|all>	修復用コマンド。バージョン番号が最新だと示していても、すでに持っているコンテンツを再ダウンロードします。allに加えてすべてのNightbreakパッケージスラッグをタブ補完します。allはダウンロード済みと検出されたすべてのパッケージを対象とします。あるパックのファイルが完全に欠落している場合は、代わりにそのスラッグを直接指定してください。処理後にリロードします（権限：freeminecraftmodels.*）
/fmm reload	定義済みアイテム、エンチャント、プロップのレシピをインポートして検証し、成功した場合に設定、レシピ、モデル、パック出力をすべて再初期化します。検証に失敗すると、現在のカタログを維持したままリロードを拒否することがあります
/fmm version	プラグインのバージョンを表示します（権限不要 -- 誰でも実行できます）
/fmm stats	ロード済みモデルの統計を表示します

共有Nightbreakコマンド

これらはFreeMinecraftModels自身ではなくMagmaCoreによって登録されるため、/fmmのサブコマンドではなくトップレベルコマンドです。

コマンド	用途
/nightbreaklogin [token]	このサーバーをNightbreakアカウントにリンクし、公式コンテンツのダウンロードとプラグイン更新を解放します。トークンなしの場合は承認用のnightbreak.ioのリンクを表示し、トークンありの場合はそのトークンを保存します（権限：nightbreak.login、デフォルト：op）。サーバーごとに1回だけ登録され、最初にロードされたNightbreakプラグインが所有権を持ちます
/nightbreaklogout	このサーバーに保存されているNightbreakアカウントトークンを消去します（権限：nightbreak.login、デフォルト：op）。プレイヤーとコンソールの両方を受け付けます
/nightbreak plugins	Nightbreak のプラグインカタログを、プレイヤーにはメニューとして、コンソールにはチャットの一覧として表示します（権限：nightbreak.plugins、デフォルト：op）。/nightbreaklogin と同様に、サーバーごとに1回だけ登録されます。Nightbreakのセットアップとコンテンツ管理を参照してください
/freeminecraftmodelschangelog [dismiss|disable]	未読のFreeMinecraftModelsリリースノート（プラグインリリースと追跡中のコンテンツパッケージ）を表示します。dismissは現在表示中のノートを既読にし、disableは自分向けの変更履歴リマインダーを恒久的に非表示にします。プレイヤー専用かつ管理者専用で、プレイヤーにはfreeminecraftmodels.*、セットアップ／管理者権限のいずれか、またはOPが必要です。他のプラグインがすでに/freeminecraftmodelschangelogというラベルを所有している場合、コマンドは/freeminecraftmodels:freeminecraftmodelschangelogのような名前空間付きのフォールバックで登録されます

未読のリリースノートがある管理者は、参加時にクリック可能な[VIEW CHANGELOG]プロンプトでチャットに通知されます。ダイジェスト表示には、上記2つのサブコマンドと同じ動作をするDismiss These UpdatesおよびNever Show Changelogsボタンがあります。プレイヤーごとの既読状態はplugins/FreeMinecraftModels/nightbreak-changelogs.ymlに保存されます。

モデルのスポーンと配置

コマンド	用途
/fmm spawn static <id>	最大300ブロックのレイトレースで狙ったブロックの上に静的モデルをスポーンします
/fmm spawn dynamic <id>	同じ300ブロックのレイトレースで狙ったブロックの上に、非表示のブタに載せたモデルをスポーンします
/fmm spawn prop <id>	プレイヤーの現在位置に永続プロップをスポーンします。同じモデルのプロップがそのブロック上に既にロードされている場合は A prop of that model already exists on this block. として拒否されます
/fmm itemify <id> <material>	指定した Bukkit マテリアルの配置アイテムを作成します。PAPER など大文字の列挙名を指定してください。モデルのプロップ .ymlにnameとloreが設定されていれば、アイテムはそれを引き継ぎます。定義済みの手持ちアイテムを作るコマンドではありません
/fmm mount <id> [scale]	実験的な騎乗用の乗り物をスポーンします。モデルをまとった、飼いならされた鞍付きの馬で、あなたが乗って操縦します。任意のscaleは0より大きく16以下で、馬とそのモデルのサイズを決めます。タブ補完では1.0、2.0、3.0が候補に出ます。騎乗可能なカスタムモデルを参照してください
/fmm giveitem <item>	登録済みの定義済み FMM アイテムをプレイヤーに付与します。アイテム ID の大文字と小文字は区別しません（権限：freeminecraftmodels.admin）
/fmm craftify <id>	インタラクティブなレシピビルダーを開きます -- 3×3グリッドに素材を配置し、出力をクリックしてそのプロップのクラフトレシピを保存します

直接スポーンするコマンドでは、配置アイテムの保護チェックや空きスペースの確認を実行しません。itemify と giveitem の実行時はインベントリに空きを用意してください。これらのコマンドは入りきらないアイテムをドロップせず、余剰分を無視します。

プレイヤーディスガイズ

コマンド	用途
/fmm disguise <modelID> [player]	プレイヤーをロード済みモデルに変装させます。引数なしの場合は送信者を変装させます。対象を指定した場合はfreeminecraftmodels.disguise.self + freeminecraftmodels.disguise.othersが必要で、コンソールからも実行可能です
/fmm undisguise [player]	変装を解除します。引数なしの場合は送信者の変装を解除します。対象を指定した場合はfreeminecraftmodels.disguise.self + freeminecraftmodels.disguise.othersが必要で、コンソールからも実行可能です
/fmm disguiselist	現在変装中のプレイヤーと、それぞれが変装しているモデルを一覧表示します（権限：freeminecraftmodels.disguise.others）

ディスガイズの挙動：

• ディスガイズすると、そのプレイヤーの以前のディスガイズはクリーンに置き換えられます。
• ディスガイズされたプレイヤーとその装備は、他のプレイヤーから見えなくなります。ディスガイズが透明化効果を追加した場合は、ミルク、効果の除去、リスポーン後にその効果を復元します。ディスガイズ前から存在する透明化効果は、この仕組みで管理・復元されません。
• サードパーティプラグインは公開DisguiseAPI経由でディスガイズを駆動できます（API＆開発者ガイド参照）。

ペット

コマンド	用途
/fmm pets	ペットメニューを開きます。ここでペットを連れて行ったり、家に帰したりできます（権限：freeminecraftmodels.pets）
/fmm petadmin mode [creatures|cosmetic]	ペットモードを表示します。指定した場合は切り替えてpets.ymlに保存します（権限：freeminecraftmodels.pets.admin）
/fmm petadmin list	読み込まれているペットの種族を、ファイル、モデル、ボディ、手懐け用のエサ、繁殖用のエサとともに一覧表示します（権限：freeminecraftmodels.pets.admin）
/fmm petadmin spawn <species>	見ているブロックの上（最大12ブロック先）に、その種族の野生のペットをスポーンします。CREATURESモードでのみ機能します（権限：freeminecraftmodels.pets.admin）
/fmm petadmin give <species>	その種族の成体を、自分のペットコレクションに追加します（権限：freeminecraftmodels.pets.admin）
/fmm petmigrate [species]	時刻や空の状態に関係なく、今すぐ夜の渡りの群れを自分の頭上に飛ばします（権限：freeminecraftmodels.pets.admin）

種族ファイル、pets.yml、2つのペットモードについては、ペットを参照してください。

家具ショップ

コマンド	用途
/fmm shop	オプションのVault対応家具ショップを開きます。プレイヤーがゲーム内通貨でクラフタブルプロップを購入できます（権限：freeminecraftmodels.shop、デフォルト：true）

ショップはデフォルトで無効であり、以下が満たされた場合のみ自身を登録します：

• shop_config.ymlでenabled: true
• Vaultがインストールされている
• Vault互換のエコノミープロバイダが登録されている

これらのいずれかが欠けている場合、/fmm shop は登録されません。ショップを有効にしても Vault またはエコノミー連携がない場合は警告が記録されます。登録済みのハンドラーは、設定またはキャッシュされた連携状態が無効なら設定済みの無効メッセージを返せますが、プロバイダーの削除を継続的に検出するわけではありません。ショップ設定キーおよびレシピごとの shopEnabled / shopPrice フィールドについては、設定を参照してください。

ユーティリティ

コマンド	用途
/fmm hitbox visualize [duration]	同じワールド内で10ブロック未満の距離にあるモデルのヒットボックスを可視化し、土台のエンティティも表示します。時間はティック数で、既定値は 100（5秒）です。0以下または数値でない値は 100、1200 を超える値は 1200 になります
/fmm location	登録済みのダンジョン検出器と保護プロバイダーを報告し、現在地の is_in_dungeon / is_protected を照会します。この位置判定は、プレイヤーを考慮するプロップ配置権限チェックとは異なります（権限：freeminecraftmodels.*）
/fmm debug <bedrock|props> [on|off]	[FMM-BedrockDebug] ログ、またはクリーンアップ時に0.1ブロック以内のプロップ対を検出する STACKED PROPS DETECTED スキャンを切り替えます。状態を省略すると、そのフラグがオンかどうかを報告します。true/enable/enabled と false/disable/disabled も使用できます。プレイヤーとコンソールの両方に対応します（権限：freeminecraftmodels.*）
/fmm packetdebug [ticks]	指定したモデルクロックのティック数だけモデル化エンティティのパケット通信を計測します。既定値は 1 で、値は 1～200 に制限され、整数として無効なら 1 になります。論理パケット数と配信パケット数/ティック、閲覧者への配信倍率、最も負荷の高いプレイヤー/ティック、パケット種別、負荷の高い閲覧者を報告します。1、5、20、60 をタブ補完します。問題のある場所で実行してください。計測対象の通信のパケット数は正確ですが、バイト数は推定値です。同時に実行できる計測は1つだけです。400サーバーティックの間、新しいサンプルが届かなければ警告します。プレイヤーとコンソールの両方に対応します（権限：freeminecraftmodels.*）
/fmm filmic [on|off]	ReplayModで動画を録画するために、フィルミックモードを一時的にオンまたはオフにします。オンにすると、すべてのプレイヤーが、視界外であっても自分の読み込み済みチャンクにあるすべてのロード済みモデルを受信し、モデルはアニメーションし続けます。録画以外での使用はおすすめしません： 帯域幅とサーバー性能を大きく消費します。config.ymlを編集することはなく、設定はサーバーの再起動まで、またはconfig.ymlのfilmicModeを変更してFMMをリロードするまで続きます。引数なしで実行すると、現在の状態と、それがコマンドとconfig.ymlのどちらに由来するかを報告します。プレイヤーとコンソールの両方に対応します（権限：freeminecraftmodels.*）
/fmm boneglide [ticks]	Java クライアントが、乗っているモデルのボーンを次のポーズへ滑らかに動かすのにかけるティック数であるriddenBoneInterpolationTicksを、一時的に設定します。0ならスナップします。0～59を受け付け、0～3をタブ補完します。引数なしで実行すると、現在の値を報告します。config.ymlを編集することはなく、FMM がリロードされるとconfig.ymlの値に戻ります。プレイヤーとコンソールの両方に対応します（権限：freeminecraftmodels.*）
/fmm deleteall [radius]	全ワールドの現在ロード済みのモデル化エンティティを削除し、ロード済みプロップを永続的に削除します。未ロードのプロップは走査しません。正の整数で半径を指定できるのはプレイヤーだけで、そのプレイヤーのワールドと距離内に対象を限定します

デバッグフラグはディスクに保存されませんが、/fmm reload でもリセットされません。調査後は明示的にオフにしてください。サーバーを新たに起動すると、両方ともオフで初期化されます。

プロップ配置の挙動

プレイヤーが itemify、クラフト、ショップで入手したモデル配置アイテムで右クリックすると、以下が適用されます。定義済みの手持ちアイテムは、このハンドラーの対象外です。

• アイテム消費： 配置に成功すると1個消費されます。クリエイティブモードでは消費されません。
• 配置先： ブロックをクリックした場合は、操作イベントのブロックと面を使用します。空中をクリックした場合は最大5ブロックまでレイトレースします。自由配置のプロップは面の中心を、ボクセル化したプロップは隣接ブロックとグリッドに沿った占有範囲を使用します。
• 回転： 単にプレイヤーの視線の向きに合わせるのではなく、配置点からプレイヤーの位置に向けます。自由配置は10度刻み、ボクセル配置は90度刻みです。
• 1ブロックにつきモデルごとに1つ： 同じモデルのプロップが既にそのブロック上にロードされている場合、設置は A prop of that model already exists on this block. として拒否されます。拒否された設置ではアイテムは消費されません。
• メインハンドとクールダウン： メインハンドの操作だけが配置を行います。後で検証に失敗する試行も含め、配置の試行には500ミリ秒のクールダウンがあります。
• 保護と空きスペース： 設定された保護照会は隣接セルを確認します。ボクセル化したプロップは、さらに回転後の占有範囲全体の空きスペースと保護を確認します。バイパス権限は保護照会を省略します。連携と衝突範囲の制約は設定を参照してください。
• 重複のクリーンアップ： 起動時、エンティティのロード時、プロップを直接スポーンする前に、FMM は同じモデルとブロックを共有するプロップのスタンドを探し、1つを残して他を削除します。削除は [FMM Props] Removed N duplicate prop armor stand(s) ... として記録されます。

クラフタブルアイテムメニュー

/fmm を引数なしで実行すると、実際にクラフトレシピが登録されているロード済みモデルを表示する、プレイヤー用のインベントリメニューが開きます。

• メニュー内の各アイテムはクラフタブルFMMアイテムを表します。
• アイテムをクリックすると、3x3クラフトグリッド、矢印、および出力アイテムを表示する詳細サブメニューが開き、クラフトテーブルでの作成方法が正確に示されます。
• freeminecraftmodels.menu権限が必要（デフォルト：true、全プレイヤーが利用可能）。

管理者コンテンツブラウザ

/fmm adminを実行すると、サーバー管理者が以下を閲覧できるインベントリメニューが開きます：

• インストール済みコンテンツパック
• フォルダと個別のモデル
• カスタムアイテム（material:が設定されたモデル）

freeminecraftmodels.admin権限が必要（デフォルト：op）。

レシピビルダー

/fmm craftifyコマンドを使うと、任意のプロップモデル用のバニラクラフトテーブルレシピを作成できます。

1. /fmm craftify <model_id>を実行してレシピビルダーUIを開きます。
2. 3×3クラフトグリッドと事前入力された出力アイテムを持つカスタムインベントリが開きます。
3. 自分のインベントリから好きなパターンで素材をグリッドに配置します。
4. 出力アイテム（プロップの紙アイテム）をクリックしてレシピを保存します。
5. 保存に成功するとパーティクル、音、成功メッセージが表示されます。保存や登録に失敗した場合はメニューが開いたままになり、素材はグリッドに残り、エラーが表示されます。FMMは以前の登録済みレシピの復元を試みます。復元にも失敗した場合はコンソールを確認してください。
6. レシピは plugins/FreeMinecraftModels/recipes/<model_id>.yml に保存されます。Bukkit への登録は registerCraftingRecipes に依存します。
7. 登録に成功し、クラフトが有効であれば、プレイヤーは作業台で紙のプロップアイテムを作れます。
8. 保存前に Escape を押すとキャンセルして素材を返し、入りきらない分は足元にドロップします。保存するとグリッド内の素材スタック全体が消去されます。レシピに記録されるのはマテリアルと配置パターンだけで、個数やアイテムのメタデータは含まれません。
9. 同じモデルで再び craftify を実行すると、以前のレシピを置き換え、有効状態やショップの項目を価格も含めて既定値に戻します。
10. レシピはサーバー再起動とリロードを跨いで永続化されます。

レシピファイル形式

isEnabled: true
model_id: "wooden_chair"
shape:
  - "L L"
  - "LLL"
  - "L L"
ingredients:
  L: OAK_LOG
shopEnabled: true
shopPrice: 250.0

フィールド	必須	備考
isEnabled	いいえ（デフォルトtrue）	ファイルを削除せずにレシピの登録を解除するにはfalseに設定します
model_id	はい	クラフトした紙アイテムが配置するモデル。弓／クロスボウの状態サフィックスは、ベースのディスプレイモデルが登録されている場合にだけベースのモデル ID に解決されます
shape	はい	最大3行、各行最大3文字。スペースは「空きスロット」を意味します
ingredients	はい	shapeの1文字とBukkitマテリアル名の対応表。認識されないマテリアルは警告なしに破棄されます
shopEnabled	いいえ（デフォルトtrue）	そのレシピを/fmm shopに掲載するかどうか
shopPrice	いいえ（デフォルトはshop_config.ymlのdefaultPrice）	ショップでのVault通貨での価格

Bukkit のレシピキーは freeminecraftmodels:prop_recipe_<model_id> です。出力は常にモデルの紙製配置アイテムで、マテリアルやエンチャントを持つ定義済みの手持ちアイテムではありません。/fmm craftify を再実行するとファイルを置き換え、クラフトが有効なら同じキーで登録を試みます。

FMMはrecipes/以下のすべての.ymlをサブフォルダも含めて読み込み、1つのカタログとして扱います。各model_idに有効なレシピファイルは1つしか持てません。同じmodel_idに対する2つ目の有効なファイルや、YAMLの構文エラーがあるファイルがあると、/fmm reloadは現在のレシピを維持したまま拒否され、実行者にコンソールを確認するよう案内します。起動時には、同じ問題が起きてもレシピカタログだけが拒否されます。FMMは起動を完了しますが、ファイルを修正して/fmm reloadを実行するまで、プロップレシピと家具ショップのエントリは利用できません。コンソールでProp recipe catalog rejected、Duplicate recipe modelまたはCannot prepare prop recipesを確認してください。

権限

plugin.ymlに登録されているもの

権限	デフォルト	説明
freeminecraftmodels.*	OP	freeminecraftmodels.admin、freeminecraftmodels.deleteall、freeminecraftmodels.disguise.self、freeminecraftmodels.disguise.others、freeminecraftmodels.bypassregionprotection、freeminecraftmodels.pets.adminを付与するワイルドカード。このワイルドカード文字列はさらに、/fmm reload、/fmm stats、/fmm spawn、/fmm itemify、/fmm craftify、/fmm mount、/fmm hitbox visualize、/fmm debug、/fmm packetdebug、/fmm filmic、/fmm boneglide、/fmm location、/fmm setup、/fmm initialize、/fmm recommendedplugins、/fmm downloadall、/fmm downloadallcontent、/fmm updatecontent、/fmm downloadpluginupdate、/fmm applypluginupdate、/fmm forcereinstallcontentに必要な文字どおりの権限でもあります
freeminecraftmodels.admin	OP	/fmm admin（管理者コンテンツブラウザ）と/fmm giveitemへのアクセス
freeminecraftmodels.deleteall	OP	ワイルドカードの子。/fmm deleteallへのアクセス
freeminecraftmodels.disguise.self	OP	送信者のみを対象とする/fmm disguiseおよび/fmm undisguiseを許可
freeminecraftmodels.disguise.others	OP	/fmm disguise <model> <player>、/fmm undisguise <player>、/fmm disguiselistを許可
freeminecraftmodels.bypassregionprotection	OP	preventPropPlacementInProtectedRegionsを含む、FMMのプロップ設置・操作に関する保護問い合わせを省略します。空きスペースの確認は引き続き適用されます
freeminecraftmodels.menu	true	/fmmクラフタブルアイテムメニューへのアクセス（全プレイヤー利用可能）
freeminecraftmodels.shop	true	/fmm shopへのアクセス（ショップ有効時に全プレイヤー利用可能）

対象プレイヤーを指定する disguise と undisguise には、freeminecraftmodels.disguise.self と freeminecraftmodels.disguise.others の両方が必要です。disguiselist は .others のみを必要とします。

ペットの権限

権限	デフォルト	説明
freeminecraftmodels.pets	true	/fmm petsへのアクセス（全プレイヤー利用可能）
freeminecraftmodels.pets.admin	OP	ワイルドカードの子。/fmm petadminと/fmm petmigrateへのアクセス

MagmaCoreが登録するもの

権限	デフォルト	説明
nightbreak.login	OP	共有コマンド/nightbreakloginおよび/nightbreaklogoutに必要です。最初にロードされたNightbreakプラグインによって、サーバーごとに1回だけ登録されます
nightbreak.plugins	OP	共有コマンド/nightbreak pluginsに必要です。最初にロードされたNightbreakプラグインによって、サーバーごとに1回だけ登録されます

送信者に関するメモ

• initialize、setup、spawn、itemify、mount、giveitem、craftify、hitbox visualize、location、admin、shop、pets、petadmin、petmigrateはプレイヤー専用コマンドです。/freeminecraftmodelschangelogもプレイヤー専用です。
• reload、stats、recommendedplugins、downloadall、downloadallcontent、updatecontent、downloadpluginupdate、applypluginupdate、forcereinstallcontent、packetdebug、debug、filmic、boneglide、deleteall、/nightbreaklogin、/nightbreaklogout、/nightbreak pluginsはプレイヤーとコンソールの両方を受け付けます（deleteallの半径指定はプレイヤー専用です）。
• disguiseとundisguiseは対象プレイヤーを受け付け、対象が指定されていればコンソールから実行できます。
• versionには権限制限がなく、誰でも（プレイヤーまたはコンソールで）実行できます。
• /fmm initialize は freeminecraftmodels.* 権限を持つプレイヤーの初回セットアップメニューを開きます。日常のコンテンツ管理には /fmm setup を使用します。