Vai al contenuto
Tutta la documentazione

Clothingstore

Negozio di abbigliamento con anteprima dal vivo: i giocatori cambiano i vestiti, salvano i look come outfit pagando in contanti e li condividono con gli altri. Con la borsa dei vestiti possono indossare i loro outfit anche in giro. In più ci sono un barbiere e uno studio tatuaggi con posizioni, blip e menu propri.

Requisiti
  • ESX Legacy (es_extended)
  • oxmysql
  • skinchanger e esx_skin (inclusi in ESX Legacy)
  • OneSync (obbligatorio)
  • Per la borsa dei vestiti: un inventario con item ESX (tabella items), ad es. off_inventory

Funzionalità

  • Anteprima dal vivo con la telecamera sulla parte del corpo giusta. Trascinando ruoti il personaggio, la rotella del mouse zooma.
  • 14 categorie con Variante e Stile.
  • Outfit per personaggio: salvali a un prezzo fisso, indossali, rinominali, condividili ed eliminali.
  • Condivisi: indossa gratis gli outfit di altri giocatori (i 100 più recenti).
  • Borsa dei vestiti (item clothbag): posala a terra e lì indossa i tuoi outfit.
  • Tutti vedono la borsa e possono usarla.
  • Solo il proprietario può raccoglierla. Se è offline, chiunque può raccoglierla.
  • Le borse posate restano anche dopo un riavvio.
  • /clearbags rimuove tutte le borse posate.
  • Barbiere con anteprima dal vivo e telecamera sulla testa:
  • tutte le acconciature e varianti del modello del personaggio, tutti i colori dei capelli con colpi di sole
  • barba, sopracciglia, peli del petto, trucco, fard e rossetto con forma, opacità e colore (barba e peli del petto solo per personaggi maschili)
  • Si paga per ogni categoria modificata. Annullare ripristina il look precedente.
  • Studio tatuaggi con tutti i tatuaggi di GTA, DLC compresi, letti direttamente dal gioco:
  • ordinati per testa, busto, braccia e gambe, con ricerca e filtro I miei
  • anteprima sul personaggio, tatuare e rimuovere a un prezzo fisso
  • salvati per personaggio e riapplicati automaticamente dopo il login, il respawn e ogni cambio di skin
  • Barbiere e studio tatuaggi prelevano prima i contanti, il resto dalla banca.

Installazione

  1. Metti la cartella off_clothingstore nella tua cartella resources.
  2. Nel server.cfg, dopo oxmysql, ESX e skinchanger:
cfg
ensure oxmysql
ensure es_extended
ensure skinchanger
ensure esx_skin
ensure off_clothingstore
  1. Rimuovi esx_clotheshop o altri negozi di abbigliamento negli stessi punti.

Al primo avvio lo script crea automaticamente:

  • le tabelle off_clothing_outfits, off_clothing_bags e off_clothing_tattoos
  • l'item clothbag nella tabella items, se manca

Configurazione

config/settings/config.lua

OpzionePredefinitoDescrizione
serverInfo.name'OFF SCRIPTS'Nome del server, mostrato nell'interfaccia al posto di «OFF SCRIPTS»
serverInfo.locale'de'Lingua: de, en, pl, fr, es, it o nl
serverInfo.color{ 155, 89, 255 }Colore della UI (RGB)
serverInfo.design3Design dell'interfaccia: 1 = Classico, 2 = Scontrino, 3 = Storefront
blurtrueSfondo sfocato finché il menu della borsa è aperto. Il negozio resta nitido, perché lì vedi il tuo personaggio
outfitPrice250Prezzo per outfit salvato (contanti), 0 = gratis
maxOutfits25Max. outfit per personaggio
markerDisco, 3 mCerchio: type, size (area per aprire), drawDistance, color, alpha
blipIcona 73Icona sulla mappa (enabled, sprite, color, scale)
locations14 negoziCentro del cerchio a terra come vec3
barberattivo, 7 posizioniBarbiere, vedi sotto
tattooattivo, 6 posizioniStudio tatuaggi, vedi sotto

config/settings/config.categories.lua – Categorie

