Personalizzazione

mic_boosting ha due livelli. Un breve config.lua contiene le poche cose decise una volta per tutte — framework, modalità di apertura del tablet, chi è admin, la lingua. Tutto ciò che riguarda il gameplay vive nel database e si modifica in tempo reale dal pannello admin (/boostingconfig), senza riavvio.

Quale file decide cosa

Dove	Cosa decide	Modificabile
`config.lua`	Framework, oggetto/comando del tablet, accesso admin, lingua, sistema di interazione, lavori di polizia, pin di test	Sì
`shared/prices.lua`	Valori iniziali per sei impostazioni dell’economia — letto solo al primissimo avvio (vedi sotto)	Sì
`locales/*.lua`	Ogni notifica e ogni stringa del tablet, un file per lingua; `locales/locale.lua` è il loader	Sì
`bridge/server_bridge.lua`	Framework, denaro, oggetti, oggetto utilizzabile, conteggio della polizia, controllo admin, consegna di un’auto a un garage	Sì
`bridge/client_bridge.lua`	Notifiche, prompt di testo, interazioni target, avviso di dispatch della polizia	Sì
`items/`	Definizioni degli oggetti per ox_inventory, QBCore ed ESX, e le sette immagini degli oggetti	Sì
`ui/`	Il tablet vero e proprio (HTML, CSS, JS)	Escrow (criptato)
`client/`, `server/`	La logica di gioco e il back end del pannello admin	Escrow (criptato)
Pannello admin (`/boostingconfig`)	Punti, punti di consegna, classi, auto, guardie, minigiochi, negozio degli attrezzi, progressione, economia	In gioco

I file aperti sono quelli elencati in escrow_ignore in fxmanifest.lua: config.lua, locales/, shared/ e bridge/.

config.lua

Framework e lingua

Opzione	Cosa fa	Predefinito
`Config.Framework`	`'auto'` cerca `qb-core`, poi `es_extended`, altrimenti standalone. QBox viene trovato come `qb-core`, tramite la sua compatibilità con QBCore. Oppure forza `'qbcore'` (anche per QBox), `'esx'`, `'standalone'`	`'auto'`
`Config.CoreResource`	Presente nel file, ma non letto da questa versione: il rilevamento cerca sempre risorse chiamate `qb-core` e `es_extended`	`''`
`Config.Locale`	Lingua per le notifiche e il tablet. Ripiega sull’inglese	`'en'`

Aprire il tablet

Opzione	Cosa fa	Predefinito
`Config.TabletOpenMode`	`'item'`, `'command'` o `'both'`	`'item'`
`Config.TabletItem`	L’oggetto utilizzabile che lo apre	`mic_boosting_tablet`
`Config.TabletCommand`	Il comando che lo apre, nelle modalità `command` o `both`	`boosting`

Accesso admin

Opzione	Cosa fa	Predefinito
`Config.AdminCommand`	Comando che apre il pannello admin	`boostingconfig`
`Config.AdminGroups`	Gradi che contano come admin. ESX confronta il gruppo del giocatore; QBCore chiede `HasPermission` per ogni nome	`admin`, `superadmin`, `god`
`Config.AdminAce`	Un ACE che ti rende admin a sua volta. L’unica via su standalone. `false` lo disattiva	`command`

Lo stesso controllo decide chi vede la scheda Admin dentro il tablet. Altro in ⌨️ Comandi e permessi.

Interazione e polizia

Opzione	Cosa fa	Predefinito
`Config.InteractionSystem`	Come appare il prompt del lockpick sull’auto: `'ox_target'`, `'qb_target'` o `'drawtext'` (premi E)	`'ox_target'`
`Config.PoliceJobs`	Lavori conteggiati per il minimo di poliziotti online di ogni classe	`police`, `sheriff`, `lspd`, `bcso`

Con ox_target l’auto mostra anche un’opzione separata EMP Jammer per chiunque ne abbia uno con sé. Nelle altre modalità il disturbatore viene comunque usato — automaticamente, quando inizia il lockpick.

Test

Opzione	Cosa fa	Predefinito
`Config.ForceDropoffId`	Manda ogni contratto a questo punto di consegna	`nil` (casuale)
`Config.ForceLocationId`	Fa comparire ogni contratto in questo punto di ritiro	`nil` (casuale)
`Locations.BlipRadius`	Raggio in metri del cerchio di ricerca attorno all’auto bersaglio	`150.0`

shared/prices.lua — solo il primo avvio

Questo file inserisce nel database sei valori dell’economia la prima volta che la risorsa si avvia (quando la tabella delle impostazioni è vuota). Dopodiché, modificarlo non serve a nulla — cambiali nella scheda Settings del pannello admin.

Prices.Tools nello stesso file non è ciò che vende il negozio degli attrezzi: il negozio legge il proprio catalogo dalla scheda Market del pannello admin.

Il pannello admin

/boostingconfig lo apre su Locations. Aggiungi una scheda per aprirlo altrove: locations, dropoffs, classes, vehicles, setups, progression, minigames, market o settings — per esempio /boostingconfig classes.

Scheda	Cosa gestisci lì
Locations	Punti di ritiro: la posizione di un’auto e quattro posizioni delle guardie ciascuno, le classi consentite e la configurazione delle guardie per classe. Teletrasporto, riordino, modifica, eliminazione, oppure posizionamento di uno nuovo nel mondo
Drop-Offs	Dove vengono consegnate le auto. Posiziona nuovi punti nel mondo, teletrasporto, eliminazione
Classes	Tutto ciò che riguarda ogni classe (tabella sotto)
Vehicles	Il parco auto da cui ogni classe pesca i propri bersagli
NPC Setups	Equipaggiamenti delle guardie con nome e relative armi
Progression	Sfide, traguardi, obiettivi e vantaggi
Minigames	Ogni minigioco, le sue impostazioni di difficoltà, on/off e quali classi lo usano
Market	Il negozio degli attrezzi: oggetti e bonus, prezzo, valuta (MB o contanti), valore, classe minima, on/off
Settings	Economia, sospetto (heat), la scheda Tools e il marker del punto di consegna

