Personnalisation
mic_boosting fonctionne sur deux niveaux. Un court fichier config.lua contient les quelques paramètres définis une bonne fois pour toutes — framework, ouverture de la tablette, qui est admin, la langue. Tout le gameplay réside dans la base de données et se modifie en direct depuis le panneau d’administration (/boostingconfig), sans redémarrage.
Quel fichier gère quoi
Section intitulée « Quel fichier gère quoi »| Emplacement | Ce qu’il détermine | Modifiable |
|---|---|---|
config.lua | Framework, item/commande de la tablette, accès admin, langue, système d’interaction, métiers de police, points fixes de test | Oui |
shared/prices.lua | Valeurs initiales de six réglages économiques — lues uniquement au tout premier démarrage (voir plus bas) | Oui |
locales/*.lua | Toutes les notifications et chaînes de la tablette, un fichier par langue ; locales/locale.lua est le chargeur | Oui |
bridge/server_bridge.lua | Framework, argent, items, item utilisable, compteur de police, vérification admin, ajout d’un véhicule au garage | Oui |
bridge/client_bridge.lua | Notifications, invite textuelle, interactions target, alerte dispatch pour la police | Oui |
items/ | Définitions d’items pour ox_inventory, QBCore et ESX, et les sept images d’items | Oui |
ui/ | La tablette elle-même (HTML, CSS, JS) | Escrowed |
client/, server/ | La logique de jeu et le backend du panneau d’administration | Escrowed |
Panneau admin (/boostingconfig) | Emplacements, livraisons, classes, véhicules, gardes, mini-jeux, boutique d’outils, progression, économie | En jeu |
Les fichiers ouverts sont ceux listés dans escrow_ignore dans fxmanifest.lua : config.lua, locales/, shared/ et bridge/.
config.lua
Section intitulée « config.lua »Framework et langue
Section intitulée « Framework et langue »| Option | Ce qu’elle fait | Valeur par défaut |
|---|---|---|
Config.Framework | 'auto' cherche qb-core, puis es_extended, sinon standalone. QBox est détecté via sa compatibilité QBCore. Ou forcez avec 'qbcore' (également pour QBox), 'esx', 'standalone' | 'auto' |
Config.CoreResource | Présent dans le fichier, mais ignoré par cette version : la détection recherche toujours les ressources nommées qb-core et es_extended | '' |
Config.Locale | Langue des notifications et de la tablette. Se rabat sur l’anglais en cas de clé manquante | 'en' |
Ouverture de la tablette
Section intitulée « Ouverture de la tablette »| Option | Ce qu’elle fait | Valeur par défaut |
|---|---|---|
Config.TabletOpenMode | 'item', 'command' ou 'both' | 'item' |
Config.TabletItem | L’item utilisable qui l’ouvre | mic_boosting_tablet |
Config.TabletCommand | La commande qui l’ouvre, en mode command ou both | boosting |
Accès admin
Section intitulée « Accès admin »| Option | Ce qu’elle fait | Valeur par défaut |
|---|---|---|
Config.AdminCommand | Commande ouvrant le panneau d’administration | boostingconfig |
Config.AdminGroups | Rangs considérés comme admin. ESX compare le groupe du joueur ; QBCore vérifie HasPermission pour chaque nom | admin, superadmin, god |
Config.AdminAce | Un ACE accordant également les droits admin. L’unique moyen en standalone. false le désactive | command |
Cette même vérification détermine qui voit l’onglet Admin dans la tablette. Détails dans ⌨️ Commandes et permissions.
Interaction et police
Section intitulée « Interaction et police »| Option | Ce qu’elle fait | Valeur par défaut |
|---|---|---|
Config.InteractionSystem | Affichage de l’invite de crochetage : 'ox_target', 'qb_target' ou 'drawtext' (appui sur E) | 'ox_target' |
Config.PoliceJobs | Métiers comptabilisés pour le minimum de policiers en ligne de chaque classe | police, sheriff, lspd, bcso |
Avec ox_target, le véhicule propose également une option distincte EMP Jammer à quiconque en transporte un. Dans les autres modes, le brouilleur reste utilisé — automatiquement, au début du crochetage.
| Option | Ce qu’elle fait | Valeur par défaut |
|---|---|---|
Config.ForceDropoffId | Envoie chaque contrat à ce point de livraison précis | nil (aléatoire) |
Config.ForceLocationId | Fait apparaître chaque contrat à cet emplacement de ramassage précis | nil (aléatoire) |
Locations.BlipRadius | Rayon en mètres de la zone de recherche autour du véhicule ciblé | 150.0 |
shared/prices.lua — au premier démarrage seulement
Section intitulée « shared/prices.lua — au premier démarrage seulement »Ce fichier injecte six valeurs économiques dans la base de données au tout premier démarrage de la ressource (lorsque la table des paramètres est vide). Après cela, le modifier n’a aucun effet — changez-les directement dans l’onglet Paramètres du panneau admin.
Prices.Tools dans ce même fichier ne correspond pas au catalogue vendu : la boutique lit ses articles depuis l’onglet Market du panneau admin.
Le panneau d’administration
Section intitulée « Le panneau d’administration »/boostingconfig l’ouvre sur Locations. Ajoutez le nom d’un onglet pour l’ouvrir directement ailleurs : locations, dropoffs, classes, vehicles, setups, progression, minigames, market ou settings — par exemple /boostingconfig classes.
| Onglet | Ce que vous y gérez |
|---|---|
| Locations | Emplacements de ramassage : une position de véhicule et quatre de gardes par point, classes autorisées et loadout de gardes par classe. Téléportation, réorganisation, édition, suppression ou placement en jeu |
| Drop-Offs | Lieux de livraison des véhicules. Placement direct en jeu, téléportation, suppression |
| Classes | Tout ce qui touche aux classes (tableau ci-dessous) |
| Vehicles | Le catalogue de véhicules dans lequel chaque classe pioche ses cibles |
| NPC Setups | Équipements de gardes nommés et leurs armes respectives |
| Progression | Défis, jalons, succès et atouts |
| Minigames | Chaque mini-jeu, ses réglages de difficulté, activation et classes qui l’utilisent |
| Market | La boutique d’outils : items et buffs, prix, devise (MB ou liquide), valeur, classe minimale, statut actif |
| Settings | Économie, heat, onglet Outils et marqueur du point de livraison |
Placement dans le monde. Les nouveaux spots et points de livraison se placent avec une prévisualisation transparente : E valide, la molette de la souris tourne, Retour arrière annule. Un point de ramassage commence par le véhicule, puis quatre gardes, puis un nom.
Six sont livrées : D, C, B, A, S et S+.
| Réglage | Ce qu’il fait |
|---|---|
| Libellé, niveau minimal | Nom affiché et niveau requis pour la sélectionner (D 0, C 3, B 6, A 10, S 15, S+ 20) |
| Plage d’XP, rémunération | Récompense d’une livraison, tirée au sort entre les deux valeurs |
| Limite de temps | Minutes allouées pour la livraison |
| Temps de recharge | Secondes avant que le même joueur puisse en accepter un autre |
| File min / max | Temps d’attente estimé dans la file avant de recevoir un contrat |
| Limites quotidiennes | Contrats par joueur et par crew par jour (0 = illimité) |
| Tentatives de crochetage | Nombre d’essais avant le blocage de la serrure |
| Alerte police | Indique si la police reçoit une alerte dispatch pour cette classe |
| Gain de heat | Quantité de heat ajoutée par mission |
| Policiers en ligne min | Policiers requis en ligne pour rejoindre ou accepter. Réglé sur 2 pour chaque classe |
| Étoiles de recherche | Niveau de recherche infligé au voleur dès l’ouverture du véhicule (D 1 … S+ 5) |
Paramètres
Section intitulée « Paramètres »| Réglage | Ce qu’il fait | Valeur de série |
|---|---|---|
| VIN Scratch Multiplier | Frais de grattage du VIN = 35% de la récompense × cette valeur, payés en MB | 4.0 |
| XP per Level | XP requise pour le niveau supérieur = niveau × cette valeur | 500 |
| Heat Decay per Minute | Heat retiré chaque minute aux joueurs connectés | 2 |
| Max Heat | À ce niveau de heat, les contrats sont refusés jusqu’à refroidissement | 100 |
| Hide Locked Items | Masque les items de la boutique d’outils supérieurs à la classe du joueur | Désactivé |
| Dropoff marker | Activation, type de marqueur, couleur (RGBA) et dimensions | Activé, type 2, rouge |
| Queue Fee, Crypto Rate | Affichés dans le panel. Dans cette version, rejoindre la file est gratuit et une livraison rapporte la totalité en MB | 0, 0.10 |
Repartir de zéro
Section intitulée « Repartir de zéro »boostingseed, tapé dans la console du serveur, purge les tables de configuration et réinjecte les données par défaut d’origine. Les données des joueurs — profils, niveaux, MB, crews, contrats, annonces du marché — ne sont pas touchées.
Onze sont livrées dans locales/ : en, es, fr, pt (brésilien), de, tr, it, nl, pl, cs, ru. Réglez Config.Locale sur l’un de ces codes. Une clé absente se rabat sur l’anglais.
Pour en ajouter une :
- Copiez
locales/en.luaverslocales/<code>.luaet modifiez le code de langue en tête de table. - Traduisez les valeurs des deux parties :
script(notifications — conservez%set%d) etui(la tablette — conservez les balises{name}).date.intl_localeconfigure le format de date sur l’écran de verrouillage. - Ajoutez le fichier à
shared_scriptsdansfxmanifest.lua, aprèslocales/en.lua, puis faitesrefresh. - Attribuez le nouveau code à
Config.Locale.
Le bridge
Section intitulée « Le bridge »Les deux fichiers du bridge sont ouverts et constituent l’endroit où connecter un framework personnalisé, un inventaire spécifique, un système de notification ou un dispatch.
bridge/server_bridge.lua
| Fonction | Rôle |
|---|---|
| Détection du framework | Choisit qbcore, esx ou standalone et l’affiche dans la console |
GetPlayerIdentifier | citizenid sur QBCore, identifier sur ESX, license: sur standalone |
GetPlayerJob, GetPoliceCount | Noms des métiers et décompte des joueurs exerçant un métier listé dans Config.PoliceJobs |
AddMoney, RemoveMoney | Récompenses et achats en argent liquide utilisant le compte money |
AddItem, RemoveItem, HasItem | ox_inventory en premier s’il tourne, sinon le framework |
RegisterUsableItem | Rend l’item de tablette utilisable (ESX et QBCore ; rien en standalone) |
GiveVehicle | Place un véhicule au VIN gratté dans le garage : owned_vehicles sur ESX, player_vehicles dans pillboxgarage sur QBCore |
IsAdmin | Vérification de l’ACE, puis de Config.AdminGroups |
Notify | Notification framework envoyée depuis le serveur |
bridge/client_bridge.lua
| Fonction | Rôle |
|---|---|
Notify | Notification QBCore ou ESX, flux natif en standalone |
ShowTextUI, HideTextUI | L’invite en mode drawtext. Exemples commentés pour okokTextUI et cd_drawtextui |
ClientHasItem | Vérification d’item côté client, employée par l’option EMP sur le véhicule |
AddEntityInteraction, RemoveEntityInteraction | Intégration ox_target / qb-target / drawtext sur le véhicule |
PoliceDispatch | S’exécute sur le client de chaque policier lors d’une alerte. Par défaut : notification et blip clignotant pendant 60 secondes. Exemples commentés pour cd_dispatch et ps-dispatch |
La plupart des notifications vues par le joueur proviennent directement de la tablette sous forme de toasts internes, sans passer par le framework.