FreeMinecraftModelsコマンド
/freeminecraftmodelsまたは/fmmを使用します。
セットアップとコンテンツ管理
| コマンド | 用途 |
|---|---|
/fmm | プレイヤー向けにクラフタブルアイテムメニューを開きます（下記のクラフタブルアイテムメニュー参照） |
/fmm admin | 管理者コンテンツブラウザを開きます。インストール済みパック、フォルダ、モデル、カスタムアイテムを閲覧できます（権限：freeminecraftmodels.admin） |
/fmm initialize | プレイヤー専用の初回セットアップフローを開きます |
/fmm setup | プレイヤー専用のコンテンツ管理メニューを開きます |
/fmm downloadall | 現在アクセス可能なすべての公式コンテンツをダウンロードします |
/fmm updatecontent | 古くなった公式コンテンツの更新をダウンロードします |
/fmm reload | コンテンツを再インポートし、パック出力を再生成します |
/fmm version | プラグインのバージョンを表示します（権限不要 -- 誰でも実行できます） |
/fmm stats | ロード済みモデルの統計を表示します |
モデルのスポーンと配置
| コマンド | 用途 |
|---|---|
/fmm spawn static <id> | 静的モデルをスポーンします |
/fmm spawn dynamic <id> | 動的モデルをスポーンします |
/fmm spawn prop <id> | 永続的なプロップエントリを作成し、スポーンします |
/fmm itemify <id> <material> | 選択したモデルをプロップとしてスポーンする配置可能アイテムを作成します |
/fmm mount <id> | ディスガイズされた馬を使った実験的な乗り物をスポーンします |
/fmm giveitem <item> | プレイヤーにカスタムFMMアイテムを付与します（権限：freeminecraftmodels.admin） |
/fmm craftify <id> | インタラクティブなレシピビルダーを開きます -- 3×3グリッドに素材を配置し、出力をクリックしてそのプロップのクラフトレシピを保存します |
プレイヤーディスガイズ
| コマンド | 用途 |
|---|---|
/fmm disguise <modelID> [player] | プレイヤーをロード済みモデルに変装させます。引数なしの場合は送信者を変装させます。対象を指定した場合はfreeminecraftmodels.disguise.othersが必要で、コンソールからも実行可能です |
/fmm undisguise [player] | 変装を解除します。引数なしの場合は送信者の変装を解除します。対象を指定した場合は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 [on|off] | Bedrockディスプレイパイプラインを診断する[FMM-BedrockDebug]ログストリームのランタイム切り替え。状態引数を省略すると現在ログが有効かどうかを報告します。プラグインリロード時は常にOFFにリセットされます -- 誤って有効のままにならないよう意図的に設定キーではありません。プレイヤーとコンソールの両方を受け付けます（権限：freeminecraftmodels.*） |
/fmm deleteall | 現在ロードされているすべてのモデル化エンティティを削除します |
プロップ配置の挙動
プレイヤーが紙のプロップアイテム（/fmm itemifyで作成、または/fmm craftifyレシピでクラフト）で右クリックすると、以下が適用されます：
- アイテム消費： プレイヤーがクリエイティブモードでない限り、プロップが設置されると紙アイテムは消費されます。
- 回転： プロップはプレイヤーの向いている方向に配置され、10度単位の回転に吸着します。これにより、プレイヤーは配置前に視線の方向を調整するだけで、プロップの向きを細かく制御できます。
クラフタブルアイテムメニュー
/fmmを引数なしで実行すると、レシピが設定されているすべてのクラフタブルアイテムを表示するインベントリメニューがプレイヤー向けに開きます。
- メニュー内の各アイテムはクラフタブルFMMアイテムを表します。
- アイテムをクリックすると、3x3クラフトグリッド、矢印、および出力アイテムを表示する詳細サブメニューが開き、クラフトテーブルでの作成方法が正確に示されます。
freeminecraftmodels.menu権限が必要（デフォルト：true、全プレイヤーが利用可能）。
管理者コンテンツブラウザ
/fmm adminを実行すると、サーバー管理者が以下を閲覧できるインベントリメニューが開きます：
- インストール済みコンテンツパック
- フォルダと個別のモデル
- カスタムアイテム（
material:が設定されたモデル）
freeminecraftmodels.admin権限が必要（デフォルト：op）。
レシピビルダー
/fmm craftifyコマンドを使うと、任意のプロップモデル用のバニラクラフトテーブルレシピを作成できます。
/fmm craftify <model_id>を実行してレシピビルダーUIを開きます。- 3×3クラフトグリッドと事前入力された出力アイテムを持つカスタムインベントリが開きます。
- 自分のインベントリから好きなパターンで素材をグリッドに配置します。
- 出力アイテム（プロップの紙アイテム）をクリックしてレシピを保存します。
- パーティクルとサウンドで保存が確認されます。
- レシピは
plugins/FreeMinecraftModels/recipes/<model_id>.ymlに保存され、即座に登録されます。 - プレイヤーは任意のクラフトテーブルでそのプロップアイテムをクラフトできるようになります。
- Escキーを押すと保存せずにキャンセル -- 素材はインベントリに戻されます。
- 同じモデルで再度craftifyを実行すると、以前のレシピが上書きされます。
- レシピはサーバー再起動とリロードを跨いで永続化されます。
保存されたレシピファイルには、/fmm shopへの露出を制御するshopEnabled（デフォルトtrue）およびshopPrice（デフォルトはshop_config.ymlから）フィールドが含まれます。
権限
plugin.ymlに登録されているもの
| 権限 | デフォルト | 説明 |
|---|---|---|
freeminecraftmodels.* | OP | freeminecraftmodels.admin、freeminecraftmodels.disguise.self、freeminecraftmodels.disguise.othersを付与するワイルドカード。このワイルドカード文字列はさらに、/fmm reload、/fmm stats、/fmm spawn、/fmm itemify、/fmm craftify、/fmm mount、/fmm hitbox visualize、/fmm debug bedrock、/fmm location、/fmm setup、/fmm initialize、/fmm downloadall、/fmm updatecontentに必要な文字どおりの権限でもあります |
freeminecraftmodels.admin | OP | /fmm admin（管理者コンテンツブラウザ）と/fmm giveitemへのアクセス |
freeminecraftmodels.disguise.self | OP | 送信者のみを対象とする/fmm disguiseおよび/fmm undisguiseを許可 |
freeminecraftmodels.disguise.others | OP | /fmm disguise <model> <player>、/fmm undisguise <player>、/fmm disguiselistを許可 |
freeminecraftmodels.menu | true | /fmmクラフタブルアイテムメニューへのアクセス（全プレイヤー利用可能） |
freeminecraftmodels.shop | true | /fmm shopへのアクセス（ショップ有効時に全プレイヤー利用可能） |
コマンドによって強制されるもの
| 権限 | デフォルト | 説明 |
|---|---|---|
freeminecraftmodels.deleteall | OP | /fmm deleteallへのアクセス（plugin.ymlには登録されず、実行時にチェック） |
initialize、setup、spawn、itemify、mount、giveitem、craftify、hitbox visualize、location、shopはプレイヤー専用コマンドです。disguiseとundisguiseは対象プレイヤーを受け付け、対象が指定されていればコンソールから実行できます。versionには権限制限がなく、誰でも（プレイヤーまたはコンソールで）実行できます。