FreeMinecraftModelsコマンド

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

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

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

コマンド	用途
/fmm	プレイヤー向けにクラフタブルアイテムメニューを開きます（下記のクラフタブルアイテムメニュー参照）
/fmm admin	管理者コンテンツブラウザを開きます。インストール済みパック、フォルダ、モデル、カスタムアイテムを閲覧できます（権限：freeminecraftmodels.admin）
/fmm setup	プレイヤー専用のコンテンツ管理／初回セットアップメニューを開きます（初回起動時にプレイヤーが案内されるコマンド）
/fmm recommendedplugins	FreeMinecraftModelsと相性の良いコンパニオンプラグインを表示します（プレイヤー向けにはカタログメニューを開き、コンソール向けには一覧を出力します）
/fmm downloadall	最新のプラグイン更新と利用可能なすべての公式コンテンツをダウンロードします。コンテンツが変更された場合、FMMはそれを適用するためにリロードします。ダウンロードされたプラグインjarは依然としてサーバーの再起動が必要です。Nightbreakトークンがない、または認証に失敗してプラグイン更新のステップが失敗した場合、コンテンツのステップは完全にスキップされます
/fmm downloadallcontent	利用可能なすべての公式コンテンツをダウンロードし（コンテンツのみ、プラグインjarの更新なし）、少なくとも1つのパッケージが変更されていればリロードします
/fmm updatecontent	古くなった公式コンテンツの更新をダウンロードし、少なくとも1つのパッケージが変更されていればリロードします（エイリアス：/fmm updateallcontent）
/fmm downloadpluginupdate	最新のプラグインjar更新のみをダウンロードします（次回のサーバー再起動後に適用されます）
/fmm forcereinstallcontent <package|all>	修復用コマンド。バージョン番号が最新だと示していても、すでに持っているコンテンツを再ダウンロードします。allに加えてすべてのNightbreakパッケージスラッグをタブ補完します。allはダウンロード済みと検出されたすべてのパッケージを対象とします。あるパックのファイルが完全に欠落している場合は、代わりにそのスラッグを直接指定してください。処理後にリロードします（権限：freeminecraftmodels.*）
/fmm reload	コンテンツを再インポートし、パック出力を再生成します
/fmm version	プラグインのバージョンを表示します（権限不要 -- 誰でも実行できます）
/fmm stats	ロード済みモデルの統計を表示します

共有Nightbreakコマンド

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

コマンド	用途
/nightbreaklogin <token>	このサーバー用の共有Nightbreakアカウントトークンを保存し、公式コンテンツのダウンロードとプラグイン更新を解放します（権限：nightbreak.login、デフォルト：op）。サーバーごとに1回だけ登録され、最初にロードされたNightbreakプラグインが所有権を持ちます
/nightbreaklogout	このサーバーに保存されているNightbreakアカウントトークンを消去します（権限：nightbreak.login、デフォルト：op）。プレイヤーとコンソールの両方を受け付けます
/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>	静的モデルをスポーンします
/fmm spawn dynamic <id>	動的モデルをスポーンします
/fmm spawn prop <id>	永続的なプロップエントリを作成し、スポーンします。同じモデルのプロップがそのブロック上に既にロードされている場合は A prop of that model already exists on this block. として拒否されます
/fmm itemify <id> <material>	選択したモデルをプロップとしてスポーンする配置可能アイテムを作成します
/fmm mount <id>	ディスガイズされた馬を使った実験的な乗り物をスポーンします
/fmm giveitem <item>	プレイヤーにカスタムFMMアイテムを付与します（権限：freeminecraftmodels.admin）
/fmm craftify <id>	インタラクティブなレシピビルダーを開きます -- 3×3グリッドに素材を配置し、出力をクリックしてそのプロップのクラフトレシピを保存します

プレイヤーディスガイズ

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

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

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

これらのいずれかが欠けている場合、/fmm shopは未登録のままになります（または実行時に強制無効化されている場合は、設定可能な「ショップ無効」メッセージを表示します）。ショップ設定キーおよびレシピごとのshopEnabled / shopPriceフィールドについては、設定を参照してください。

ユーティリティ

