Troubleshooting

/status 12 says I am not allowed

The medic check runs on the server and fails for one of four reasons:

• あなたのジョブが Config.Permissions.EditOthers に含まれていないか、リストが空です（空の場合、他のプレイヤーの調査機能が完全に無効化されます）。
• ジョブのグレードが Config.Permissions.MinGrade を下回っています。
• ターゲットとの距離が Config.Permissions.MaxDistance（デフォルト 3 m）より離れています。これが原因の場合、"You are too far away." が返されます。
• ACE権限を使用する設定にしているにもかかわらず、Config.Permissions.UseAce が false のままになっています。

"You cannot remove it before it expires"

その注記は医療従事者によって追加されたものであり、Config.Permissions.LockStaffNotes が有効になっています。タイマーが終了すると自動的に消去されます。Config.Permissions.StaffCanRemoveLocked が true に設定されている場合に限り、権限を持つジョブが早期に削除することができます。

Clear all および /statusclear も同様の動作をします。これらは実行者が削除を許可されているもののみを削除し、ロックされたエントリは保持します。

The markers do not sit on the body

マーカーは毎フレーム、ボーン座標から投影されるため、ペッド（キャラクター）に正確に追従する仕様になっています。

• Config.BodyParts 内の offset は、意図的にマーカーに適用されません。これは、ワールド内に浮遊するテキストを体から持ち上げるために存在します。もしマーカーに適用してしまうと、すべてのドットが上方にズレてしまいます。
• 特定の部位のマーカーを微調整したい場合は、その部位の定義にオプションの marker = { x = 0.0, y = 0.0, z = 0.04 } を追加してください。
• 負荷の高いサーバーでマーカーの動作がカクついて見える場合は、Config.Camera.HotspotRefresh で調整できます。これはミリ秒単位の更新間隔であるため、値を大きくするほど負荷は軽減されますが、動きの滑らかさは失われます。

The character is cropped, tiny or off-centre

Config.Camera.AutoFrame = true のまま、以下の設定を調整してください：

• Fill — 画面の高さに対して体が占める割合です。キャラクターが窮屈に感じる場合は下げてください。
• VerticalNudge — 正の値でキャラクターが画面の下方へ移動し、負の値で上方へ移動します。
• SideOffset — パネルがキャラクターを隠さないよう、ペッドを左側にどれだけ押し出すかの距離です。
• Fov — カメラを後ろに下げずに体の大部分を表示したい場合は高くし、歪みを抑えたい場合は低くします。

Distance と Height は、AutoFrame が false の場合にのみ読み込まれます。

Text clips into the clothing

該当する身体部位の offset の z 値を上げてください。このオフセットはワールド内テキストのみを移動させるものであり、パネルには影響しません。

Nobody else can see my annotation

• 他のプレイヤーが Config.Text.ViewDistance（デフォルト 6 m）の範囲内にいる必要があります。
• Config.Text.OnlyWhileAiming が有効な場合、エイムキー長押し中のみ表示されます。
• 注記は bupaStatuses プレイヤーstatebagを介して送信されます。セッションの途中で参加したプレイヤーが何も見えない場合は、oxmysql が稼働しており、サーバーコンソールにデータベースエラーが表示されていないことを確認してください。

"Character data is not loaded yet"

サーバーがそのプレイヤーのシチズンIDを特定できませんでした。QBox、QB-Core、ESXにおいて、これはキャラクターの読み込みが完了していないことを意味します。リソースは QBCore:Server:PlayerLoaded および esx:playerLoaded のタイミングでプレイヤーの注記を再読み込みします。

Annotations come back after a restart

これは仕様です。注記はMySQLにキャラクターのシチズンIDと紐付けて保存され、起動時に再読み込みされます。期限切れの注記は、Config.Duration.CleanupInterval 秒ごと（最小 10 秒）に実行されるクリーンアップスレッドによって削除されます。

"Slow down a moment"

Config.Limits.WriteCooldown（デフォルト 2 秒）は、書き込み間隔のスパム防止（クールダウン）です。無効にするには 0 に設定してください。

Other limits you may be hitting

Message	Cause
Annotation limit reached	Config.Limits.MaxPerPlayer（デフォルト 4）
That body region already has an annotation	Config.Limits.OnePerBodyPart が true
Please write a valid annotation	<、>、~ を除外してトリミングした結果、テキストが空でした
Invalid body region	身体部位のIDが Config.BodyParts に存在しません