FlexHour

FlexHour è un sistema di orologi di lusso per FiveM. I giocatori comprano orologi da una commessa in boutique, li configurano, li indossano, li sfoggiano, li portano in assistenza e li scambiano. Accanto gira un intero mercato di falsi.

• Circa 10.000 righe di codice
• 23 modelli di orologi e 25.754 combinazioni possibili
• 14 edizioni limitate numerate
• 708 modelli di componenti e 399 texture (256x256)

Il prodotto è composto da due risorse: concept_flexhour (lo script) e flexhour_boutique (l'interno della boutique, in cui si entra a piedi). La boutique ha una sua guida: Boutique FlexHour.

Consegna

FlexHour usa Cfx Asset Escrow. Dopo il pagamento su Tebex, le risorse compaiono su Keymaster in Granted Assets, sull'account Cfx.re con cui hai effettuato l'accesso al checkout.

• concept_flexhour e flexhour_boutique arrivano con lo stesso acquisto, come due download separati. Scaricali e installali entrambi.
• Non rinominare le cartelle. Gli oggetti e le altre risorse chiamano lo script concept_flexhour. Se rinomini la cartella, ottieni No such export useBox in resource concept_flexhour.
• config.lua e i file locales/ restano modificabili. Il resto è protetto da escrow.

Requisiti

Installazione

1. Metti concept_flexhour e flexhour_boutique nella cartella resources.
2. Aggiungili a server.cfg dopo le loro dipendenze. Il bridge carica i suoi moduli da ciò che è già in esecuzione, quindi avvialo dopo framework, inventario e target:

ensure ox_lib
ensure oxmysql
ensure your_framework          # es_extended / qb-core / qbx_core / ox_core
ensure ox_inventory            # or your inventory
ensure ox_target               # or your target
ensure concept_bridge
ensure concept_flexhour
ensure flexhour_boutique       # the boutique interior, after concept_flexhour
add_ace group.admin flexhour.admin allow

3. Registra gli oggetti (vedi Oggetti) e copia le immagini.
4. Avvia il server. Le tabelle del database vengono create automaticamente.
5. Da admin, esegui /fhmodels. Elenca i modelli di orologi non in streaming. Se l'elenco è vuoto, la cartella stream/ è completa.

Oggetti

Ogni modello di orologio è un oggetto a sé, chiamato fh_. La configurazione è salvata nei metadati dell'oggetto: metallo della cassa, quadrante, lunetta, pietre, numero di serie, incisione e condizione. Negozi, scambi e altri script possono consegnare un modello specifico.

ox_inventory

1. Incolla docs/ox_items.lua (tutti i 23 modelli) in ox_inventory/data/items.lua.
2. Aggiungi la scatola e il kit replica:

['flexhour_box'] = {
    label = 'FlexHour Box',
    weight = 450,
    stack = false,
    close = true,
    description = 'Something shiny inside.',
    client = { export = 'concept_flexhour.useBox' },
},
['flexhour_replica_kit'] = {
    label = 'Replica Kit',
    weight = 900,
    stack = true,
    close = true,
    description = 'Blank case, cheap movement, dial stencils, gold plating. Not from any boutique.',
},

3. Copia web/img/*.png e web/img/items/*.png in ox_inventory/web/images/. Ci sono 78 icone di orologi: una per ogni modello e materiale della cassa, più una per ogni edizione limitata. Ogni orologio punta alla propria icona tramite metadata.image.

Inventari stile qb

Aggiungi gli oggetti da docs/qb_items.lua (formato QBCore). FlexHour li registra come utilizzabili all'avvio. Su questi inventari l'oggetto mostra nome e immagine del modello. I dettagli della configurazione sono nel campo info dell'oggetto e nella vista di osservazione (I mentre indossi l'orologio).

Framework, inventari e target

FlexHour raggiunge il framework (soldi, identità, lavori), l'inventario, il target e le notifiche tramite concept_bridge.

Configurazione

config.lua contiene tutte le impostazioni che un server può cambiare. Modifica un valore e riavvia la risorsa. Se ometti un'impostazione, FlexHour usa il suo valore predefinito. Ciò che non è un'impostazione non può essere sovrascritto da config.lua.

Generale

Commesse

Config.Clerks è l'elenco delle commesse della boutique. La commessa inclusa si trova a Vinewood con il modello a_f_y_business_02, lo scenario WORLD_HUMAN_STAND_IMPATIENT, un blip (sprite 617, colore 46, scala 0.8), e vende i livelli budget, mid, luxury e mythic.

Se flexhour_boutique è attiva, la sua commessa sta dietro il bancone della boutique. Quella posizione è salvata in data/clerks.json, che ha la precedenza su config.lua. Se usi FlexHour senza la boutique, apri /fhclerk e scegli Put the config.lua clerks back.

Trattativa (Config.Negotiate)

Assistenza (Config.Services)

Edizioni limitate (Config.Limited)

Config.Limited stabilisce quanti esemplari di ogni modello limitato possono esistere in tutto. Vedi Edizioni limitate.

Indossare (Config.Wear)

Rapina (Config.Wear.rob)

Falsi (Config.Fakes)

Per posizionare i tre punti in gioco, usa /fhfake dealer, /fhfake workshop o /fhfake fence. I punti posizionati vengono salvati in data/fakes.json, che ha la precedenza su config.lua.

Lingue

Tutto ciò che leggono i giocatori viene da locales/.json: notifiche, menu, la pagina del negozio (ui_*), le carte della trattativa (card_*), gli indizi della commessa (tell_*) e ciò che dicono commesse, ricettatore e venditore di kit (neg_*).

Lingue incluse: inglese (en), ungherese (hu), tedesco (de), spagnolo (es) e francese (fr). FlexHour usa l'impostazione della lingua di ox_lib. Mettila in server.cfg:

setr ox:locale "en"   # or "hu", "de", "es", "fr"

Per aggiungere una lingua, copia en.json in .json e traduci i valori. Gli indovinelli della trattativa sono conservati lato server in tutte e cinque le lingue. I nomi di orologi, materiali e cinturini sono nomi di prodotto e non vengono tradotti.

Comandi

Giocatori

Il gizmo di regolazione funziona così:

• Trascina le maniglie rossa, verde e blu per spostare l'orologio.
• TAB passa alla rotazione, e anche al ridimensionamento se allowScale è attivo.
• Trascina nello spazio vuoto per ruotare la camera. Scorri per lo zoom.
• H sposta l'orologio sull'altro polso. R lo reimposta.
• ENTER salva la regolazione. BACKSPACE annulla.

Admin (flexhour.admin)

Permessi

Gli strumenti admin controllano l'ACE in Config.AdminAce (predefinito flexhour.admin):

add_ace group.admin flexhour.admin allow

Prima che entrino i giocatori, assicurati che Config.AdminOpenToAll sia false. Con true ogni giocatore è admin: può darsi orologi e piazzare commesse e vetrine, e la riga ACE non serve a nulla. Finché è attivo, la console stampa un avviso rosso a ogni avvio.

Funzionalità

Acquisto e configuratore

La commessa apre il negozio. Il giocatore sceglie un modello, poi il metallo della cassa, il quadrante, il cinturino e il suo colore, la lunetta, le lancette e il livello di pietre. Ogni livello ha le sue opzioni. Il giocatore può provare l'orologio per TryOnSeconds, poi comprarlo, o prima contrattare. Con Delivery = 'box' l'orologio arriva in una flexhour_box. Usare la scatola avvia un rituale di unboxing sul bancone, e il giocatore tiene la scatola in mano finché non la mette via con X.

Ogni orologio autentico riceve un numero di serie unico (FH-…), salvato nel registro (flexhour_serials).

Trattativa

A ogni sessione ogni commessa riceve una personalità nascosta fatta di cinque tratti: vanità, avidità, orgoglio, lealtà e nervosismo. Il linguaggio del corpo dà indizi. Il giocatore gioca carte come Complimento, Contanti, Offerta al ribasso, Bluff, Cliente abituale, Concorrente, Pacchetto e Storia, e affronta round misti di lettura della commessa, indovinelli e un gioco di memoria. Il risultato è l'offerta finale. Il venditore di kit e il ricettatore usano allo stesso modo un mazzo da strada.

Vetrine

Gli admin piazzano vetrine con /fhstand e riforniscono ogni cuscino dal menu della vetrina. Le vetrine vendono al prezzo del cartellino, che deve essere tra il 70% e il 160% del prezzo di listino, e hanno scorte illimitate. Con una vetrina entro 30 m da una commessa si può contrattare con quella commessa. In questa versione i giocatori non possono possedere vetrine, e le edizioni limitate non possono esservi esposte.

Indossare e sfoggiare

Un giocatore indossa un orologio alla volta, su uno dei due polsi. Le regolazioni integrate coprono i personaggi freemode. Per i ped personalizzati gli admin salvano una regolazione per modello di ped, e i giocatori possono affinare la propria. Gli altri giocatori vedono l'orologio da vicino: lancette in tempo reale, riflessi e pietre che brillano di notte. Le azioni del giocatore sono flex, osserva e manica.

Assistenza

La commessa offre cambio cinturino, ridoratura, pietre, incisione, lucidatura e autenticazione. L'autenticazione dà a un orologio autentico documenti validi per authDays giorni. Su una replica, l'autenticazione mostra che è falsa.

Edizioni limitate

Esistono 14 pezzi numerati. Ognuno è una configurazione fissa, con un quadrante, una finitura o un cinturino che nessun orologio standard può avere. Il server limita quanti ne esistono, e ogni acquirente riceve il proprio numero (per esempio «No. 3 / 10»). Quando tutti i pezzi sono venduti, l'edizione esce dal negozio. Le commesse le vendono nel gruppo Limited editions dell'elenco.

Su un'edizione limitata sono consentiti pietre, incisione e lucidatura. Cambio cinturino e ridoratura vengono rifiutati, così il pezzo resta originale.

Falsi

Il mercato dei falsi funziona in tre passaggi:

1. Venditore: vende un kit replica per un orologio casuale. Il kit decide modello, finitura, quadrante e colore del cinturino. Il giocatore può contrattare, ma infastidire il venditore fa salire il prezzo.
2. Laboratorio: il giocatore costruisce la copia su un banco nascosto giocando a un minigioco. Usare l'orologio autentico come riferimento dà una copia migliore.
3. Ricettatore: compra qualsiasi orologio senza fare domande. Il prezzo dipende da qualità e condizione. Alcune vendite vengono segnalate alla polizia.

Una replica sembra vera nell'inventario, ma il suo numero di serie non è nel registro, e più bassa è la qualità, più indizi mostra: stampa del quadrante storta, ora che deriva, lancetta dei secondi che scatta o si ferma, usura più rapida e doratura che si consuma.

Orologi indossati

Con il predefinito Config.Wear.keepWorn = false, un orologio è sempre un oggetto dell'inventario, anche mentre è indossato. Resta nel suo slot, e tutto ciò che succede all'inventario succede anche all'orologio: svuotamento alla morte, perquisizione o un altro script di rapina.

Con keepWorn = true, indossare un orologio lo toglie dall'inventario e FlexHour lo tiene in flexhour_wrist. Toglierlo lo fa tornare un oggetto. Mentre è indossato, niente di ciò che succede all'inventario può prenderlo: svuotamento alla morte, confisca, perquisizione, abbandono, deposito o bagagliaio. Per vendere, regalare, depositare o portare in assistenza l'orologio, il giocatore deve prima toglierlo con /watch.

Se riporti keepWorn a false, ogni personaggio riceve l'orologio indossato nell'inventario al prossimo accesso.

Rapina

Un orologio indossato si può prendere in un solo modo: con la rapina di FlexHour. Un giocatore accanto a chi lo indossa ed è morto, ha le mani alzate o è ammanettato può prendere l'orologio con l'opzione del target, il prompt [E] o /stealwatch. Lo stesso orologio, con lo stesso numero di serie, finisce nelle tasche del rapinatore. Altre risorse possono reagire all'evento flexhour:watchRobbed.

Gli orologi di GTA

I menu dei vestiti del gioco possono mettere un orologio al polso sinistro (slot prop 6) o un bracciale al polso destro (slot 7). Con gameWatch = 'hide', l'accessorio di GTA viene tolto mentre un orologio FlexHour è su quel polso. Se nel frattempo un menu dei vestiti salva l'outfit, questo viene salvato senza quell'accessorio. Togli l'orologio FlexHour prima di salvare un outfit, oppure imposta gameWatch su 'off'.

Export ed eventi

Export server

-- Give a player a watch. build = { base = '', material = ..., dial = ..., strap = ..., iced = 0 }
-- Only base is required; anything you leave out or set to something invalid falls back to that model's defaults.
-- boxed = true (default) delivers it in a flexhour_box. Returns true, serial.
local ok, serial = exports.concept_flexhour:GiveWatch(source, { base = 'timor_basic' }, true)

-- Release the watch a deleted or banned character was wearing (keepWorn = true).
-- identifier = the character id from your framework (the owner column of flexhour_wrist), or an online player's server id.
-- Returns true, serial, or false when nothing was on that wrist.
local released, serial = exports.concept_flexhour:ReleaseWrist(identifier)

Gli id dei modelli sono in shared/catalog.lua (FH.BaseOrder). Funziona anche il nome dell'oggetto senza il prefisso fh_.

Export client (uso dell'oggetto)

concept_flexhour.useBox e concept_flexhour.useWatch sono gli export degli oggetti che l'inventario chiama. Non devi chiamarli tu.

Eventi server

AddEventHandler('flexhour:watchRobbed', function(robber, victim, serial, build)
    -- log it, alert the police, ...
end)

Database

Le tabelle vengono create al primo avvio:

Prestazioni

FlexHour costruisce solo ciò che puoi effettivamente vedere. I limiti sono fissi:

• Gli orologi degli altri giocatori vengono costruiti entro 40 m, al massimo 40 alla volta.
• Il dettaglio completo (quadrante, lancette, pietre, lunetta) viene disegnato solo per i 12 orologi più vicini entro 18 m.
• Gli orologi delle vetrine compaiono entro 40 m, al massimo 60 alla volta.
• I prop vengono generati in piccoli gruppi (8 per frame) per evitare scatti.

Risoluzione dei problemi

Dopo un crash del server

Un inventario non scrive subito ogni modifica nel database, quindi un crash brusco può riportarlo indietro di qualche minuto.

• ox_inventory: gestito con esattezza. FlexHour annulla ogni indossare o togliere che ox_inventory non aveva ancora salvato.
• qb-inventory, ps-inventory, jpr-inventory, lj-inventory: gestito con esattezza. L'inventario salva a ogni indossare e togliere.
• Altri inventari: un orologio indossato o tolto subito prima di un crash può risultare duplicato o mancante.

Spegni il server da txAdmin, non chiudendo la finestra.

Prima di andare online

• Assicurati che Config.AdminOpenToAll sia false.
• Assicurati che /fhmodels non elenchi nulla.
• Assicurati che la lingua sia impostata (setr ox:locale).
• Se usi la boutique, assicurati che flexhour_boutique parta dopo concept_flexhour.

Supporto e aggiornamenti

• Discord: discord.gg/HPTZzHHwe6. Apri un ticket indicando framework, inventario e l'errore della console.
• Gli aggiornamenti sono gratuiti a vita. Scarica la nuova versione da Keymaster. Ogni release è elencata nella scheda Novità della pagina del prodotto.