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.