Skip to content

Configuration

Configuration

서버 소유자가 수정해야 하는 모든 항목은 config.lua에 있으며, 파일은 섹션별로 주석 처리되어 있습니다. 권한, 기간 및 제한에 대해서는 Permissions & Duration에서 다루고 있으며, 웹훅은 별도의 페이지가 있습니다. 이 페이지에서는 나머지 부분을 다룹니다.

General

config.lua
Config.Command      = 'status'
Config.Keybind      = ''             -- 'F6', 'F7', 'INSERT'… 빈칸으로 두면 비활성화됩니다
Config.ClearCommand = 'statusclear'
Config.Debug        = false

In-world text

다른 플레이어들이 림(ped) 위에 떠 있는 것을 보는 텍스트입니다.

Option Default Purpose
Config.Text.ViewDistance 6.0 이 거리(미터)를 초과하면 아무것도 렌더링되지 않습니다.
Config.Text.ScanInterval 800 클라이언트가 메모를 소지한 주변 플레이어를 다시 스캔하는 주기(ms)입니다. 값이 높을수록 부하가 적지만 나타나는 속도가 느립니다.
Config.Text.Size 0.34 기본 크기 비율이며, 스크립트는 카메라 거리에도 비례하여 조절됩니다.
Config.Text.Font 4 GTA 폰트 ID — 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 관전자가 조준 키를 누르고 있을 때만 렌더링합니다.

Camera

패널은 투명한 인터페이스 위에 열리며 게임 카메라가 그 역할을 수행합니다.

Option Default Purpose
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 마우스 드래그 1픽셀당 림이 회전하는 각도입니다.
Config.Camera.FreezePlayer true 패널이 열려 있는 동안 림을 고정합니다.
Config.Camera.HideRadar true 패널이 열려 있는 동안 미니맵을 숨깁니다.
Config.Camera.HotspotRefresh 30 본(bone) 위치가 인터페이스로 전송되는 주기(ms)입니다. 사람이 매우 많은 서버에서는 50–60으로 높이세요.
ℹ

AutoFrame이 켜져 있으면 줌 제한은 ZoomMin / ZoomMax가 아닌 측정된 프레임을 기준으로 도출되므로, 림의 크기와 상관없이 버튼이 항상 적절하게 작동합니다.

Interface

config.lua
Config.UI = {
    Accent        = '#5b6cf0',  -- 모든 CSS 색상 가능
    Watermark     = true,       -- 캐릭터 뒤에 손으로 그린 듯한 "Status" 워터마크 표시
    ShowSeverity  = true,
    ShowTypes     = true,
    CloseOnEscape = true,
}

Types and severities

둘 다 단순한 목록입니다. 인터페이스는 입력한 내용에 맞춰 적응하며, 라벨은 로케일 파일에서 가져옵니다.

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> 줄이 필요합니다.

Body parts

기본적으로 16개의 부위가 제공되며, 각 부위는 GTA 림 본에 고정되어 있습니다.

config.lua
{ id = 'head', bone = 31086, offset = { x = 0.0, y = 0.0, z = 0.28 } },
Field Meaning
bone 주석이 고정될 림 본 인덱스입니다.
offset 모델 내부에 파묻히지 않도록 떠 있는 월드 내 텍스트를 본에서 살짝 떼어냅니다. 텍스트가 의상 안으로 파고들면 z 값을 높이세요. 클릭 가능한 마커는 이동시키지 않습니다.
marker 선택 사항입니다. 패널 내의 클릭 가능한 마커만 살짝 이동시킵니다. 생략하면 마커가 본 위치에 정확히 배치되며, 대부분의 경우 이 설정이 올바릅니다.

항목을 제거하면 해당 지역이 모든 곳에서 숨겨집니다. 항목을 추가하려면 유효한 본 인덱스와 모든 로케일 파일에 일치하는 bp_<id> 줄이 필요합니다.

Advanced

config.lua
Config.Table = 'bupa_syncstatus'  -- 첫 시작 시 자동으로 생성됩니다
⚠

config.lua 하단에 있는 조회 테이블(Config.BodyPartMap, Config.TypeMap, Config.SeverityMap)은 시작 시 위의 목록을 기반으로 빌드됩니다. 수동으로 수정하지 마세요.

PreviousPermissions & DurationNext Discord Logging