Solo queste categorie compaiono nel negozio e solo queste vengono salvate negli outfit, nell'ordine del file.

lua
{ icon = 'shoes', label = 'Schuhe', variant = 'shoes_1', color = 'shoes_2', camOffset = vec3(0, 0.9, -0.8) },
CampoDescrizione
iconbag, chain, earrings, glasses, gloves, hat, jacket, mask, ring, shirt, shoes, shorts, vest, watch o un'icona Phosphor con ph-
labelNome nel negozio
variant / colorValori skinchanger per Variante e Stile
camOffsetTelecamera: x = sinistra/destra, y = distanza in avanti, z = altezza

config/settings/config.bag.lua – Borsa dei vestiti

OpzionePredefinitoDescrizione
enabledtruefalse = borsa dei vestiti disattivata del tutto (niente item, niente borse)
item'clothbag'Nome dell'item, viene creato all'avvio nella tabella items
weight1Peso dell'item
model'prop_cs_heist_bag_02'Oggetto della borsa a terra
max1Quante borse un giocatore può posare contemporaneamente
distance2.0Distanza in metri per usare e raccogliere
clearCommand'clearbags'Comando che elimina tutte le borse posate, '' = disattivato
clearGroups{ 'projektleitung' }Gruppi che possono usare il comando (la console del server sempre)

Con enabled = false le borse posate restano nel database. Tornano appena la borsa viene riattivata.

config/settings/config.lua – Barbiere e studio tatuaggi

Entrambi hanno posizioni e blip propri, il cerchio (marker) è lo stesso del negozio.

lua
barber = {
  enabled = true,
  price = 150,
  blip = { enabled = true, sprite = 71, color = 0, scale = 0.8 },
  locations = { vec3(-814.3, -183.8, 36.6), ... },
},
OpzionePredefinitoDescrizione
enabledtruefalse = barbiere o studio tatuaggi disattivato del tutto
price150 / 500Barbiere: prezzo per categoria modificata · Studio tatuaggi: prezzo per tatuaggio, 0 = gratis
removePrice250Solo studio tatuaggi: prezzo per rimuovere un tatuaggio, 0 = gratis
blipIcona 71 / 75Icona sulla mappa (enabled, sprite, color, scale)
locations7 / 6 posizioniCentro del cerchio a terra come vec3

Il pagamento preleva prima i contanti, il resto dalla banca. I prezzi esistono solo sul server, il client non può modificarli. I tatuaggi vengono salvati nella tabella off_clothing_tattoos, al massimo 100 per personaggio.

config/functions.lua

Qui colleghi i tuoi script.

FunzioneLatoA cosa serve
Notify(source, message, type)ServerMessaggio a un giocatore (borsa dei vestiti, /clearbags)
Notify(message, type)ClientMessaggio sul client (es. troppo lontano, nessun modello freemode nello studio tatuaggi)
HelpNotify(text)ClientTesto di aiuto nel cerchio davanti al negozio, al barbiere e allo studio tatuaggi (predefinito: ESX.ShowHelpNotification)

La versione server invia il messaggio direttamente tramite ESX. Se usi un tuo script di notifiche, adatta entrambe le funzioni Notify.

Lingue

Tutti i testi si trovano in config/locales/<lingua>.json, valuta e formato dei numeri sotto ui (currency, intl). Per una tua lingua copia un file, traducilo e imposta serverInfo.locale. I segnaposto come %d e {price} devono restare. I nomi delle categorie si trovano in config/settings/config.categories.lua (label). I nomi delle categorie del barbiere e delle zone del corpo si trovano sotto ui.barber.groups e ui.tattoo.zones, i nomi dei tatuaggi arrivano da GTA nella lingua del gioco.

In gioco

Negozio

Premi E nel cerchio davanti al negozio, ESCI o ESC chiude.

  • Abbigliamento: cambia i capi e salvali come outfit.
  • Salvati: indossa, rinomina, condividi ed elimina i tuoi outfit.
  • Condivisi: indossa gli outfit di altri giocatori.

