Skip to content

Configuration

設定

すべてのオプションは shared/config/general.lua 内に存在します。

ストレージ

shared/config/general.lua
Config.Storage = 'json'   -- 'json' は data/zones.json に書き込みます | 'db' は oxmysql を使用します

自動作成されるデータベーステーブルについては、Installation を参照してください。

アンチエクスプロイト制限

サーバーはすべての保存データをこれらの上限に対して検証し、それを超えるものはすべて拒否またはクランプします。より厳格なサーバーにするには、数値を下げてください。

shared/config/general.lua
Config.Limits = {
    maxZones     = 100,   -- サーバー上の合計ゾーン数
    maxPoints    = 64,    -- 1ゾーンあたりのポイント数
    maxJobs      = 40,    -- 1ゾーンあたりのジョブ数
    maxWeapons   = 250,   -- 武器許可/ブロックリストのエントリ数
    maxLabelLen  = 64,    -- ゾーン名の最大文字数
    saveCooldown = 1000,  -- プレイヤーごとの保存間のミリ秒（ms）
}

チェック間隔

プレイヤーがどのゾーン内にいるかをクライアントが再評価する頻度（ミリ秒）。

shared/config/general.lua
Config.CheckInterval = 300

ゾーン内 HUD

ゾーン内にいるときに表示されるグラスバッジ。表示されるかどうかは、showHud ルールによってゾーンごとに決定されます。これは配置場所とそのタイトルのみを制御します。

shared/config/general.lua
Config.Hud = {
    -- 9つのアンカーポイントのいずれか:
    --   top-left     top-center     top-right
    --   middle-left  middle-center  middle-right
    --   bottom-left  bottom-center  bottom-right
    position = 'bottom-center',
    title    = nil,   -- nil = ゾーン自身の名前を使用する
}

グランドマーカー

groundMarker = true が設定されたゾーンがアクティブな間に描画されます。

shared/config/general.lua
Config.Marker = {
    type = 1,
    size = { r = 60.0, g = 108.0, b = 240.0, a = 90 },
}

入退室エフェクト

ゾーンごとのルールに重ねて適用されるグローバルな演出。入退室時の色付き画面フラッシュとフロントエンドサウンドです。

shared/config/general.lua
Config.Effects = {
    enabled    = true,
    flash      = true,                 -- NUIによる色付きの画面フラッシュ
    sound      = true,                 -- 入退室時のフロントエンドのブリップ音
    enterSound = 'CHECKPOINT_NORMAL',
    exitSound  = 'CANCEL',
}

通知

shared/config/general.lua
Config.NotifySystem = 'auto'   -- 'auto' | 'ox' | 'framework' | 'custom'
  • auto — 検出されたフレームワークの通知を使用します。
  • ox — ox_lib の通知を強制します。
  • framework — フレームワーク自体のシステムを使用します。
  • custom — client/editable.lua 内で独自のフックを呼び出します。

インベントリ（武器リストのソース）

武器ピッカーはインベントリから直接武器リストとそのリアルなアイコンを取得するため、プレイヤーはバッグ内にある正確な画像を確認できます。

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 は常時選択可能です。

デフォルトルール

Config.DefaultRules は、新しく作成されたすべてのゾーンに適用されるルールセットです。各キーの機能については、Zone Rules を参照してください。

PreviousZone RulesNext Discord Logging