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

他のプレイヤーにペドの上で浮遊するように表示されるテキストです。

Option	Default	Purpose
`Config.Text.ViewDistance`	`6.0`	この距離（メートル）を超えると描画されなくなります。
`Config.Text.ScanInterval`	`800`	クライアントがメモを持っている周囲のプレイヤーを再スキャンする頻度（ミリ秒）。値を大きくすると負荷が減りますが、表示されるまでの速度が遅くなります。
`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`	ボーンの位置をインターフェースに送信する頻度（ミリ秒）。非常に混雑しているサーバーでは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' },  -- label: 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 & Duration Next Discord Logging