Posizionare nel mondo. I nuovi punti e punti di consegna si posizionano con un fantasma: E conferma, la rotellina del mouse ruota, Backspace annulla. Un punto di ritiro è prima l’auto, poi quattro guardie, poi un nome.

Classes

Ne sono incluse sei: D, C, B, A, S e S+.

Impostazione	Cosa fa
Label, minimum level	Il nome mostrato e il livello necessario per accedervi (D 0, C 3, B 6, A 10, S 15, S+ 20)
XP range, payout range	Cosa dà un’auto consegnata, estratto a sorte tra i due valori
Time limit	Minuti per consegnare
Cooldown	Secondi prima che lo stesso giocatore possa accettarne un altro
Queue min / max	Quanto tempo impiega la coda a trovare un contratto
Daily limits	Contratti per giocatore e per crew al giorno (0 = illimitati)
Max lockpick attempts	Tentativi prima che la serratura ceda
Police alert	Se la polizia riceve un avviso di dispatch per questa classe
Heat gain	Sospetto (heat) aggiunto a ogni lavoro
Min police online	Poliziotti online necessari per entrare o accettare. Di base 2 per ogni classe
Wanted stars	Livello di ricercato assegnato al ladro una volta aperta l’auto (D 1 … S+ 5)

Settings

Impostazione	Cosa fa	Valore predefinito
VIN Scratch Multiplier	La commissione di VIN-scratch è il 35% del compenso × questo valore, pagata in MB	`4.0`
XP per Level	L’XP necessario per il livello successivo = livello × questo valore	`500`
Heat Decay per Minute	Sospetto (heat) rimosso ogni minuto dai giocatori online	`2`
Max Heat	A questo livello di sospetto, i contratti vengono rifiutati finché non si abbassa	`100`
Hide Locked Items	Nasconde gli oggetti del negozio degli attrezzi di classe superiore a quella del giocatore	Off
Dropoff marker	On/off, tipo di marker, colore (RGBA) e dimensione	On, tipo 2, rosso
Queue Fee, Crypto Rate	Elencati nel pannello. In questa versione entrare in coda è gratuito e una consegna accredita l’intero compenso in MB	`0`, `0.10`

Ricominciare da capo

boostingseed, digitato nella console del server, cancella le tabelle di configurazione e rimette i valori predefiniti forniti. I dati dei giocatori — profili, livelli, MB, crew, contratti, inserzioni del mercato — non vengono toccati.

Lingue

Undici sono incluse in locales/: en, es, fr, pt (brasiliano), de, tr, it, nl, pl, cs, ru. Imposta Config.Locale su una di esse. Una chiave mancante in una lingua ripiega sull’inglese.

Per aggiungerne una:

Copia locales/en.lua in locales/<code>.lua e cambia il codice della lingua in cima alla tabella.
Traduci i valori in entrambe le metà: script (notifiche — mantieni %s e %d) e ui (il tablet — mantieni i segnaposto {name}). date.intl_locale imposta il formato della data nella schermata di blocco.
Aggiungi il file a shared_scripts in fxmanifest.lua, dopo locales/en.lua, poi refresh.
Imposta Config.Locale sul nuovo codice.

Il bridge

Entrambi i file del bridge sono aperti, ed è lì che si innesta un framework, un inventario, un sistema di notifiche o un dispatch personalizzato.

bridge/server_bridge.lua

Funzione	A cosa serve
Rilevamento del framework	Sceglie `qbcore`, `esx` o `standalone` e lo stampa
`GetPlayerIdentifier`	citizenid su QBCore, identifier su ESX, `license:` su standalone
`GetPlayerJob`, `GetPoliceCount`	Nomi dei lavori e numero di giocatori che hanno un lavoro in `Config.PoliceJobs`
`AddMoney`, `RemoveMoney`	Le ricompense e gli acquisti in contanti usano il conto `money`
`AddItem`, `RemoveItem`, `HasItem`	Prima ox_inventory se è in esecuzione, altrimenti il framework
`RegisterUsableItem`	Rende utilizzabile l’oggetto tablet (ESX e QBCore; nulla su standalone)
`GiveVehicle`	Mette nel garage un’auto con VIN limato: `owned_vehicles` su ESX, `player_vehicles` in `pillboxgarage` su QBCore
`IsAdmin`	L’ACE, poi `Config.AdminGroups`
`Notify`	Notifica del framework dal server

bridge/client_bridge.lua

Funzione	A cosa serve
`Notify`	Notifica di QBCore o ESX, feed nativo su standalone
`ShowTextUI`, `HideTextUI`	Il prompt in modalità `drawtext`. Esempi commentati per okokTextUI e cd_drawtextui
`ClientHasItem`	Controllo dell’oggetto lato client, usato dall’opzione EMP sull’auto
`AddEntityInteraction`, `RemoveEntityInteraction`	ox_target / qb-target / drawtext sull’auto
`PoliceDispatch`	Viene eseguita su ogni client di polizia quando scatta un avviso. Predefinito: una notifica e un blip lampeggiante per 60 secondi. Esempi commentati per cd_dispatch e ps-dispatch

La maggior parte delle notifiche che un giocatore vede arriva dall’interno del tablet come toast propri, non tramite il framework.