Configuration

所有配置都存放在 config.lua 中，其中包含大量注释且作为唯一的数据来源。本页是该文件中各个代码块的导航图。

General

Config.Debug = false
Config.Inventory = 'auto'
Config.Target = 'auto'
Config.Interaction = 'target'
Config.Account = 'bank'

Interaction 可设为 'target'（眼标/第三视角，需要 target 资源）或 'textui'（提示与按键交互，无需 target 资源）。Account 用于决定加油扣费和员工工资发放所使用的资金账户 —— 如果玩家余额不足，将自动改用另一个账户。Debug 会绘制加油机区域并在放置加油站时打印日志；在线上生产环境中请保持关闭状态。

Fuel and vehicles

Config.FuelTypes 和 Config.FuelOrder 用于定义油品。Config.VehicleFuel 决定每辆车使用什么燃料。这两项都在 Fuel & consumption 中进行了介绍。

Consumption

Config.Consumption 包含油箱大小、车辆分类消耗率、转速曲线、tick 间隔、低油量警告以及 SpawnFuel。请参阅 Fuel & consumption —— SpawnFuel 是对玩家光顾加油站频率影响最大的设置。

Wrong fuel

Config.WrongFuel.Mode ——可选 off、slow、damage、break 或 explode —— 以及各模式所使用的数值，还有导致故障前的 Grace（容错升数）。

Jerry can

Config.JerryCan 用于设置物品名称、模型、容量、加满与倾倒速率、距离，以及加油站是否出售满装油桶。请参阅 The jerry can。

Electric

Config.Electric 用于设置充电桩和电缆模型、kWh 为单位的电池容量、快充与慢充速率、距离，以及换电池物品。请参阅 Electric charging。

Stations, marker, blips

Config.Stations 是包含 27 个地点的列表，Config.ManageMarker 用于设置 $ 标记的样式，Config.PumpProps 列出了被视为加油机的模型，Config.Blip 则用于设置地图标记样式。请参阅 Stations。

Refuelling

Config.Refuel = {
    LitrePerTick = 0.5,
    Tick         = 300,
    HoldEngineOff = true,
    Presets = { 20, 50, 'full' },
    PriceLimits = { min = 0.1, max = 25.0 },
}

此外还有距离设置 —— VehicleSearch、MaxDistance、NozzleLeash、TargetDistance、PumpSearch、PromptDistance、CapDistance。

Stock and deliveries

Config.Deliveries = {
    Depot   = vec4(2796.0, 1560.0, 24.5, 180.0),
    Tanker  = 'tanker',
    Spawn   = vec4(2810.0, 1570.0, 24.5, 90.0),
    MinOrder = 1000,
    MaxOrder = 25000,
    FillRate = 200,
    ReturnRadius = 30.0,
    StarterStock = 0.5,
}

StarterStock 指当有人买下该产业时油库的初始储油量，以存储上限的比例计算。设置为 0 则表示交接时油库完全空置。

Ownership

Config.AllowTransfer = true
Config.AllowSellBack = true
Config.SellBackRate = 0.3

Employees and upgrades

Config.Employees 设置员工上限、四个权限键、默认工资以及发薪间隔。Config.Upgrades 设置三个升级路线。这两项都在 The dashboard 中进行了介绍。

Admin

Config.Admin 设置两个命令名称以及谁有权运行它们。请参阅 Admin。

Anti-cheat

Config.AntiCheat 包含速率限制、会话上限和数值夹紧（clamp）设置。请参阅 Anti-cheat。

Interface

Config.UI = {
    Accent = '#5B6CF0',
    ManageCommand = 'station',
    CloseOnEscape = true,
    Sounds = true,
    Keys = {
        Interact  = 38,     -- E
        Switch    = 23,     -- F
        Cancel    = 73,     -- X
        Secondary = 47,     -- G
    },
    WorldDrawDistance = 12.0,
    WorldTick = 16,
    ImagePath = false,
}

Keys 是用于世界中加油机和充电桩面板的 GTA 控制按键索引。WorldTick 是这些面板更新位置的毫秒间隔 —— 0 表示每一帧都更新且看起来紧贴着加油机，16 依然保持丝滑，同时能在繁忙的加油站为浏览器腾出更多性能空间。ImagePath 仅在使用重命名的物品栏分支（inventory fork）时需要设置，例如 'nui://my-inventory/web/images/'。

Webhook

Config.Webhook = {
    Enabled  = false,
    Url      = '',
    Username = 'BUPA Fuel',
    Log = {
        Purchase = true,
        Sale     = false,
        Withdraw = true,
        Stock    = true,
        Employee = true,
        Admin    = true,
    },
}

每个事件类型都在 Config.Webhook.Colors 下拥有专属的颜色。