QBESXStandalone

Agency-Minerjob V2 Installation

A mining job for FiveM on QBCore, Qbox, ESX or fully standalone, in three places: the Davis Quartz quarry, the old mine.

v2.0.0Paid5 Pages

Buy in Shop Back to catalog

01Installation

1Put Agency-Minerjob into your resources folder
2Add ensure Agency-Minerjob to server.cfg, after your framework, oxmysql and your inventory
3QBCore with qb-inventory or a fork: nothing to do, missing items are added while the server runs. ox_inventory (also Qbox): add the entries of install/items_ox_inventory.lua. ESX: run install/items_esx.sql
4Copy install/images into the images folder of your inventory. The menu shows the pictures either way
5Optional: add_ace group.admin agency.minerjob.admin allow for /mineradmin
6Updating from V1: replace the old folder and use the new config.lua. Levels from V1 (player_mining_skills) are taken over on the first start

02Dependencies

No dependency required
QBCore, QBox or ESX (optional, runs standalone without one)
oxmysql (optional, without it everything is saved in the server's key value store)
An inventory (optional: ox_inventory, qs-inventory, qb-inventory and its forks or ESX; without one the miner keeps everything in the satchel of the menu)
Agency-Notify (optional, messages as Agency notifications)
Agency-Banking (optional, money on standalone servers)

03SQL File

Optional: the resource creates these tables on its own when it starts. Import this file only if you set up the database by hand:

-- 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;

+Good to know

Agency-Minerjob V2 works right after the ensure line. Four points are worth a look before the first start: the items, the item pictures, admins and the step from V1.

Items: On QBCore with qb-inventory or a fork nothing has to be done, missing items are added while the server runs (Config.RegisterItems). For ox_inventory, also on Qbox, add the entries of install/items_ox_inventory.lua to ox_inventory/data/items.lua. On ESX run install/items_esx.sql.
Item Pictures: Copy install/images into the images folder of your inventory. The menu shows the pictures either way: Config.Images = 'auto' takes them from the inventory and falls back to its own.
Database: With oxmysql everything is saved in one table, agency_minerjob, which the script creates by itself. Without oxmysql it goes to the server's key value store. The SQL below is only needed when your database user may not create tables.
Admins: Admins are players with the ACE agency.minerjob.admin, group.admin or group.superadmin, one of the groups in Config.Admin.groups, or one of the identifiers in Config.Admin.identifiers.
Updating from V1: Replace the old folder with the new one and use the new config.lua, the V1 config does not fit. Levels are taken over from player_mining_skills on the first start, the V1 item names stay the same (stone, coal, copper, silver, diamond, emerald), and /mininglevel still works.

?Frequently asked questions

Which inventories are supported?

ox_inventory, qs-inventory, qb-inventory and its forks such as ps, lj and jpr, and the ESX inventory, found by Config.Inventory = 'auto'. Standalone servers without an inventory use the satchel in the menu, or connect their own inventory with the functions in Config.Standalone.

How do players get paid on a standalone server?

Config.Standalone.money = 'auto' uses Agency-Banking when it runs, otherwise a wallet in the menu. With 'hooks' your own getMoney, removeMoney and addMoney functions are used.