FlexHour

FlexHour est un système de montres de luxe pour FiveM. Les joueurs achètent leurs montres auprès d'une vendeuse en boutique, les configurent, les portent, les exhibent, les font entretenir et les échangent. Tout un trafic de contrefaçons tourne à côté.

• Environ 10 000 lignes de code
• 23 modèles de montres et 25 754 combinaisons possibles
• 14 éditions limitées numérotées
• 708 modèles de pièces et 399 textures (256x256)

Le produit se compose de deux ressources : concept_flexhour (le script) et flexhour_boutique (l'intérieur de la boutique, où l'on entre à pied). La boutique a son propre guide : Boutique FlexHour.

Livraison

FlexHour utilise Cfx Asset Escrow. Après le paiement sur Tebex, les ressources apparaissent sur Keymaster dans Granted Assets, sur le compte Cfx.re avec lequel vous vous êtes connecté au paiement.

• concept_flexhour et flexhour_boutique arrivent dans le même achat, en deux téléchargements séparés. Téléchargez et installez les deux.
• Ne renommez pas les dossiers. Les objets et les autres ressources appellent le script concept_flexhour. Si vous renommez le dossier, vous obtenez No such export useBox in resource concept_flexhour.
• config.lua et les fichiers locales/ restent modifiables. Le reste est protégé par escrow.

Prérequis

Installation

1. Placez concept_flexhour et flexhour_boutique dans votre dossier resources.
2. Ajoutez-les à server.cfg après leurs dépendances. Le bridge charge ses modules depuis ce qui tourne déjà, alors démarrez-le après votre framework, votre inventaire et votre 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. Enregistrez les objets (voir Objets) et copiez les images.
4. Démarrez le serveur. Les tables de la base de données sont créées automatiquement.
5. En tant qu'admin, lancez /fhmodels. La commande liste les modèles de montres qui ne sont pas streamés. Si la liste est vide, le dossier stream/ est complet.

Objets

Chaque modèle de montre est un objet distinct, nommé fh_. La configuration est stockée dans les métadonnées de l'objet : métal du boîtier, cadran, lunette, sertissage, numéro de série, gravure et état. Les boutiques, les échanges et d'autres scripts peuvent donner un modèle précis.

ox_inventory

1. Collez docs/ox_items.lua (les 23 modèles) dans ox_inventory/data/items.lua.
2. Ajoutez l'écrin et le kit de réplique :

