01安装
- 1将 Agency-Minerjob 放入 resources 文件夹
- 2在 server.cfg 中的框架、oxmysql 和 Inventory 之后添加 ensure Agency-Minerjob
- 3QBCore 搭配 qb-inventory 或其分支版本:无需进行任何操作,缺少的物品会在服务器运行时自动添加。ox_inventory(包括 Qbox):添加 install/items_ox_inventory.lua 中的条目。ESX:运行 install/items_esx.sql
- 4将 install/images 复制到 Inventory 的 images 文件夹。无论是否执行此操作,菜单都会显示图片
- 5可选:添加 add_ace group.admin agency.minerjob.admin allow,以启用 /mineradmin
- 6从 V1 更新:替换旧文件夹并使用新的 config.lua。V1(player_mining_skills)中的等级会在首次启动时继承。
02依赖项
无需任何依赖QBCore、QBox 或 ESX(可选,没有框架时以独立模式运行)oxmysql(可选,没有它时所有数据都保存在服务器的键值存储中)Inventory(可选:ox_inventory、qs-inventory、qb-inventory 及其分支版本,或 ESX;没有 Inventory 时,矿工会将所有物品存放在菜单的挎包中)Agency-Notify(可选,将消息作为 Agency 通知发送)Agency-Banking(可选,用于独立服务器上的资金管理)
03SQL 文件
可选:资源启动时会自动创建这些数据表。只有在手动配置数据库时才需要导入此文件:
-- Agency-Minerjob V2
-- Optional: the script creates this table by itself on the first start when oxmysql runs.
-- Only needed when your database user may not create tables.
-- Without oxmysql everything is saved in the server's key value store instead.
-- Levels from V1 (player_mining_skills) are taken over on the first start; that table stays untouched.
CREATE TABLE IF NOT EXISTS `agency_minerjob` (
`scope` VARCHAR(16) NOT NULL,
`id` VARCHAR(96) NOT NULL,
`data` LONGTEXT NOT NULL,
`updated` INT UNSIGNED NOT NULL DEFAULT 0,
PRIMARY KEY (`scope`, `id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+值得了解
Agency-Minerjob V2 在添加 ensure 行后即可运行。首次启动前,有四项内容值得检查:物品、物品图片、管理员,以及从 V1 迁移。
- 物品
- 在使用 qb-inventory 或其分支的 QBCore 上,无需进行任何操作,缺少的物品会在服务器运行时自动添加(Config.RegisterItems)。对于 ox_inventory,包括 Qbox,请将 install/items_ox_inventory.lua 中的条目添加到 ox_inventory/data/items.lua。对于 ESX,请运行 install/items_esx.sql。
- 物品图片
- 将 install/images 复制到物品栏的 images 文件夹中。菜单无论如何都会显示图片:Config.Images = 'auto' 会从物品栏获取图片,并在找不到时使用自带图片。
- 数据库
- 使用 oxmysql 时,所有数据都会保存在 agency_minerjob 这张表中,该表由脚本自动创建。不使用 oxmysql 时,数据会保存在服务器的键值存储中。仅当你的数据库用户无权创建表时,才需要执行下面的 SQL。
- 管理员
- 拥有 ACE agency.minerjob.admin、group.admin 或 group.superadmin 的玩家,拥有 Config.Admin.groups 中某个组的玩家,或拥有 Config.Admin.identifiers 中某个标识符的玩家,都是管理员。
- 从 V1 更新
- 用新文件夹替换旧文件夹,并使用新的 config.lua,V1 的配置不适用。首次启动时会从 player_mining_skills 接管等级,V1 的物品名称保持不变(stone, coal, copper, silver, diamond, emerald),/mininglevel 仍然可用。
?常见问题
支持哪些物品栏?
ox_inventory、qs-inventory、qb-inventory 及其分支版本,例如 ps、lj 和 jpr,还有 ESX 物品栏,可通过 Config.Inventory = 'auto' 自动检测。没有物品栏的独立服务器可使用菜单中的腰包,或通过 Config.Standalone 中的函数接入自定义物品栏。
独立服务器上的玩家如何获得报酬?
Config.Standalone.money = 'auto' 会在 Agency-Banking 运行时使用它,否则使用菜单中的钱包。使用 'hooks' 时,会调用你自己的 getMoney、removeMoney 和 addMoney 函数。
