Конфігурація

Усе, що призначено для налаштування власником сервера, знаходиться у файлі config.lua, який має коментарі до кожного розділу. Права доступу, тривалість та ліміти описані в розділі Permissions & Duration; вебхук має власну сторінку. На цій сторінці розглядається решта налаштувань.

Загальні

config.lua

Config.Command      = 'status'
Config.Keybind      = ''             -- 'F6', 'F7', 'INSERT'… порожньо означає вимкнено
Config.ClearCommand = 'statusclear'
Config.Debug        = false

Текст у світі

Те, що інші гравці бачать над педом у вигляді плаваючого тексту.

Опараметр	За замовчуванням	Призначення
`Config.Text.ViewDistance`	`6.0`	Нічого не відображається далі цієї відстані в метрах.
`Config.Text.ScanInterval`	`800`	Як часто (мс) клієнт повторно сканує навколишніх гравців з нотатками. Вище значення – економніше, але текст з'являється повільніше.
`Config.Text.Size`	`0.34`	Базовий масштаб; скрипт також адаптується залежно від відстані камери.
`Config.Text.Font`	`4`	ID шрифту GTA — 0 chalet, 1 sign, 2 slab, 4 chalet comprime, 7 pricedown.
`Config.Text.Outline`	`true`	Темна обводка навколо тексту для забезпечення читабельності на будь-якій поверхні.
`Config.Text.MinScale` / `MaxScale`	`0.10` / `0.58`	Обмеження, щоб текст ніколи не ставав нечитабельним або комічно великим.
`Config.Text.Alpha`	`225`	Непрозорість тексту, 0–255.
`Config.Text.ColorBySeverity`	`true`	Фарбувати текст у колір ступеня тяжкості. `false` = завжди білий.
`Config.Text.White`	`255, 255, 255`	Колір, що використовується, коли фарбування за тяжкістю вимкнене або невідоме.
`Config.Text.OnlyWhileAiming`	`false`	Відображати лише тоді, коли спостерігач утримує клавішу прицілювання.

Камера

Панель відкривається поверх прозорого інтерфейсу, а всю роботу виконуєгрова камера.

Опараметр	За замовчуванням	Призначення
`Config.Camera.AutoFrame`	`true`	Вимірює педа від голови до ніг і автоматично кадрує його. Рекомендується — працює з будь-якою моделлю педа.
`Config.Camera.Fill`	`0.88`	Яку частину висоти екрана заповнює тіло, коли увімкнено `AutoFrame`.
`Config.Camera.VerticalNudge`	`0.0`	Тонке налаштування в метрах. Додатні значення зміщують персонажа вниз по екрану.
`Config.Camera.Distance`	`3.35`	Відстань до педа — використовується лише тоді, коли `AutoFrame` має значення `false`.
`Config.Camera.Height`	`0.95`	Висота, на яку дивиться камера — використовується лише тоді, коли `AutoFrame` має значення `false`.
`Config.Camera.SideOffset`	`0.45`	Зсуває педа вліво, щоб панель ніколи його не закривала. `0` центрує його.
`Config.Camera.Fov`	`34.0`	Менше значення створює ефект портретного об'єктива з меншими спотвореннями.
`Config.Camera.ZoomMin` / `ZoomMax` / `ZoomStep`	`1.60` / `4.60` / `0.20`	Ліміти масштабування та крок при натисканні кнопки.
`Config.Camera.RotateSensitivity`	`0.6`	Градуси, на які повертається пед за один піксель перетягування миші.
`Config.Camera.FreezePlayer`	`true`	Заморозити педа під час відкриття панелі.
`Config.Camera.HideRadar`	`true`	Приховати мінікарту під час відкриття панелі.
`Config.Camera.HotspotRefresh`	`30`	Як часто (мс) позиції кісток передаються в інтерфейс. Збільште до 50–60 на дуже завантажених серверах.

ℹ

Коли AutoFrame увімкнено, межі масштабування обчислюються на основі виміряного кадрування, а не з ZoomMin / ZoomMax, тому кнопки завжди працюють коректно незалежно від розміру педа.

Інтерфейс

config.lua

Config.UI = {
    Accent        = '#5b6cf0',  -- будь-який колір CSS
    Watermark     = true,       -- намальований від руки водяний знак "Status" за персонажем
    ShowSeverity  = true,
    ShowTypes     = true,
    CloseOnEscape = true,
}

Типи та ступені тяжкості

Обидва є звичайними списками. Інтерфейс адаптується до всього, що ви туди додасте; назви беруться з файлів локалізації.

config.lua

Config.Types = {
    { id = 'injury',  icon = 'activity' },  -- назва: type_injury
    { id = 'bandage', icon = 'plus'     },
    { id = 'note',    icon = 'message'  },
}

Config.Severities = {
    { id = 'minor',    color = { r = 143, g = 214, b = 171 } },
    { id = 'moderate', color = { r = 195, g = 201, b = 209 } },
    { id = 'severe',   color = { r = 255, g = 154, b = 157 } },
}

icon — це назва іконки Lucide, яку відображає інтерфейс. Додавання нового запису вимагає наявності відповідного рядка type_<id> або sev_<id> у кожному файлі локалізації.

Частини тіла

За замовчуванням доступно шістнадцять зон, кожна з яких прикріплена до певної кістки педа GTA.

config.lua

{ id = 'head', bone = 31086, offset = { x = 0.0, y = 0.0, z = 0.28 } },

Поле	Значення
`bone`	Індекс кістки педа, до якої прив'язана анотація.
`offset`	Зсуває плаваючий текст у світі від кістки, щоб він не опинявся всередині моделі. Звеличуйте `z`, якщо текст просідає крізь одяг. Це не переміщує клікабельний маркер.
`marker`	Необов'язково. Зсуває клікабельний маркер лише всередині панелі. Якщо залишити порожнім, маркер розміститься точно на кістці, що є правильним у майже всіх випадках.

Видалення запису приховує цю зону скрізь. Додавання нового вимагає дійсного індексу кістки та відповідного рядка bp_<id> у кожному файлі локалізації.

Додатково

{% code title="

PreviousPermissions & Duration Next Discord Logging