['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. Copiez web/img/*.png et web/img/items/*.png dans ox_inventory/web/images/. Il y a 78 icônes de montres : une par modèle et par matériau de boîtier, plus une par édition limitée. Chaque montre pointe vers sa propre icône via metadata.image.

Inventaires de type qb

Ajoutez les objets de docs/qb_items.lua (format QBCore). FlexHour les enregistre comme utilisables au démarrage. Sur ces inventaires, l'objet affiche le nom et l'image du modèle. Le détail de la configuration se trouve dans le champ info de l'objet et dans la vue d'examen (I pendant que la montre est portée).

Frameworks, inventaires et targets

FlexHour accède au framework (argent, identité, métiers), à l'inventaire, au target et aux notifications via concept_bridge.

Configuration

config.lua contient tous les réglages qu'un serveur peut modifier. Changez une valeur et redémarrez la ressource. Si vous omettez un réglage, FlexHour utilise sa valeur par défaut. Ce qui n'est pas un réglage ne peut pas être remplacé depuis config.lua.

Général

Vendeuses

Config.Clerks est la liste des vendeuses de boutique. La vendeuse fournie se tient à Vinewood avec le modèle a_f_y_business_02, un scénario WORLD_HUMAN_STAND_IMPATIENT, un blip (sprite 617, couleur 46, échelle 0.8), et vend les niveaux budget, mid, luxury et mythic.

Si flexhour_boutique tourne, sa vendeuse se tient derrière le comptoir de la boutique. Cette position est enregistrée dans data/clerks.json, qui a priorité sur config.lua. Si vous utilisez FlexHour sans la boutique, ouvrez /fhclerk et choisissez Put the config.lua clerks back.

Négociation (Config.Negotiate)

Services (Config.Services)

Éditions limitées (Config.Limited)

Config.Limited fixe combien d'exemplaires de chaque modèle limité peuvent exister au total. Voir Éditions limitées.

Port (Config.Wear)

Vol (Config.Wear.rob)

Contrefaçons (Config.Fakes)

Pour placer les trois lieux en jeu, utilisez /fhfake dealer, /fhfake workshop ou /fhfake fence. Les lieux placés sont enregistrés dans data/fakes.json, qui a priorité sur config.lua.

Langues

Tout ce que lisent les joueurs vient de locales/.json : notifications, menus, la page de la boutique (ui_*), les cartes de négociation (card_*), les indices de la vendeuse (tell_*) et ce que disent les vendeuses, le receleur et le vendeur de kits (neg_*).

Langues incluses : anglais (en), hongrois (hu), allemand (de), espagnol (es) et français (fr). FlexHour utilise le réglage de langue d'ox_lib. Mettez-le dans server.cfg :

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

Pour ajouter une langue, copiez en.json en .json et traduisez les valeurs. Les énigmes de négociation sont conservées côté serveur dans les cinq langues. Les noms des montres, matériaux et bracelets sont des noms de produits et ne sont pas traduits.

Commandes

Joueurs

Le gizmo de réglage fonctionne ainsi :

• Faites glisser les poignées rouge, verte et bleue pour déplacer la montre.
• TAB passe en rotation, et aussi en redimensionnement si allowScale est activé.
• Faites glisser dans le vide pour orbiter la caméra. Molette pour zoomer.
• H passe la montre à l'autre poignet. R la réinitialise.
• ENTER enregistre le réglage. BACKSPACE annule.

Admins (flexhour.admin)

Permissions

Les outils admin vérifient l'ACE de Config.AdminAce (par défaut flexhour.admin) :

add_ace group.admin flexhour.admin allow

Avant l'arrivée des joueurs, vérifiez que Config.AdminOpenToAll vaut false. Avec true, chaque joueur est admin : il peut se donner des montres et placer vendeuses et vitrines, et la ligne ACE ne sert à rien. Tant que c'est activé, la console affiche un avertissement rouge à chaque démarrage.

Fonctionnalités

Achat et configurateur

La vendeuse ouvre la boutique. Le joueur choisit un modèle, puis le métal du boîtier, le cadran, le bracelet et sa couleur, la lunette, les aiguilles et le niveau de sertissage. Chaque niveau a ses propres options. Le joueur peut essayer la montre pendant TryOnSeconds, puis l'acheter, ou négocier d'abord. Avec Delivery = 'box', la montre arrive dans un flexhour_box. Utiliser l'écrin joue un rituel de déballage sur le comptoir, et le joueur garde l'écrin en main jusqu'à le ranger avec X.

Chaque montre authentique reçoit un numéro de série unique (FH-…), enregistré dans le registre (flexhour_serials).

Négociation

Chaque vendeuse reçoit à chaque session une personnalité cachée faite de cinq traits : vanité, avidité, fierté, loyauté et nervosité. Le langage corporel donne des indices. Le joueur joue des cartes comme Compliment, Liquide, Prix cassé, Bluff, Habitué, Concurrent, Lot et Histoire, et enchaîne des manches mêlant lecture de la vendeuse, énigmes et jeu de mémoire. Le résultat est l'offre finale. Le vendeur de kits et le receleur utilisent de la même manière un jeu de cartes de rue.

Vitrines

Les admins placent des vitrines avec /fhstand et garnissent chaque coussin depuis le menu de la vitrine. Les vitrines vendent au prix de leur étiquette, qui doit être entre 70 % et 160 % du prix catalogue, et leur stock est illimité. Une vitrine à moins de 30 m d'une vendeuse peut être négociée avec celle-ci. Dans cette version, les joueurs ne peuvent pas posséder de vitrine, et les éditions limitées ne peuvent pas y être exposées.

Porter et exhiber

Un joueur porte une montre à la fois, à l'un ou l'autre poignet. Les réglages intégrés couvrent les personnages freemode. Pour les peds personnalisés, les admins enregistrent un réglage par modèle de ped, et les joueurs peuvent affiner le leur. Les autres joueurs voient la montre de près : aiguilles en direct, reflets et pierres qui brillent la nuit. Les actions du joueur sont le flex, l'examen et la manche.

Services

La vendeuse propose le changement de bracelet, le replaquage, le sertissage, la gravure, le polissage et l'authentification. L'authentification donne à une montre authentique un certificat valable authDays jours. Sur une réplique, l'authentification montre que c'est un faux.

Éditions limitées

Il existe 14 pièces numérotées. Chacune est une configuration fixe, avec un cadran, une finition ou un bracelet qu'aucune montre standard ne peut avoir. Le serveur plafonne le nombre d'exemplaires, et chaque acheteur reçoit son propre numéro (par exemple « No. 3 / 10 »). Une fois toutes les pièces vendues, l'édition quitte la boutique. Les vendeuses les vendent dans le groupe Limited editions de la liste.

Sur une édition limitée, le sertissage, la gravure et le polissage sont autorisés. Le changement de bracelet et le replaquage sont refusés, pour que la pièce reste d'origine.

Contrefaçons

Le trafic de contrefaçons fonctionne en trois étapes :

1. Vendeur de kits : vend un kit de réplique pour une montre au hasard. Le kit décide du modèle, de la finition, du cadran et de la couleur du bracelet. Le joueur peut marchander, mais agacer le vendeur fait monter le prix.
2. Atelier : le joueur fabrique la copie sur un établi caché en jouant à un mini-jeu. Utiliser la montre authentique comme modèle donne une meilleure copie.
3. Receleur : rachète n'importe quelle montre sans poser de questions. Le prix dépend de la qualité et de l'état. Certaines ventes sont signalées à la police.

Une réplique a l'air authentique dans l'inventaire, mais son numéro de série n'est pas dans le registre, et plus sa qualité est basse, plus elle se trahit : impression du cadran de travers, heure qui dérive, trotteuse saccadée ou arrêtée, usure plus rapide et placage or qui s'efface.

Montres portées

Avec la valeur par défaut Config.Wear.keepWorn = false, une montre est toujours un objet d'inventaire, même quand elle est portée. Elle reste dans son emplacement, et tout ce qui arrive à l'inventaire lui arrive aussi : effacement à la mort, fouille ou autre script de vol.

Avec keepWorn = true, mettre une montre la retire de l'inventaire et FlexHour la garde dans flexhour_wrist. La retirer la remet en objet. Pendant qu'elle est portée, rien de ce qui arrive à l'inventaire ne peut la prendre : effacement à la mort, confiscation, fouille, abandon, coffre ou coffre de véhicule. Pour vendre, offrir, ranger ou faire entretenir la montre, le joueur doit d'abord la retirer avec /watch.

Si vous repassez keepWorn à false, chaque personnage récupère sa montre portée dans son inventaire à sa prochaine connexion.

Vol

Une montre portée ne peut être prise que d'une seule façon : par le vol de FlexHour. Un joueur à côté d'un porteur mort, mains en l'air ou menotté peut prendre la montre avec l'option du target, l'invite [E] ou /stealwatch. La même montre, avec le même numéro de série, finit dans les poches du voleur. D'autres ressources peuvent réagir à l'événement flexhour:watchRobbed.

Les montres de GTA

Les menus de vêtements du jeu peuvent mettre une montre au poignet gauche (emplacement de prop 6) ou un bracelet au poignet droit (emplacement 7). Avec gameWatch = 'hide', l'accessoire GTA est retiré tant qu'une montre FlexHour est sur ce poignet. Si un menu de vêtements enregistre la tenue entre-temps, la tenue est enregistrée sans cet accessoire. Retirez la montre FlexHour avant d'enregistrer une tenue, ou réglez gameWatch sur 'off'.

Exports et événements

Exports serveur

-- 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)

