FreeMinecraftModels FAQ
ここに記載されていない質問がある場合は、サイドバーを確認して、Wikiに専用ページがないか 確認してください！
はじめに
FreeMinecraftModelsのインストール方法と使い方は？
情報
インストール：
- FreeMinecraftModels.jarをダウンロードしてpluginsフォルダに配置します
- サーバーを再起動してプラグインフォルダを生成します
- 初回セットアップフローを使用したい場合は
/fmm initializeを実行します - 公式コンテンツパックを使用する場合は
/nightbreaklogin <token>でNightbreakを連携します - 公式Nightbreak管理コンテンツには
/fmm setupまたは/fmm downloadallを使用します - 手動コンテンツの場合は
.bbmodelファイルを~/plugins/FreeMinecraftModels/imports/に配置し、/fmm reloadを実行します - 生成されたリソースパックは
~/plugins/FreeMinecraftModels/output/FreeMinecraftModels.zipにあります
リソースパックの配布：
以下のいずれかの方法を選択してください：
- オプションA（推奨）：自動配布のためにResource Pack Managerをインストール
- オプションB：server.propertiesまたはホスティングサービスを介して手動で設定
モデルのスポーン：
/fmm spawn static <id>- 一時的な装飾モデルをスポーン/fmm spawn dynamic <id>- エンティティに紐付けられたモデルをスポーン/fmm spawn prop <id>- 永続的なワールドモデルをスポーン
管理：
/fmm- セットアップ/ヘルプのサマリーを表示/fmm initialize- 初回セットアップメニューを開く/fmm setup- コンテンツ管理メニューを開く/fmm downloadall- アクセス可能なすべての公式コンテンツをダウンロード/fmm updatecontent- 古い公式コンテンツを更新/fmm reload- プラグインをリロードし新しいモデルを変換/fmm version- プラグインバージョンを表示/fmm stats- エンティティ数の統計を表示
プレイヤー機能：
/fmm disguise <modelID>- 外見をカスタムモデルに変身/fmm undisguise- プレイヤーの変装を解除し通常の外見に戻す/fmm itemify <model> <material>- 指定したモデルをスポーンする配置可能アイテムを作成/fmm craftify <modelID>- プロップのクラフトレシピを作成するインタラクティブなレシピビルダーを開く/fmm mount <modelID>- カスタムモデルに変装した騎乗可能な馬をスポーン（実験的）
デバッグ：
/fmm hitbox visualize [duration]- パーティクルを使用してモデルのヒットボックスを可視化（durationはティック単位、デフォルト100）
管理者：
/fmm deleteall- 現在ロードされているすべてのモデルエンティティを削除（注意 - 確認プロンプトなし）
権限：
freeminecraftmodels.*- ほとんどのコマンドに必要（disguise、itemify、mount、hitbox visualize、spawn）freeminecraftmodels.deleteall-/fmm deleteallコマンドに必要
コマンドはデフォルトでOP限定です。必要に応じてOP以外のプレイヤーにこれらの権限を付与してください。
モデルの機能と制限
モデルのサイズと回転の制限は？
情報
サイズ制限：
- 最大：112x112x112ピクセル（ゲーム内7x7x7ブロック）
- FreeMinecraftModelsはこれらのサイズを実現するために4倍の内部スケーリングを使用します
- 標準のMinecraftリソースパックはより小さいサイズに制限されています
キューブ回転制限：
- 許可される角度：0°、±22.5°、±45°および22.5°の倍数（v2.3.0以降）
- 単軸回転のみ
- 例：[22.5, 0, 0]は動作しますが、[22.5, 0, 45]は部分的にしか回転しません
- その他の角度は正しく表示されません
ボーン回転：
- ボーンは任意の回転角度をサポートします
- デフォルトの静止位置として90°、-90°、180°、-180°を避けてください（予期しない動作の原因になる場合があります）
- 多軸回転をサポートします
- 各ボーンが個別のエンティティを作成します（パフォーマンスへの影響を考慮）
パフォーマンスに関する注意：
ボーン数はできるだけ少なくしてください。各ボーンはMinecraft内で個別のエンティティをスポーンするため、大規模な場合にサーバーパフォーマンスに影響を与える可能性があります。
サポートされているアニメーションは？
情報
FreeMinecraftModelsは以下のデフォルト状態アニメーションをサポートしています：
標準アニメーション：
- Walk
- Idle
- Death
- Attack
- Spawn
仕組み：
- BlockBenchでアニメーションを作成します
- プラグインが.bbmodelファイルからアニメーションキーフレームを読み取ります
- アニメーションはエンティティの状態に基づいて自動的にトリガーされます
- 開発者は
playAnimation(animationName, false, false)を使用してプログラム的にアニメーションをトリガーできます
特殊なケース：
EvokerエンティティはAttackアニメーションを自動的にトリガーするために、近くのEvoker Fangsを検出します。
仮想ボーンとは何ですか？どのように機能しますか？
情報
仮想ボーンは、モデルに機能を追加する予約名を持つ特殊なボーンです：
ヒットボックスボーン：
- 名前：
hitbox - インタラクションゾーンとコリジョンボックスを作成します
- 一致するx/z値でエンティティの境界を定義します
ネームタグボーン：
- プレフィックス：
tag_ - モデルの上にテキストを表示します
- エンティティの名前付けに使用されます
頭部回転ボーン：
- プレフィックス：
h_ - プレイヤー/エンティティの頭の位置に基づいて回転します
- 頭の動きを自動的に追跡します
使い方：
BlockBenchでこれらの特殊な名前のいずれかを持つボーンを作成すると、プラグインが対応する機能を自動的に適用します。
トラブルシューティングFAQ
カスタムモデルの代わりに馬の鎧しか表示されません。
情報
ゲーム内でカスタムモデルの代わりに馬の鎧しか表示されない場合、FMMリソースパックが既存のリソースパックと正しくマージされていない可能性が最も高いです。
MagmaGuyは、リソースパックを自動的にマージできるResource Pack Manager (RSPM)というプラグインを開発しました。Spigotからこちらでダウンロードできます。
RSPM .jarファイルをpluginsフォルダにドロップするだけで、RSPMがすべてを処理します。すべてのリソースパックをマージし、自動ホスティングし、プレイヤーがサーバーにログインする際に配布します。
.bbmodelファイルを追加した後、モデルが表示されないのはなぜですか？
情報
モデルが表示されない場合は、以下の一般的な問題を確認してください：
1. リロードを忘れた
importsフォルダに.bbmodelファイルを配置した後、/fmm reloadを実行してください。これによりモデルが変換され、リソースパックが生成されます。
2. リソースパックが適用されていない
プレイヤーはモデルを見るためにFMMリソースパックをアクティブにしている必要があります。
- 生成されたパックは
~/plugins/FreeMinecraftModels/output/FreeMinecraftModels.zipを確認してください - 自動配布のためにResource Pack Managerをインストールしてください
- または、server.propertiesやホスティングサービスを介して手動で配布してください
3. ファイルの配置場所が間違っている
手動インポート用の.bbmodelファイルは以下に配置する必要があります：~/plugins/FreeMinecraftModels/imports/
公式コンテンツパックを使用している場合は、手動でファイルを配置する代わりに/fmm setupまたは/fmm downloadallを使用してください。
4. モデルにエラーがある
/fmm reload実行時にコンソールログでエラーメッセージを確認してください。サポートされていない回転、大きすぎるモデル、テクスチャの問題などが一般的です。
5. リソースパックのマージの問題
モデルの代わりに馬の鎧が表示される場合、リソースパックが正しくマージされていません。Resource Pack Manager (RSPM)を使用してマージを自動的に処理してください。
ViaVersionによりリソースパックが正しく表示されない場合があります。
情報
ViaVersionはリソースパックに問題を引き起こす可能性があります。特に1.21.4より低いバージョンでサーバーを実行している場合です。Minecraftは1.21.4からリソースパックの処理方法に変更を導入しました。1.21.3のようなバージョンでサーバーを実行し、ViaVersionを使用して1.21.4クライアントの接続を許可している場合、これらのクライアントはFMM（FreeMinecraftModels）のカスタムモデルなど、特定のリソースパックコンテンツの表示に問題が発生する可能性があります。
これは、Minecraftのリソースパックシステムが1.21.4アップデートで変更されたために発生します。
注意： これはFreeMinecraftModels固有の問題ではなく、MinecraftとViaVersionの制限です。ViaVersionのプロトコル変換は、1.21.4より前のサーバーバージョンで実行している場合、リソースパックの変更を完全にサポートしない場合があります。
これを解決するには、サーバーを1.21.4以上に更新することを検討してください。これにより、FMMカスタムモデルを含む最新のリソースパック機能との互換性が向上します。
モデルがラグやパフォーマンスの問題を引き起こすのはなぜですか？
情報
BlockBenchモデルの各ボーンはMinecraft内で個別のエンティティを作成します。多くのボーンを持つモデルはサーバーパフォーマンスに影響を与える可能性があります。
最適化のヒント：
- モデル内のボーン数を最小限にする
- スポーンするモデルの数を制限する
- アニメーションが不要な場合はDynamicモデルの代わりにStaticモデルの使用を検討する
- ボーン数の多いモデルを互いに近くにスポーンすることを避ける
技術的な説明：
FreeMinecraftModelsは各ボーンを個別のMinecraftエンティティとしてレンダリングします。50ボーンのモデルは50のエンティティをスポーンします。大規模な場合、これはパフォーマンスに影響します。
ベストプラクティス：
- より少ないボーンでモデルを設計する
- 現実的なスポーン数でパフォーマンスをテストする
- 新しいモデルを追加する際にサーバーTPSを監視する
高度な機能
Resource Pack Manager (RSPM)は必要ですか？
情報
Resource Pack Manager (RSPM)はオプションですが強く推奨されます。
RSPMの機能：
- 複数のプラグインからのリソースパックを自動的にマージ
- リソースパックをホスティング（外部ホスティング不要）
- ログイン時にプレイヤーにパックを自動配布
- 手動のリソースパック設定を不要に
RSPMなしの場合：
手動で以下を行う必要があります：
- FMMリソースパックを既存のサーバーリソースパックとマージ
- マージされたパックを外部サービスまたはserver.propertiesでホスティング
- サーバーがプレイヤーにパックを送信するよう設定
- 新しいモデルを追加するたびにパックを更新
RSPMを使う理由：
「モデルの代わりに馬の鎧が表示される」問題のほとんどは、リソースパックのマージが不適切なことが原因です。RSPMはこれを自動的に処理します。
RSPMのダウンロード：https://www.spigotmc.org/resources/resource-pack-manager.118574/
FreeMinecraftModelsと同じ作者であるMagmaGuyが開発しています。
自分のプラグインでFreeMinecraftModelsを使用できますか？
情報
はい、FreeMinecraftModelsは開発者向けのAPIを提供しています。
Maven/Gradle統合：
リポジトリ：https://repo.magmaguy.com/releases
アーティファクト：
- GroupId：
com.magmaguy - ArtifactId：
FreeMinecraftModels - Scope：
provided（サーバーにインストールが必要、シェードしないでください）
主要なAPIクラス：
ModeledEntity（基底クラス）StaticEntityDynamicEntityPropEntity
使用例：
StaticEntity staticEntity = StaticEntity.create(id, location);
if (staticEntity == null) {
Bukkit.getLogger().warning("Failed to create model");
return;
}
staticEntity.setRightClickCallback(...);
staticEntity.remove();
重要：
FreeMinecraftModelsをプラグインにシェードしないでください。サーバーに別途インストールする必要があります。
詳細なAPIドキュメントについては、公式READMEを参照してください。
プレイヤーをカスタムモデルに変装させるにはどうすればよいですか？
情報
/fmm disguiseコマンドでプレイヤーの外見を任意のカスタムモデルに変身させることができます。
コマンド：
/fmm disguise <modelID>
仕組み：
- 他のプレイヤーからプレイヤーを透明にします
- プレイヤーの位置にカスタムモデルをオーバーレイします
- モデルがプレイヤーの動きに追従します
- ロールプレイサーバーや特別なイベントに最適です
例：
/fmm disguise dragon
変装を解除するには：
/fmm undisguise
要件：
- 権限：
freeminecraftmodels.* - modelIDはmodelsフォルダ内の有効な変換済みモデルである必要があります
注意事項：
- プレイヤーのヒットボックスは変更されません（同じコリジョンボックス）
- 他のプレイヤーにはプレイヤースキンの代わりにカスタムモデルが表示されます
- 透明化効果は変装解除まで永続します
配置可能なモデルアイテムを作成するにはどうすればよいですか？
情報
/fmm itemifyコマンドで、プレイヤーがワールドにモデルを配置するために使用できる特殊なアイテムを作成できます。
コマンド：
/fmm itemify <model> <material>
パラメータ：
model- modelsフォルダの任意の有効なモデルIDmaterial- 任意のMinecraftマテリアル（STICK、PAPER、DIAMONDなど）
例：
/fmm itemify lamp_post STICK
作成されるもの：
- フォーマットされた金の装飾付き表示名を持つカスタムアイテム（例：「✦ Wolf ✦」）
- アイテムを説明する説明テキスト
- アイテムはインベントリに直接追加されます
- 右クリックでモデルをプロップとして配置
ユースケース：
- プレイヤーに建築装飾用のアイテムを提供
- 家具用のカスタム「スポーンエッグ」を作成
- 建築権限を与えずにモデルを配布
- クリエイティブ建築用のセットアップキット
要件：
- 権限：
freeminecraftmodels.* - プレイヤーがゲーム内にいる必要があります（コンソール不可）
モデルのヒットボックスをデバッグするにはどうすればよいですか？
情報
/fmm hitbox visualizeコマンドでパーティクルを使用してモデルのヒットボックスを可視化できます。
コマンド：
/fmm hitbox visualize [duration]
パラメータ：
duration（オプション） - ヒットボックスを表示する時間（ティック単位、デフォルト：100、最大：1200）- 20ティック = 1秒
例：
/fmm hitbox visualize # 5秒間表示
/fmm hitbox visualize 200 # 10秒間表示
仕組み：
- 10ブロック以内のモデルを検索します
- 指向性バウンディングボックス（OBB）の境界をパーティクルで表示します
- モデルとそのコリジョン境界の両方を表示します
- ヒットボックスのサイズと回転の確認に役立ちます
使用タイミング：
- ヒットボックスがビジュアルモデルと一致しているかテストする場合
- インタラクションの問題をデバッグする場合
- ヒットボックスの回転を確認する場合
- クリック検出のトラブルシューティング
要件：
- 権限：
freeminecraftmodels.*
注意： FMMのヒットボックスは、標準のMinecraft AABBとは異なり、モデルと一緒に回転します。
騎乗可能なカスタムモデルを作成できますか？
情報
はい、/fmm mountコマンドで騎乗可能なカスタムモデルを作成できます（実験的機能）。
コマンド：
/fmm mount <modelID>
動作：
- あなたの位置に馬をスポーンします
- 馬をカスタムモデルに変装させます
- 馬を自動的に手なずけてサドルを追加します
- すぐに馬に乗ります
例：
/fmm mount dragon
要件：
- 権限：
freeminecraftmodels.* - 有効なモデルID
重要な注意事項：
- この機能は実験的としてマークされています
- 移動速度と動作は標準の馬と同じです
- 馬のヒットボックスは変更されません
- マウント用に設計されたモデルで最も効果的です
ユースケース：
- ロールプレイサーバー用のカスタムマウント
- VIPプレイヤー用の特別な乗り物
- アドベンチャーマップ用のユニークな騎乗可能クリーチャー