Configuration

All options live in shared/config/general.lua.

Storage

shared/config/general.lua

Config.Storage = 'json'   -- 'json' writes data/zones.json | 'db' uses oxmysql

See Installation for the auto-created database table.

Anti-exploit limits

서버는 모든 저장 요청을 이 상한선과 대조하여 검증하며, 이를 초과하는 값은 거부하거나 제한합니다. 더 엄격한 서버 환경을 원하시면 값을 낮추세요.

shared/config/general.lua

Config.Limits = {
    maxZones     = 100,   -- 서버 내 전체 존 개수
    maxPoints    = 64,    -- 존당 포인트 개수
    maxJobs      = 40,    -- 존당 직업 개수
    maxWeapons   = 250,   -- 무기 허용/차단 목록의 항목 수
    maxLabelLen  = 64,    -- 존 이름의 최대 글자 수
    saveCooldown = 1000,  -- 플레이어별 저장 간 쿨다운 (ms)
}

Check interval

플레이어가 어떤 존 내부에 있는지 클라이언트가 재평가하는 주기 (ms)입니다.

shared/config/general.lua

Config.CheckInterval = 300

In-zone HUD

존 내부에 있을 때 나타나는 글래스 배지입니다. 표시 여부는 showHud 규칙에 따라 존마다 개별적으로 결정되며 — 이 설정은 오직 위치와 제목만 제어합니다.

shared/config/general.lua

Config.Hud = {
    -- 9가지 앵커 포인트 중 택 1:
    --   top-left     top-center     top-right
    --   middle-left  middle-center  middle-right
    --   bottom-left  bottom-center  bottom-right
    position = 'bottom-center',
    title    = nil,   -- nil = 존 고유의 이름 사용
}

Ground marker

groundMarker = true로 설정된 존이 활성화되어 있는 동안 그려집니다.

shared/config/general.lua

Config.Marker = {
    type = 1,
    size = { r = 60.0, g = 108.0, b = 240.0, a = 90 },
}

Enter / exit effects

개별 존 규칙 위에 얹혀지는 전역 연출로, 진입 및 퇴장 시 컬러 화면 플래시와 프론트엔드 사운드가 재생됩니다.

shared/config/general.lua

Config.Effects = {
    enabled    = true,
    flash      = true,                 -- NUI를 통한 컬러 화면 플래시
    sound      = true,                 -- 진입 / 퇴장 시 프론트엔드 빕 소리
    enterSound = 'CHECKPOINT_NORMAL',
    exitSound  = 'CANCEL',
}

Notifications

shared/config/general.lua

Config.NotifySystem = 'auto'   -- 'auto' | 'ox' | 'framework' | 'custom'

auto — 감지된 프레임워크의 알림을 사용합니다.
ox — ox_lib 알림을 강제로 사용합니다.
framework — 프레임워크 자체의 시스템을 사용합니다.
custom — client/editable.lua에서 커스텀 훅을 호출합니다.

Inventory (weapon list source)

무기 선택기는 인벤토리에서 직접 무기 목록과 실제 아이콘을 가져오므로, 플레이어는 가방에 가지고 있는 정확한 이미지를 볼 수 있습니다.

shared/config/general.lua

Config.Inventory         = 'auto'  -- 'auto' | 'ox' | 'qb' | 'esx' | 'tgiann' | 'codem'
Config.InventoryResource = nil     -- 리소스 이름을 변경한 경우 리소스 이름 오버라이드
Config.InventoryImagePath = nil    -- 이미지 기본 경로 오버라이드 (예: 'nui://my_inv/html/images/')

auto는 ox_inventory, qb-inventory, esx_inventory, tgiann-inventory 또는 codem-inventory를 자동으로 감지합니다. WEAPON_UNARMED는 항상 선택 가능합니다.

Default rules

Config.DefaultRules는 새로 생성되는 모든 존에 적용되는 규칙 세트입니다. 각 키가 수행하는 역할에 대해서는 Zone Rules를 참고하세요.

PreviousZone Rules Next Discord Logging