Les identifiants de modèle se trouvent dans shared/catalog.lua (FH.BaseOrder). Le nom de l'objet sans le préfixe fh_ fonctionne aussi.

Exports client (utilisation d'objet)

concept_flexhour.useBox et concept_flexhour.useWatch sont les exports d'objet que l'inventaire appelle. Vous n'avez pas besoin de les appeler vous-même.

Événements serveur

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

Base de données

Les tables sont créées au premier démarrage :

Performances

FlexHour ne construit que ce que vous pouvez réellement voir. Les limites sont fixes :

• Les montres des autres joueurs sont construites dans un rayon de 40 m, 40 au maximum à la fois.
• Le détail complet (cadran, aiguilles, sertissage, lunette) n'est dessiné que pour les 12 montres les plus proches dans un rayon de 18 m.
• Les montres de vitrine apparaissent dans un rayon de 40 m, 60 au maximum à la fois.
• Les props apparaissent par petits lots (8 par image) pour éviter les à-coups.

Dépannage

Après un crash du serveur

Un inventaire n'écrit pas chaque changement immédiatement en base de données, donc un crash brutal peut le ramener quelques minutes en arrière.

• ox_inventory : géré exactement. FlexHour annule toute pose ou tout retrait qu'ox_inventory n'avait pas encore enregistré.
• qb-inventory, ps-inventory, jpr-inventory, lj-inventory : géré exactement. L'inventaire enregistre à chaque pose et retrait.
• Autres inventaires : une montre mise ou retirée juste avant un crash peut se retrouver dupliquée ou disparue.

Arrêtez le serveur via txAdmin, et non en fermant la fenêtre.

Avant la mise en ligne

• Vérifiez que Config.AdminOpenToAll vaut false.
• Vérifiez que /fhmodels ne liste rien.
• Vérifiez que la langue est définie (setr ox:locale).
• Si vous utilisez la boutique, vérifiez que flexhour_boutique démarre après concept_flexhour.

Support et mises à jour

• Discord : discord.gg/HPTZzHHwe6. Ouvrez un ticket avec votre framework, votre inventaire et l'erreur de la console.
• Les mises à jour sont gratuites à vie. Téléchargez la nouvelle version sur Keymaster. Chaque version est listée dans l'onglet Notes de version de la page produit.