Installazione

Nota

💬 Hai bisogno di aiuto? Supporto, aggiornamenti e changelog sono disponibili sul Discord di Mic Scripts. Apri un ticket con il tuo ID transazione Tebex e l’errore della console.

Cinque minuti: un file SQL, una riga in config.lua, una riga in server.cfg.

---

Prima di iniziare

Ti serve	Perché
lb-phone	L’app gira al suo interno
oxmysql	Offerte, like e guadagni vengono salvati nel tuo database
ESX, QBCore o QBox	Inventario, denaro e identità del giocatore

---

1. Posiziona la cartella

Inserisci mic_pawnshop nelle tue risorse, ad esempio resources/[mic]/mic_pawnshop.

Attenzione

Mantieni la cartella rinominata mic_pawnshop. Le schermate dell’app richiamano la risorsa con quel nome esatto; se viene rinominata, l’app si apre ma resta vuota.

---

2. Il database

Importa pawnshop.sql dalla cartella della risorsa una sola volta, con HeidiSQL, phpMyAdmin o il programma che usi abitualmente. Crea tre tabelle:

Tabella	Cosa contiene
pawn_offers	Ogni annuncio: oggetto, quantità, prezzo, tipo di prezzo, venditore, date e metadati
pawn_earnings	I guadagni di ciascun venditore in attesa di essere incassati
liked_offers	Chi ha messo like a quale offerta

La risorsa non crea le tabelle automaticamente.

Ha funzionato quando le tre tabelle si trovano nello stesso database utilizzato dal tuo server.

---

3. Avviala dopo le sue dipendenze

Nel server.cfg, aggiungi ensure mic_pawnshop su una riga sotto oxmysql, il tuo framework e lb-phone.

L’app attende lb-phone e si riaggiunge ogni volta che lb-phone viene riavviato, quindi non è un problema se il telefono parte dopo; il framework e oxmysql devono però essere già attivi.

---

4. Indica il tuo framework e l’inventario

Apri config.lua:

Opzione	ESX	QBCore	QBox
Config.Framework	"esx"	"qb"	"qb"
Config.InventoryImagePath	"ox_inventory/web/images/"	"qb-inventory/html/images/"	"ox_inventory/web/images/"

Il framework non viene rilevato automaticamente e va scritto in minuscolo. Su QBox, usa "qb": QBox esegue le risorse QBCore tramite il suo livello di compatibilità. Il percorso immagini serve solo per le icone nell’app — funziona qualsiasi inventario, purché il percorso punti alla cartella in cui si trovano le immagini degli oggetti.

---

5. Oggetti

Non c’è nessun oggetto da aggiungere. L’app vende ciò che i giocatori possiedono già. Tutto ciò che non vuoi venga mai scambiato va inserito in Config.BlackList (vedi Personalizzazione).

---

6. Primo test

1. Apri lb-phone. Pawn Shop è già sulla schermata home — viene installata di default.
2. Crea un’offerta: scegli un oggetto dal tuo inventario, imposta una quantità e un prezzo, e scegli Unit o Total.
3. Su un secondo personaggio, apri l’app e acquistalo.

Ha funzionato quando l’oggetto esce dall’inventario del venditore al momento della pubblicazione dell’offerta, arriva in quello dell’acquirente al momento dell’acquisto e il venditore vede i soldi sotto Pending in alto nell’app, pronti per essere trasferiti.

---

Prima di aprire la tua città

• Decidi da dove provengono i soldi. Config.Bank = true utilizza i conti bancari. Pagare con oggetti richiede che il denaro sia un oggetto dell’inventario — leggi prima Personalizzazione.
• Imposta Config.Expire con consapevolezza. Un’offerta che scade viene rimossa insieme ai suoi oggetti; questi non tornano al venditore.
• Compila Config.BlackList con tutto ciò che non deve passare di mano: l’elenco predefinito contiene solo burger e weapon_appistol come esempi.
• Sposta il banco dei pegni dove preferisci, se attivi Config.RequireLocation.