Troubleshooting

トラブルシューティング

起動時に完全なチェックパイプラインが実行されます。いずれかのチェックに失敗すると、理由を説明する通知が表示されます。以下の項目を確認してください：

権限 (Permission) — Config.Permission.Enabled = true の場合、プレイヤーが条件を満たしているか確認します。Type = 'ace' の場合は、add_ace で ACE (animpos.use) が付与されていることを確認してください。Type = 'job' の場合は、プレイヤーのジョブが Config.Permission.Jobs に含まれていることを確認してください。
状態の制限 (State restriction) — 車両内、落下中/パラシュート中、水泳中（有効な場合）、死亡時、ラストスタンド状態、または手錠をかけられている間はブロックされます。通知によってどの状態であるかが示されます。このブロックが不要な場合は、関連する Config.Restrictions フラグを調整してください。
クールダウン (Cooldown) — 使用後には Config.Cooldown（デフォルト15秒）の待機時間があります。「Too fast! Please wait a moment.」と表示された場合は、まだクールダウンが有効であることを意味します。
CanUseフック — カスタムの Config.CanUse が false を返すと、オープンがブロックされます。そこにカスタムロジックがないか確認してください。

これはほぼ確実にバックエンドの不一致が原因です。Config.Notify は、実際に稼働している通知システムと一致している必要があります：

ox_lib — ox_libの起動が必要です（ox_libに設定されているにもかかわらずox_libが実行されていない場合、コンソールに警告が表示されます）。
qbcore — QB-Coreとその QBCore:Notify イベントが必要です。
esx — ESXとその esx:showNotification イベントが必要です。
custom — Config.CustomNotify 内で動作するハンドラーが必要です。

無効な値が指定された場合は ox_lib にフォールバックし、コンソールに警告が記録されます。

Config.Keybind.Enabled = true かつ Config.Keybind.Default が空でないことを確認してください。キーマッピングは両方が設定されている場合のみ登録されます。
キーマッピングはリソース起動時に登録されます。設定を変更した場合は、リソースを再起動してください。
プレイヤーが「設定 (Settings)」→「キー割り当て (Key Bindings)」→「FiveM」でキーを再割り当て（またはクリア）していないか確認してください。コマンド /animpos はキーバインドに関係なく常に機能します。

server.cfg で setr ox:locale "<code>" を設定してください（クライアントに同期させるため setr を使用してください）。
サポートされているコードを使用してください: en, tr, de, fr, es, pt, ru。
翻訳キーが見つからない場合は英語にフォールバックします。ロケールファイルに en.json とまったく同じ名前のキーが存在することを確認してください。

サーバーに完全一致するように Config.Framework を設定してください（qbox, qbcore, esx, または standalone）。無効な値が指定された場合はコンソールに警告が記録されます。
死亡 / ラストスタンド / 手錠の制限は、qbox および qbcore でのみ機能します。esx および standalone では、これらのメタデータチェックは仕様によりスキップされ、車両 / 落下 / 水泳のみが適用されます。
QBox/QB-Coreでメタデータの制限が依然としてトリガーされない場合、お使いのフレームワークがそれらのフィールドを異なるキーで保存している可能性があります。Config.Restrictions.MetaKeys を調整してください。

スクリプトはリソース停止時にアルファ値をクリアし、ペドのフリーズを解除してラグドールを復元するため、bupa-animpos を再起動することでフリーズ状態を解消できます。外部連携によってペドのスケール変更が一時停止されたままになった場合も、クリーンアップ時に再開エクスポートが呼び出されます。