Borsa dei vestiti

  • Posare: usa l'item clothbag nell'inventario, la borsa viene posata a terra davanti a te. Non funziona in un veicolo, da morto o in un'altra dimensione.
  • Sopra la borsa compare [E] Usa. Il proprietario vede anche [H] Raccogli. Se il proprietario è offline, tutti vedono [H] Raccogli.
  • E apre a sinistra una lista dei tuoi outfit salvati. Indossa ti mette l'outfit, la lista resta aperta. ESC o ESCI la chiude, così come quando ti allontani.
  • H rimette la borsa nel tuo inventario. Puoi cambiare il tasto nelle associazioni tasti di FiveM.

Barbiere

Premi E nel cerchio davanti al barbiere. Cappello e maschera vengono tolti per l'anteprima, la telecamera mostra la testa.

  • Scegli la categoria in alto: Capelli, Barba, Sopracciglia, Peli del petto, Trucco, Fard o Rossetto.
  • Cambia Forma e Variante con le frecce o cliccando sul numero, Opacità con il cursore, Colore e Colpi di sole nella tavolozza dei colori.
  • Trascinare ruota il personaggio, la rotellina del mouse fa lo zoom.
  • Paga mostra il costo (prezzo × categorie modificate) e salva il look. Annulla, ESCI o ESC ripristina tutto ciò che non è ancora pagato.

Studio tatuaggi

Premi E nel cerchio davanti allo studio. Il personaggio viene svestito per l'anteprima, i vestiti tornano quando esci.

  • Scegli la zona in alto, la telecamera si sposta lì. Il numero mostra i tatuaggi fatti / tutti quelli della zona.
  • Un clic su un tatuaggio lo mostra in anteprima sul personaggio, un altro clic lo nasconde. Cerca tatuaggio filtra per nome, I miei mostra solo quelli fatti.
  • Tatua acquista il tatuaggio, Rimuovi toglie un tatuaggio fatto al prezzo di rimozione.
  • Fatto, ESCI o ESC chiude lo studio.

Comandi

ComandoChiCosa succede
/clearbagsGruppi di clearGroups, console del serverElimina tutte le borse posate. I proprietari online riavranno il loro item. Le borse dei giocatori offline vengono solo eliminate.

Console

All'avvio lo script controlla la configurazione e segnala errori e avvisi nella console del server. Se è tutto a posto, lì compare «è stato avviato correttamente». Se questo messaggio manca, leggi gli errori sopra, correggili e riavvia. Anche quando l'item clothbag viene creato, la console lo segnala. Se il barbiere o lo studio tatuaggi è attivo ma senza locations, compare un avviso.

Problemi comuni

ProblemaSoluzione
Con E non succede nienteMettiti al centro del cerchio. skinchanger ed esx_skin devono avviarsi prima.
Il cerchio fluttua o è nel terrenoRegola l'altezza (z) in locations.
Look perso dopo la riconnessioneSolo salvare o indossare mantiene il look, scartare ripristina tutto.
La categoria mostra solo 0 variantiIl capo non esiste per il tuo modello di personaggio (GTA o addon di abbigliamento).
La borsa è invisibileControlla model in config/settings/config.bag.lua, l'oggetto deve esistere in GTA.
Manca l'item clothbagControlla la console. Se l'item non viene creato, aggiungilo a mano nella tabella items.
Manca [H] RaccogliSolo il proprietario può raccogliere. Gli altri solo quando il proprietario è offline.
H non raccoglie nienteNelle associazioni tasti di FiveM controlla se per «Raccogli la borsa dei vestiti» è impostato un altro tasto.
«Hai già posato una borsa.»Prima raccogli la tua borsa o aumenta max.
Tatuaggi mancanti dopo un cambio di skinVengono riapplicati automaticamente poco dopo. Non usare altri script che impostano tatuaggi da soli.
«I tatuaggi sono disponibili solo per i personaggi normali»Solo mp_m_freemode_01 e mp_f_freemode_01 hanno tatuaggi.
Barba e peli del petto mancanti dal barbiereNascosti per i personaggi femminili, come in GTA Online.
Look del barbiere perso dopo la riconnessioneSolo Paga salva il look, annullare lo ripristina.

Non l’hai ancora acquistato?

Vedi Clothingstore nel negozio