Skip to content

Installation

安装

1. 依赖项

请在该资源启动前安装并启动 ox_lib。如果你计划使用数据库存储,还必须运行 oxmysql

2. 放入资源

bupa-safezonecreator 放入你的资源文件夹中(例如放入 [BUPA] 分类文件夹内),并将其添加到你的 server.cfg 中。

3. server.cfg — 启动顺序

ox_lib(以及 oxmysql,如果使用的话)必须在资源之前启动。

server.cfg
ensure ox_lib
ensure oxmysql            # 仅在使用 Storage = 'db' 时需要
ensure bupa-safezonecreator

4. 管理员权限

打开创建器是有权限限制的。在测试期间,它对所有人开放——在正式上线前请务必将其锁定

shared/config/general.lua
Config.AdminOnly = false   -- TODO: 在发布前设置为 true(当前对所有人开放)
Config.AdminAce  = 'bupa.safezone'
Config.AdminGroups = { 'admin', 'superadmin', 'god' }
Config.CustomAdmin = false -- true = 在 server/editable.lua 中使用你自己的 IsPlayerAdmin()

一旦 AdminOnly = true,只要满足以下任意条件,玩家即可通过权限检查:

  • 他们拥有 ACE 权限——通过以下方式授予:
server.cfg
  add_ace group.admin bupa.safezone allow
  
  • 他们的框架用户组在 Config.AdminGroups 中(ESX 组、QB-Core 职位名称 / HasPermission('admin')、QBox 职位名称)。
  • Config.CustomAdmin = true 且你位于 server/editable.lua 中的 Editable.isAdmin(src) 返回 true

Config.AdminOnly 默认发货时为 false,以便你可以立即进行测试。在发布前请将其设置为 true,否则任何人都可以打开创建器。

5. 存储 — JSON 或数据库

shared/config/general.lua
Config.Storage = 'json'   -- 'json' | 'db'
  • json(默认)— 区域将被写入资源内部的 data/zones.json 中。零配置。
  • db — 区域将存储在 oxmysql 中。数据表会在首次启动时自动创建;你无需导入任何 SQL:
auto-created table
CREATE TABLE IF NOT EXISTS bupa_safezones (
    id   VARCHAR(64) PRIMARY KEY,
    data LONGTEXT
);

6. 语言

语言通过 ox_lib 的 locale convar 进行全局设置。添加到 server.cfg

server.cfg
setr ox:locale "tr"

任何缺失的键都会回退到英语。有关自带语言的完整列表,请参见本地化