配置

服务器腐竹需要调整的所有内容都在 config.lua 中，该文件逐段进行了详细注释。权限、持续时间和限制相关内容请查阅 Permissions & Duration；Webhook 有其专属的页面。本页将介绍其余配置项。

通用

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`	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`	仅在观察者按住瞄准键时绘制。

摄像机

面板在透明界面上方打开，游戏摄像机负责呈现效果。

选项	默认值	用途
`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> 行。

高级

config.lua

Config.Table = 'bupa_syncstatus'  -- 首次启动时自动创建

⚠

config.lua 底部的查找表（Config.BodyPartMap、Config.TypeMap、Config.SeverityMap）在启动时由上述列表自动构建。请勿手动编辑它们。

PreviousPermissions & Duration Next Discord Logging