Installation

Comptez environ 10 minutes. Les étapes communes à tous nos scripts (Keymaster, licence Cfx.re) sont décrites dans Installer un script.

Contenu du dossier d'installation

Le script est livré avec un dossier [INSTALL] :

[INSTALL]/
├─ INSTALLATION.md                 Tutoriel d'installation rapide
├─ README.md                       Documentation complète
├─ jobs/jobs.sql                   Job, grades et société
├─ install_items/
│  ├─ items.sql                    Items pour l'inventaire ESX
│  ├─ ox_inventory_items.lua       Items pour ox_inventory
│  └─ images_inventory/            24 icônes PNG des items
└─ mapping/                        2 fichiers corrigés pour le MLO Burger Shot

Étape 1 — Vérifier les dépendances

Obligatoires

Ressource	Rôle	Lien
es_extended (ESX Legacy)	Framework	github.com/mitlight/es_extended
oxmysql	Base de données	github.com/overextended/oxmysql
uniqx_burgershot	MLO du Burger Shot	gta5-mods.com — MLO Burgershot 2023

Optionnelles

Le script s'adapte automatiquement si elles sont démarrées.

Ressource	Sert à	Lien
ox_target	Interactions à la visée (sinon touches E / G)	overextended/ox_target
ox_inventory	Inventaire (détecté automatiquement, sinon inventaire ESX)	overextended/ox_inventory
xsound	Sons : friteuses, grill, soda, écrans de commandes	Xogy/xsound
esx_addonaccount	Compte de l'entreprise (ventes, réserve, boss menu)	ESX-Legacy-Addons
esx_society	Enregistrement de la société	ESX-Legacy-Addons
esx_status	Faim et soif quand on mange en salle	ESX-Legacy-Addons
esx_menu_default	Menus de choix (article à poser, plat à manger)	Parow/esx_menu_default
skinchanger	Tenues du vestiaire	mitlight/skinchanger
esx_skin	Tenues du vestiaire (tenue civile)	mitlight/esx_skin

Étape 2 — Installer la ressource

Copiez le dossier tth_burgershot dans votre dossier resources.

Ne renommez pas le dossier

Le nom tth_burgershot est utilisé par les interfaces (et par l'Asset Escrow).

Étape 3 — Importer le job

Importez jobs/jobs.sql dans votre base de données (HeidiSQL, phpMyAdmin…). Il crée :

• le job burgershot et ses 5 grades ;
• le compte, l'inventaire et le datastore de société society_burgershot (utilisés par esx_addonaccount et esx_society) ;
• les tables tth_burgershot_catalog (prix modifiés depuis le boss menu) et tth_burgershot_transactions (historique des finances). Le script les crée aussi tout seul au démarrage si elles n'existent pas.

Grade	Nom	Libellé	Salaire
0	recrue	Recrue	50
1	equipier	Équipier	75
2	cuisinier	Cuisinier	100
3	manager	Manager	125
4	boss	Patron	150

Grades existants remplacés

Le fichier supprime puis recrée les grades du job burgershot. Si le job existe déjà chez vous avec des grades personnalisés, sauvegardez-les avant l'import.

Pour changer les noms ou les salaires des grades, modifiez le fichier avant de l'importer. Le grade qui ouvre le boss menu doit garder le nom boss, ou alors adaptez Config.Job.managerGrades. Les tenues du vestiaire (Config.Job.wardrobe.outfits) utilisent les numéros de grade 0 à 4.

Étape 4 — Ajouter les items

Suivez une seule des deux options, selon votre inventaire. La liste complète est sur la page Items.

Option A — ox_inventory

1. Ouvrez ox_inventory/data/items.lua.
2. Collez le contenu de install_items/ox_inventory_items.lua à l'intérieur du return { ... }, par exemple juste avant la dernière accolade }.
3. Copiez les images de install_items/images_inventory/ dans ox_inventory/web/images/.

Option B — inventaire ESX de base

1. Importez install_items/items.sql dans votre base de données (table items).
2. Si votre inventaire affiche des images, copiez celles de install_items/images_inventory/ dans son dossier d'images.

Étape 5 — Remplacer les 2 fichiers du mapping

Copiez les 2 fichiers de mapping/ dans uniqx_burgershot/stream/, en remplaçant les fichiers existants :

Fichier	Modification
uniqx_burgershot_prop_trash.ydr	Meuble poubelle de la salle, nettoyé
uniqx_burgershot_ktch_deta02.ydr	Décor de cuisine, sans l'ancien égouttoir

Étape 6 — Ordre de démarrage dans server.cfg

tth_burgershot doit démarrer en dernier, après toutes ses dépendances :

server.cfg

ensure oxmysql
ensure es_extended
ensure esx_addonaccount
ensure esx_society
ensure esx_status
ensure esx_menu_default
ensure skinchanger
ensure esx_skin
ensure xsound
ensure ox_target
ensure ox_inventory
ensure uniqx_burgershot
ensure tth_burgershot

Retirez les lignes des ressources que vous n'utilisez pas.

Étape 7 — Réglages de base

Dans tth_burgershot/config.lua :

tth_burgershot/config.lua

Config.Locale = 'fr'          -- 'fr', 'en', 'es', 'pt' ou 'de'

Config.Interaction = {
    mode = 'target',          -- 'target' (ox_target) ou 'key' (touches E / G)
    ...
}

Config.AdminGroups = { 'admin', 'superadmin' }   -- groupes autorisés à placer bornes et écrans

Les commandes de placement sont réservées aux groupes ESX listés dans Config.AdminGroups. Tous les autres réglages sont décrits dans Configuration.

Étape 8 — Démarrer et placer les éléments en jeu

Redémarrez le serveur, connectez-vous avec un compte admin, puis :

1. /setjob <votre id> burgershot 4 pour vous mettre patron.
2. Bornes de commande : devant chaque emplacement de borne, tapez /bsborne, ajustez avec la molette et les flèches, puis validez avec E.
3. Écrans de cuisine : /bsecran pour un écran cuisine, /bsecranclient pour un écran clients. Visez le mur, clic gauche pour bloquer, A / E pour pivoter.
4. Poubelle de cuisine : placez-vous à l'endroit voulu et tapez /bspoubelle.

Tout est sauvegardé automatiquement : vous ne le ferez qu'une fois. Le détail des contrôles est sur la page Mise en place en jeu.

Étape 9 — Vérifier que tout fonctionne

• Une borne s'ouvre, et une commande passée apparaît sur l'écran cuisine.
• Le boss menu s'ouvre au bureau avec le grade boss.
• La réserve s'ouvre et débite le compte de la société.
• Les options ox_target apparaissent (ou les aides E / G en mode key).
• On entend les friteuses et le grill (si xsound est installé).

Un problème ? Consultez le Dépannage.