
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.
- 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.
/clearbagsrimuove 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
- Metti la cartella
off_clothingstorenella tua cartellaresources. - Nel
server.cfg, dopo oxmysql, ESX e skinchanger:
ensure oxmysql
ensure es_extended
ensure skinchanger
ensure esx_skin
ensure off_clothingstore- Rimuovi
esx_clotheshopo altri negozi di abbigliamento negli stessi punti.
Al primo avvio lo script crea automaticamente:
- le tabelle
off_clothing_outfits,off_clothing_bagseoff_clothing_tattoos - l'item
clothbagnella tabellaitems, se manca
Configurazione
config/settings/config.lua
| Opzione | Predefinito | Descrizione |
|---|---|---|
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.design | 3 | Design dell'interfaccia: 1 = Classico, 2 = Scontrino, 3 = Storefront |
blur | true | Sfondo sfocato finché il menu della borsa è aperto. Il negozio resta nitido, perché lì vedi il tuo personaggio |
outfitPrice | 250 | Prezzo per outfit salvato (contanti), 0 = gratis |
maxOutfits | 25 | Max. outfit per personaggio |
marker | Disco, 3 m | Cerchio: type, size (area per aprire), drawDistance, color, alpha |
blip | Icona 73 | Icona sulla mappa (enabled, sprite, color, scale) |
locations | 14 negozi | Centro del cerchio a terra come vec3 |
barber | attivo, 7 posizioni | Barbiere, vedi sotto |
tattoo | attivo, 6 posizioni | Studio 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.
{ icon = 'shoes', label = 'Schuhe', variant = 'shoes_1', color = 'shoes_2', camOffset = vec3(0, 0.9, -0.8) },| Campo | Descrizione |
|---|---|
icon | bag, chain, earrings, glasses, gloves, hat, jacket, mask, ring, shirt, shoes, shorts, vest, watch o un'icona Phosphor con ph- |
label | Nome nel negozio |
variant / color | Valori skinchanger per Variante e Stile |
camOffset | Telecamera: x = sinistra/destra, y = distanza in avanti, z = altezza |
config/settings/config.bag.lua – Borsa dei vestiti
| Opzione | Predefinito | Descrizione |
|---|---|---|
enabled | true | false = borsa dei vestiti disattivata del tutto (niente item, niente borse) |
item | 'clothbag' | Nome dell'item, viene creato all'avvio nella tabella items |
weight | 1 | Peso dell'item |
model | 'prop_cs_heist_bag_02' | Oggetto della borsa a terra |
max | 1 | Quante borse un giocatore può posare contemporaneamente |
distance | 2.0 | Distanza 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.
barber = {
enabled = true,
price = 150,
blip = { enabled = true, sprite = 71, color = 0, scale = 0.8 },
locations = { vec3(-814.3, -183.8, 36.6), ... },
},| Opzione | Predefinito | Descrizione |
|---|---|---|
enabled | true | false = barbiere o studio tatuaggi disattivato del tutto |
price | 150 / 500 | Barbiere: prezzo per categoria modificata · Studio tatuaggi: prezzo per tatuaggio, 0 = gratis |
removePrice | 250 | Solo studio tatuaggi: prezzo per rimuovere un tatuaggio, 0 = gratis |
blip | Icona 71 / 75 | Icona sulla mappa (enabled, sprite, color, scale) |
locations | 7 / 6 posizioni | Centro 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.
| Funzione | Lato | A cosa serve |
|---|---|---|
Notify(source, message, type) | Server | Messaggio a un giocatore (borsa dei vestiti, /clearbags) |
Notify(message, type) | Client | Messaggio sul client (es. troppo lontano, nessun modello freemode nello studio tatuaggi) |
HelpNotify(text) | Client | Testo 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
clothbagnell'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
| Comando | Chi | Cosa succede |
|---|---|---|
/clearbags | Gruppi di clearGroups, console del server | Elimina 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
| Problema | Soluzione |
|---|---|
| Con E non succede niente | Mettiti al centro del cerchio. skinchanger ed esx_skin devono avviarsi prima. |
| Il cerchio fluttua o è nel terreno | Regola l'altezza (z) in locations. |
| Look perso dopo la riconnessione | Solo salvare o indossare mantiene il look, scartare ripristina tutto. |
| La categoria mostra solo 0 varianti | Il capo non esiste per il tuo modello di personaggio (GTA o addon di abbigliamento). |
| La borsa è invisibile | Controlla model in config/settings/config.bag.lua, l'oggetto deve esistere in GTA. |
Manca l'item clothbag | Controlla la console. Se l'item non viene creato, aggiungilo a mano nella tabella items. |
| Manca [H] Raccogli | Solo il proprietario può raccogliere. Gli altri solo quando il proprietario è offline. |
| H non raccoglie niente | Nelle 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 skin | Vengono 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 barbiere | Nascosti per i personaggi femminili, come in GTA Online. |
| Look del barbiere perso dopo la riconnessione | Solo Paga salva il look, annullare lo ripristina. |
Non l’hai ancora acquistato?
Vedi Clothingstore nel negozio