QBESXStandalone

Agency-Minerjob V2 Installation

Un métier de mineur pour FiveM sur QBCore, Qbox, ESX ou en mode totalement autonome, réparti sur trois sites.

v2.0.0Payant5 Pages

Acheter Retour au catalogue

01Installation

1Placez Agency-Minerjob dans votre dossier resources
2Ajoutez ensure Agency-Minerjob à server.cfg, après votre framework, oxmysql et votre inventaire
3QBCore avec qb-inventory ou un fork : aucune action requise, les objets manquants sont ajoutés pendant l’exécution du serveur. ox_inventory (Qbox également) : ajoutez les entrées de install/items_ox_inventory.lua. ESX : exécutez install/items_esx.sql
4Copiez install/images dans le dossier images de votre inventaire. Le menu affiche les images dans tous les cas
5Facultatif : ajoutez add_ace group.admin agency.minerjob.admin allow pour /mineradmin
6Mise à jour depuis V1 : remplacez l’ancien dossier et utilisez le nouveau config.lua. Les niveaux de V1 (player_mining_skills) sont repris au premier démarrage

02Dépendances

Aucune dépendance requise
QBCore, QBox ou ESX (facultatif, fonctionne en standalone sans framework)
oxmysql (optionnel, sinon tout est enregistré dans le stockage clé-valeur du serveur)
Un inventaire (facultatif : ox_inventory, qs-inventory, qb-inventory et ses forks, ou ESX ; sans inventaire, le mineur garde tout dans la sacoche du menu)
Agency-Notify (facultatif, affiche les messages sous forme de notifications Agency)
Agency-Banking (facultatif, pour l’argent sur les serveurs autonomes)

03Fichier SQL

Optionnel : la ressource crée ces tables elle-même au démarrage. N'importez ce fichier que si vous préparez la base de données à la main :

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

+Bon à savoir

Agency-Minerjob V2 fonctionne dès que la ligne ensure est ajoutée. Quatre points méritent votre attention avant le premier démarrage : les objets, leurs images, les admins et la migration depuis la V1.

Objets: Avec QBCore et qb-inventory ou l’un de ses forks, aucune action n’est nécessaire, les objets manquants sont ajoutés pendant que le serveur tourne (Config.RegisterItems). Pour ox_inventory, également sur Qbox, ajoutez les entrées de install/items_ox_inventory.lua à ox_inventory/data/items.lua. Avec ESX, exécutez install/items_esx.sql.
Images des objets: Copiez install/images dans le dossier images de votre inventaire. Dans tous les cas, le menu affiche les images : Config.Images = 'auto' les récupère depuis l’inventaire et utilise ses propres images en solution de repli.
Base de données: Avec oxmysql, toutes les données sont enregistrées dans une seule table, agency_minerjob, que le script crée lui-même. Sans oxmysql, elles sont enregistrées dans le stockage clé-valeur du serveur. Le SQL ci-dessous n’est nécessaire que si l’utilisateur de votre base de données ne peut pas créer de tables.
Admins: Les admins sont les joueurs disposant de l’ACE agency.minerjob.admin, du groupe group.admin ou group.superadmin, de l’un des groupes de Config.Admin.groups ou de l’un des identifiants de Config.Admin.identifiers.
Mise à jour depuis la V1: Remplacez l’ancien dossier par le nouveau et utilisez le nouveau config.lua, la configuration V1 ne convient pas. Les niveaux sont récupérés depuis player_mining_skills au premier démarrage, les noms des objets V1 restent les mêmes (stone, coal, copper, silver, diamond, emerald) et /mininglevel fonctionne toujours.

?Questions fréquentes

Quels inventaires sont pris en charge ?

ox_inventory, qs-inventory, qb-inventory et ses forks tels que ps, lj et jpr, ainsi que l’inventaire ESX, détecté avec Config.Inventory = 'auto'. Les serveurs standalone sans inventaire utilisent la sacoche dans le menu, ou peuvent connecter leur propre inventaire avec les fonctions de Config.Standalone.

Comment les joueurs sont-ils payés sur un serveur standalone ?

Config.Standalone.money = 'auto' utilise Agency-Banking si celui-ci est actif, sinon un portefeuille dans le menu. Avec 'hooks', vos propres fonctions getMoney, removeMoney et addMoney sont utilisées.