Installazione

Dieci minuti: due cartelle, un file SQL, otto oggetti.

Prima di iniziare

Ti serve	Perché
ESX, QBCore o QBox, attivo	Pagamento, oggetti e oggetti utilizzabili. Rilevato automaticamente
oxmysql, attivo	Le classifiche
ox_target o qb-target (opzionale)	Solo se desideri l’interazione tramite target

1. Posiziona entrambe le cartelle

Il tuo download contiene due risorse. Inseriscile entrambe nelle tue risorse, ad esempio dentro resources/[mic]/:

Cartella	Cos’è
`mic_arcade`	Lo script e i giochi
`mic_arcade_props`	I sette modelli di cabinato e il renderer che mostra il gioco sui rispettivi schermi

2. Ordine di avvio

Nel server.cfg, sotto oxmysql e il tuo framework, avvia mic_arcade_props e poi mic_arcade, ciascuno sulla propria riga ensure.

Ha funzionato quando entri nel server e i cabinati fissi si trovano alle coordinate elencate in config.lua — di base c’è una fila di quattro cabinati: Pixel, Race, Tower e Road.

3. Il database

Importa install.sql (nella radice di mic_arcade) una sola volta. Crea una tabella, mic_arcade_leaderboard, che conserva il miglior punteggio di ogni personaggio per ciascun gioco.

Lo script non crea questa tabella da solo. Senza di essa, i giochi funzionano comunque ma i punteggi non vengono salvati e la classifica rimane vuota.

Ha funzionato quando nel tuo database è presente la tabella mic_arcade_leaderboard.

4. Aggiungi gli oggetti

Oggetto	Cosa fa
`arcade_coin`	La valuta per una partita quando `Config.PaymentType = 'item'` (predefinito)
`arcade_alien`	Posiziona un cabinato Alien
`arcade_brick`	Posiziona un cabinato Breakout
`arcade_duofight`	Posiziona un cabinato DuoFight
`arcade_pixel`	Posiziona un cabinato Pixel
`arcade_race`	Posiziona un cabinato Race
`arcade_road`	Posiziona un cabinato Road
`arcade_tower`	Posiziona un cabinato Tower

Lo script non distribuisce mai gettoni o cabinati da solo. Vendili in un negozio, assegnali tramite un lavoro o consegnali dal tuo menu admin.

Le definizioni pronte all’uso si trovano in mic_arcade/items/ e le icone in mic_arcade/items/images/:

Inventario	Definizioni (`mic_arcade/items/`)	Dove vanno inserite	Icone
ox_inventory	`ox.lua`	`ox_inventory/data/items.lua`	Copia `items/images/*.png` in `ox_inventory/web/images/`
QBCore / qb-inventory	`qbcore.lua`	`qb-core/shared/items.lua`	Copiale in `qb-inventory/html/images/`
Inventario ESX standard	`esx_items.sql`	Importalo una volta nel tuo database	—

Le voci nei due file .lua sono commentate — rimuovi i trattini -- iniziali quando le incolli.

Ha funzionato quando ti assegni uno di ciascuno e tutti e otto compaiono nel tuo inventario con la relativa icona.

5. Framework e interazione

Il framework non richiede configurazione: ESX, QBCore o QBox vengono rilevati all’avvio. QBox viene riconosciuto tramite la sua compatibilità con QBCore — qbx_core fornisce qb-core — quindi non c’è nulla da impostare.

L’interazione è gestita da Config.Interaction in config.lua. Di base è impostata su ox-target — con il trattino in questo script. Impostala su qb-target se usi quello, oppure su drawtext per un semplice avviso Premi E.

6. Prima partita

Assegnati almeno 100 arcade_coin — ogni cabinato tranne DuoFight costa 100 di base.
Avvicinati a uno dei cabinati fissi e scegli Play Arcade (oppure premi E con drawtext).
Avvia un gioco dal menu del cabinato. Il Price della macchina viene scalato in gettoni.
Premi ESC per allontanarti dal cabinato.

Ha funzionato quando la telecamera si avvicina allo schermo, il gioco parte e i tuoi gettoni diminuiscono del prezzo previsto.

Poi prova a posizionarne uno: usa arcade_race, sposta l’anteprima muovendo la visuale, ruotala con la rotellina del mouse e premi E (ESC o Backspace annulla). Guardalo di nuovo e vedrai l’opzione Pick Up Arcade visibile solo a te.

Prima di aprire la tua città

Scegli la valuta. Config.PaymentType è impostato di base su item con arcade_coin. Se lo mantieni così, assicurati che i giocatori possano effettivamente procurarsi i gettoni da qualche parte.
Imposta i prezzi per ogni cabinato in Config.Arcades.
Posiziona i cabinati fissi dove preferisci, oppure commentali e lascia che siano i giocatori a posizionare i propri.
Avvisa i giocatori che i cabinati posizionati sono temporanei. Un cabinato posizionato resta attivo finché la risorsa o il server non vengono riavviati; raccoglierlo prima restituisce l’oggetto. Vedi Risoluzione dei problemi.