Troubleshooting

/status 12 каже, що мені заборонено

Перевірка медика виконується на сервері та завершується помилкою з однієї з чотирьох причин:

• Ваша робота відсутня в 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 працюють однаково — вони видаляють лише те, що дозволено видаляти ініціатору, і зберігають заблоковані записи.

Маркери не тримаються на тілі

Маркери проєктуються з координат кісток кожного кадру, тому вони мають точно слідувати за педом.

• offset у Config.BodyParts навмисно не застосовується до маркерів — він існує для того, щоб підняти плаваючий у світі текст над тілом. Якщо застосувати його до маркерів, кожна точка зміщуватиметься вгору.
• Щоб змістити маркер певної зони, додайте опціональний параметр marker = { x = 0.0, y = 0.0, z = 0.04 } лише для цієї частини тіла.
• Якщо на завантаженому сервері маркери здаються лагаючими, ваш інструмент налаштування — Config.Camera.HotspotRefresh (інтервал оновлення в мілісекундах, тому вище значення означає менше навантаження, але меншу плавність).

Персонаж обрізаний, крихітний або зміщений від центру

Залиште Config.Camera.AutoFrame = true та натомість відрегулюйте наступне:

• Fill — яку частину висоти екрана займає тіло. Зменшіть цей параметр, якщо персонаж здається затисненим.
• VerticalNudge — додатні значення переміщують персонажа вниз по екрану, від'ємні — вгору.
• SideOffset — наскільки далеко пед зміщується вліво, щоб панель його не закривала.
• Fov — менше значення зменшує спотворення, більше — дозволяє вмістити більшу частину тіла без віддалення камери.

Distance та Height зчитуються лише тоді, коли AutoFrame має значення false.

Текст накладається на одяг

Збільште значення z для offset цієї частини тіла. Цей зсув переміщує лише текст у світі і не впливає на панель.

Ніхто інший не бачить моєї позначки

• Вони мають знаходитися в межах Config.Text.ViewDistance (за замовчуванням 6 м).
• Якщо Config.Text.OnlyWhileAiming увімкнено, вони бачать її лише під час утримання клавіші прицілювання.
• Позначки передаються через стейтбег гравця bupaStatuses. Якщо гравець приєднався посеред сесії і взагалі нічого не бачить, переконайтеся, що oxmysql запущено і в консолі сервера немає помилок бази даних.

"Character data is not loaded yet"

Сервер не зміг визначити citizen id для цього гравця. На QBox, QB-Core та ESX це означає, що персонаж ще не завершив завантаження; ресурс перезавантажує позначки гравця за подіями QBCore:Server:PlayerLoaded та esx:playerLoaded.

Позначки повертаються після перезапуску

Це передбачено — вони зберігаються в MySQL прив'язаними до citizen id персонажа та перезавантажуються під час запуску. Прострочені позначки видаляються фоновим потоком очищення, який запускається кожні Config.Duration.CleanupInterval секунд (мінімум 10).

"Slow down a moment"

Config.Limits.WriteCooldown (за замовчуванням 2 секунди) — це інтервал захисту від спаму між записами. Встановіть його на 0, щоб вимкнути.

Інші обмеження, з якими ви можете зіткнутися

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