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 米）——这会返回 "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

标记每一帧都会根据骨骼坐标进行投影，因此它们应该精确跟随 ped。

• 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 —— ped 被向左推的距离，以防止面板遮挡它。
• Fov —— 调低以减少变形，调高以在不拉远相机的情况下容纳更多身体部位。

Distance 和 Height 仅在 AutoFrame 为 false 时读取。

Text clips into the clothing

调高该身体部位 offset 的 z 值。该偏移量仅移动世界内的文字，不会影响面板。

Nobody else can see my annotation

• 他们必须在 Config.Text.ViewDistance（默认 6 米）的范围内。
• 如果开启了 Config.Text.OnlyWhileAiming，他们只有在按住瞄准键时才能看到。
• 备注通过 bupaStatuses 玩家 statebag 传输。如果有玩家在会话进行中加入却完全看不到任何内容，请检查 oxmysql 是否正在运行，并且服务器控制台没有显示数据库错误。

"Character data is not loaded yet"

服务器无法解析该玩家的 citizen id。在 QBox、QB-Core 和 ESX 上，这意味着角色尚未加载完成；资源会在 QBCore:Server:PlayerLoaded 和 esx:playerLoaded 时重新加载玩家的备注。

Annotations come back after a restart

这是设计使然 —— 它们存储在 MySQL 中并与角色的 citizen 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 中