Configuration

Tout se trouve dans config.lua et dans les config.lua de chaque module (modules/<module>/config.lua). Tous ces fichiers sont ouverts et commentés, même avec l'Asset Escrow.

Réglages principaux

Langue

config.lua

Config.Locale = 'fr'   -- 'fr', 'en', 'es', 'pt' (portugais du Brésil) ou 'de'

Tout suit ce réglage : interfaces, écrans, notifications, aides et options ox_target.

Mode d'interaction

config.lua

Config.Interaction = {
    mode = 'target',        -- 'target' = ox_target, 'key' = touches E / G
    resource = 'ox_target', -- ressource utilisée pour le mode 'target'
    distance = 2.5,         -- portée des options ox_target, en mètres
    debug = false           -- true = affiche les zones ox_target (pour les réglages)
}

• En mode target, si ox_target n'est pas démarré, le script repasse tout seul sur les touches.
• Certaines actions restent au clavier et à la souris dans les deux modes :
  • les modes zoomés (grill, assemblage, fontaine, égouttoir, vidage du plateau, borne, caisse) ;
  • G pour ranger le bac vide tenu en main ;
  • G pour vider le sachet porté ;
  • X pour se lever (en plus de l'option ox_target).

Droits admin

config.lua

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

Job

Dans Config.Job (config.lua) :

Clé	Rôle
name	Nom du job (burgershot)
society	Compte de société (society_burgershot)
restrict	true = seuls les employés peuvent utiliser les postes de cuisine, false = tout le monde
managerGrades	Grades qui ouvrent le boss menu (par défaut { 'boss' })
finance	Montants maximum des dépôts et retraits, des primes et des salaires, longueur de l'historique
boss, wardrobe	Positions du boss menu et du vestiaire

Paiements

• Borne (modules/bornes/config.lua, Config.Payment) : le client paie par carte depuis son compte (account = 'bank'), et l'argent va sur society.
• Caisse (modules/commandes/config.lua, Config.Till) : quand l'employé encaisse une commande « à régler au comptoir », le montant est pris sur son compte (payAccount, par défaut money), puis versé à la société. En RP, le client donne l'argent à l'employé, qui le met en caisse. Une commande annulée est remboursée automatiquement.

Modifier le script

Carte, produits et prix

Dans Config.Catalog (config.lua) :

Clé	Contenu
items	Produits de la borne : catégorie (cat), nom, description, prix, étiquette (tag) et menu associé
categories	Catégories (enabled = false affiche « Bientôt disponible »)
options, optionOrder	Accompagnements et boissons au choix dans les menus
priceLimits	Bornes de prix autorisées dans le boss menu

Les prix de la config servent de prix de base. Dès qu'un gérant modifie un prix dans le boss menu, c'est la base de données qui prime. Pour revenir aux prix de la config, videz la table tth_burgershot_catalog.

Recettes des burgers

Dans modules/assemblage/config.lua :

Clé	Contenu
ingredients	Ingrédients, leur item et leur couche 3D
recipes	Recettes, contrôlées dans l'ordre : la première qui correspond gagne, et le nombre de steaks doit être exact
fallback	Item donné si aucune recette ne correspond

Temps de cuisson, minuteurs et sons

Chaque module a sa config :

Module	Réglages
friteuses	Temps de cuisson et de brûlure, son
grill	Temps par face, son
egouttoir	Temps d'égouttage
boissons	Vitesse de remplissage, débordement, son
commandes	Sons des écrans (nouvelle commande, commande prête)

Les fichiers audio sont dans modules/<module>/sounds/. Pour changer un son, remplacez le .mp3 en gardant le même nom, ou modifiez son url dans la config (https://cfx-nui-tth_burgershot/modules/.../sounds/fichier.mp3, ou une URL externe). Chaque son a aussi son volume et sa distance d'écoute. Les sons passent par xsound (voir le bridge pour en changer).

Positions

Tous les points du MLO (friteuses, égouttoir, grill, assemblage, fontaines, piles, emplacements de plateaux, tables et places assises, meuble poubelle, réserve, boss menu, vestiaire, caisses) sont dans les configs, en coordonnées. Pour un autre mapping :

1. changez les coordonnées ;
2. recalez la position assise avec /bsassise, l'écran des caisses avec /bscaisseecran et la hauteur des steaks avec /bsplaque ;
3. replacez les bornes, les écrans et la poubelle avec leurs commandes admin.

Tenues

Dans Config.Job.wardrobe.outfits (config.lua), chaque tenue a :

• id, label et desc ;
• grade, le grade minimum ;
• male et female, au format skinchanger (tshirt_1, torso_1, pants_1…).

Laissez female = nil pour une tenue réservée aux hommes, et inversement.

Changer les noms d'items

Chaque nom d'item se change dans la config qui l'utilise :

Items	Config
Achats de la réserve	modules/reserve/config.lua → catalog et usable
Packs des piles	modules/reserve/config.lua → piles
Ingrédients, recettes et burger maison	modules/assemblage/config.lua
Steaks du grill	modules/grill/config.lua
Cornet de frites	modules/egouttoir/config.lua → reward
Boissons	modules/boissons/config.lua → drinks
Articles posables sur un plateau	modules/plateaux/config.lua → items
Ce qui se mange en salle, avec faim et soif	modules/salle/config.lua → food
Ticket	modules/tickets/config.lua

Pensez à renommer aussi les items dans votre inventaire (voir Items).

Langues et textes

Tous les textes sont dans locales/ (fr.lua, en.lua, es.lua, pt.lua, de.lua). Pour corriger un texte, modifiez la ligne voulue dans le fichier de votre langue.

Pour ajouter une langue (exemple : italien) :

1. Copiez locales/en.lua sous le nom locales/it.lua.
2. Remplacez Locales['en'] par Locales['it'] et traduisez les valeurs. Gardez tels quels les %s, %d, ~INPUT_CONTEXT~, ~n~ et les balises HTML.
3. Mettez Config.Locale = 'it'.
4. Optionnel : ajoutez ['_intl'] = 'it-IT', dans le fichier pour le format des dates et des montants.

info

Les libellés de la config (produits, tenues, articles) sont traduits automatiquement tant qu'ils gardent leur valeur française d'origine. Si vous les modifiez, votre texte est gardé tel quel, quelle que soit la langue.

Performances

Toutes les boucles se mettent en veille quand on est loin ou qu'il ne se passe rien. Si vous avez beaucoup de joueurs dans le restaurant, vous pouvez aussi réduire les distances d'affichage des minuteurs (timer.drawDistance) et des écrans (drawDistance) dans les configs.