コマンド	用途
/fmm hitbox visualize [duration]	デバッグ用にヒットボックスを可視化します
/fmm location	診断コマンド -- LocationAPIに登録されているダンジョン検出器と保護プロバイダの数を報告し、現在地で両方の述語をテストします（権限：freeminecraftmodels.*）
/fmm debug <bedrock|props> [on|off]	FMMの診断ログストリームのランタイム切り替え。bedrockはBedrockディスプレイパイプラインを診断する[FMM-BedrockDebug]ストリームを切り替えます。propsはプロップの重なりスキャンを切り替え、有効にするとチャンクロードのたびに0.1ブロック以内にある2つのプロップをSTACKED PROPS DETECTEDとして報告します。状態引数を省略すると、変更せずに現在の状態を報告します。on/true/enable/enabledとoff/false/disable/disabledはいずれも受け付けられます。どちらの切り替えもプラグインリロード時に常にOFFにリセットされます -- 誤って有効のままにならないよう意図的に設定キーではありません。プレイヤーとコンソールの両方を受け付けます（権限：freeminecraftmodels.*）
/fmm packetdebug [ticks]	1回限りのパケット負荷診断。次の[ticks]モデルクロックティック（デフォルト1、上限200）の間、モデル化エンティティのパケットトラフィックをサンプリングし、論理パケット/ティック、ビューアーごとのファンアウトを含む実際に配信されたパケット/ティック、最悪の単一プレイヤー/ティック、パケット種別の内訳、最も負荷の重いビューアーを報告します。1、5、20、60をタブ補完します。負荷の高いエリアに立って実行してください。パケット数は正確ですが、バイト数は推定値です。サンプルが取得できなかった場合（モデル化エンティティが1つもロードされていない、またはNMSが無効）は警告とともにタイムアウトします。プレイヤーとコンソールの両方を受け付けます（権限：freeminecraftmodels.*）
/fmm deleteall [radius]	ロードされているすべてのモデル化エンティティと永続プロップを削除します。引数なしの場合はすべてをクリアします。オプションの[radius]（プレイヤー専用）を指定すると、プレイヤーからその数ブロック以内のエンティティに削除を限定します

プロップ配置の挙動

プレイヤーが紙のプロップアイテム（/fmm itemifyで作成、または/fmm craftifyレシピでクラフト）で右クリックすると、以下が適用されます：

• アイテム消費： プレイヤーがクリエイティブモードでない限り、プロップが設置されると紙アイテムは消費されます。
• 回転： プロップはプレイヤーの向いている方向に配置され、10度単位の回転に吸着します。これにより、プレイヤーは配置前に視線の方向を調整するだけで、プロップの向きを細かく制御できます。
• 1ブロックにつきモデルごとに1つ： 同じモデルのプロップが既にそのブロック上にロードされている場合、設置は A prop of that model already exists on this block. として拒否されます。拒否された設置ではアイテムは消費されません。
• メインハンドのみ： インタラクトイベントのメインハンド側でのみプロップが設置されるため、1回の右クリックで2つのプロップが生成されることはなくなりました。
• 重複のクリーンアップ： サーバー起動時とチャンクロードのたびに、FreeMinecraftModelsは同じモデルと同じブロックを共有するプロップのアーマースタンドを探し、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. パーティクルとサウンドで保存が確認されます。
6. レシピはplugins/FreeMinecraftModels/recipes/<model_id>.ymlに保存され、即座に登録されます。
7. プレイヤーは任意のクラフトテーブルでそのプロップアイテムをクラフトできるようになります。
8. Escキーを押すと保存せずにキャンセル -- 素材はインベントリに戻されます。
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は、自動的にベースのモデル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を再実行すると、ファイルが上書きされ、同じキーで再登録されます。

権限

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

権限	デフォルト	説明
freeminecraftmodels.*	OP	freeminecraftmodels.admin、freeminecraftmodels.deleteall、freeminecraftmodels.disguise.self、freeminecraftmodels.disguise.others、freeminecraftmodels.bypassregionprotectionを付与するワイルドカード。このワイルドカード文字列はさらに、/fmm reload、/fmm stats、/fmm spawn、/fmm itemify、/fmm craftify、/fmm mount、/fmm hitbox visualize、/fmm debug、/fmm packetdebug、/fmm location、/fmm setup, /fmm initialize、/fmm recommendedplugins、/fmm downloadall、/fmm downloadallcontent、/fmm updatecontent、/fmm downloadpluginupdate、/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が有効でも、他のプラグインが通常のブロック設置をブロックする場所でプロップの設置と操作を許可します
freeminecraftmodels.menu	true	/fmmクラフタブルアイテムメニューへのアクセス（全プレイヤー利用可能）
freeminecraftmodels.shop	true	/fmm shopへのアクセス（ショップ有効時に全プレイヤー利用可能）

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

MagmaCoreが登録するもの

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

送信者に関するメモ

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