Shops

Sistema di negozi per l'inventario standard e ox_inventory: negozi con carrello, armerie, mercato nero a rotazione, offerte del giorno, venditori NPC e un editor negozi in gioco.

Funzionalità

• Tre tipi di negozio: negozio con carrello, armeria e mercato nero. Si paga con carta o in contanti, al mercato nero con soldi sporchi.
• Il server controlla prezzi, totale, peso e distanza. Scorte solo nei negozi acquistati. Regole per tipo di negozio, negozio o oggetto.
• Negozi in vendita: i giocatori comprano un negozio, decidono i prezzi, ritirano la merce dal grossista e gestiscono la cassa.
• Mercato nero a rotazione con posizioni, assortimento e prezzi che cambiano, più offerte del giorno nei negozi normali.
• Editor negozi in gioco con modello NPC, scenario, marcatore con anteprima dal vivo e blip personalizzato.
• Log Discord per ogni acquisto e statistiche dal vivo su Discord.

Installazione

1. Metti la cartella off_shops nella tua cartella resources.
2. Tutti gli oggetti di config/settings/config.items.lua devono esistere nel tuo inventario – ESX: tabella items, ox_inventory: ox_inventory/data/items.lua. Le armi (weapon_…) con ESX non hanno bisogno di una voce.
3. Nel server.cfg – dopo ESX, oxmysql e il tuo inventario:

ensure oxmysql
ensure es_extended
ensure ox_inventory
ensure off_shops

Le tabelle vengono create automaticamente e integrate con gli aggiornamenti.

Configurazione

config/settings/config.lua

Regole (rules) esistono per tipo di negozio, negozio o oggetto: jobs, blockedJobs, minGrade e hours = { from, to } (ora di gioco, 22–5 = 22:00–04:59).

config/settings/config.locations.lua – Posizioni

{ type = 'normal', label = 'LTD Davis', interactionType = 'ped', position = vec4(-47.02, -1758.23, 29.42, 45.05), categories = { 'food', 'drinks', 'tools' } },
{ type = 'blackmarket', interactionType = 'ped', position = vec4(14.2280, -1104.0475, 29.7970, 340.0), categories = { 'weapons', 'illegal' } },

Le posizioni con type = 'blackmarket' sono possibili luoghi del mercato nero – di queste, activeLocations sono attive contemporaneamente.

Categorie e oggetti

food = { label = 'Essen', items = { 'bread', 'kebab', 'wrap' } }, -- categoria
{ name = 'water', label = 'Wasser', price = 10 },                  -- oggetto

• Opzionale per oggetto: max (quantità massima propria), image (immagine propria), rules (regole proprie).
• weapon_… viene trattato come arma: acquistabile singolarmente, con 42 colpi nell'inventario ESX, non due volte.
• Immagini: ESX carica web/dist/assets/items/<name>.png, ox_inventory usa le sue. Metti le immagini delle armi mancanti in web/dist/assets/weapons/<name>.png.

config/functions.lua

Log Discord

I webhook li inserisci in config/settings/config.server.lua (solo lato server): purchases registra ogni acquisto, stats sono le statistiche dal vivo. Un url vuoto ('') disattiva il log.

Lingue

Tutti i testi sono in config/locales/<lingua>.json. Per una lingua tua, copia un file, traducilo e imposta locale – lascia dentro i placeholder come %s e {total}.

In gioco

Premi E al venditore o al marcatore (oppure usa ox_target), scegli gli articoli e paga. Nel negozio c'è un carrello, in armeria e al mercato nero scegli un articolo.

Editor negozi (/shopeditor)

• A sinistra ci sono tutti i negozi dell'editor. I negozi della config non ci sono, quelli li modifichi in config/settings/config.locations.lua.
• Nuovo crea un negozio nella tua posizione attuale, Modifica ne apre uno esistente.
• Puoi impostare tipo, nome, categorie, NPC o marcatore, posizione con direzione dello sguardo e blip.
• NPC: Scegli un modello da una lista di immagini di tutti i ped di GTA (ricerca e categorie), più scenario e direzione dello sguardo, tutto con anteprima dal vivo in gioco. Un ped addon lo scegli con il nome esatto del modello nella ricerca. Predefinito = venditore da shopTypes.
• Marcatore: Tipo, dimensione, distanza dal suolo, rotazione, colore, opacità e movimento con anteprima dal vivo in gioco.
• Blip: attivo o no, opzionalmente con icona e colore propri. Altrimenti vale il blip di shopTypes.
• Finché l'editor è aperto, ti muovi con WASD e ti guardi intorno tenendo premuto il tasto destro. Poi premi Prendi posizione.
• Dopo Salva la modifica vale subito per tutti i giocatori. Un mercato nero dell'editor è fisso e vende tutti gli articoli delle sue categorie.

Negozi in vendita

Se un negozio è in vendita lo imposti con price in config.locations.lua per i negozi della config, e nell'editor per i negozi dell'editor (gruppo Proprietà: In vendita, Prezzo d'acquisto). Il mercato nero non è mai in vendita. I negozi senza proprietario vendono come prima, senza scorte.

In gioco: In un negozio in vendita, E apre prima una scelta tra Acquista e Gestione, con una telecamera sul venditore se c'è un NPC. Se il negozio è di qualcun altro, si apre direttamente il negozio. Senza proprietario Gestione porta all'offerta, da proprietario alla gestione con Panoramica (cassa, incasso oggi/7 giorni/totale, grafico, articoli quasi esauriti), Magazzino, Prezzi, Ordine e Cassa (prelievo/versamento in contanti o sul conto, cronologia, vendita del negozio). I clienti pagano in cassa e possono comprare solo ciò che è in magazzino.

Consegna: Scegli la merce, il costo viene pagato dalla cassa. Vieni teletrasportato al punto vanSpawn e messo nel furgone – vai dal grossista, E nel marker (carico), torna e parcheggia il furgone nel marker, poi vai dal venditore e premi E. Solo allora la merce entra in magazzino. Se il furgone viene distrutto, il tempo scade o lasci il server, la merce va persa (rimborso secondo refundPercent). Dopo un riavvio del server una consegna aperta viene rimborsata per intero.

Log Discord: webhook ownership in config/settings/config.server.lua (acquisto, vendita, consegne, prelievi/versamenti). Libera nell'editor rende di nuovo libero un negozio (magazzino e cassa vanno persi).

Problemi comuni