Installation

Quinze minutes. Deux dossiers, quelques réglages et les items. Rien n’est stocké dans la base de données, il n’y a donc rien à importer pour la ressource elle-même.

Avant de commencer

Vous avez besoin de	Pourquoi
ESX, QBCore ou QBox, en cours d’exécution	Les items, les propriétaires et les jobs passent par lui
ox_target ou qb-target, en cours d’exécution	Chaque interaction avec une chicha ou une chaise posée
Les deux dossiers issus de votre achat : `mic_hookah` et `mic_hookah_prop`	Le script et les modèles de chichas
Accès à la liste des items et au dossier d’images de votre inventaire	Les chichas, les meubles, les consommables et les saveurs sont des items

1. Mettre les deux dossiers en place

Déposez mic_hookah et mic_hookah_prop dans vos ressources, par exemple dans resources/[mic]/.

mic_hookah_prop contient les dix modèles de chichas (mic_hookah_black … mic_hookah_yellow) et leur mic_hookah.ytyp. Il ne contient aucun code ; il sert uniquement de stream. Les tables et les chaises sont des modèles du jeu de base et ne nécessitent rien de plus.

2. Ordre de démarrage

Dans server.cfg, sous votre framework, votre inventaire et votre ressource de target, ajoutez ensure mic_hookah_prop puis ensure mic_hookah.

Cela fonctionne si les deux démarrent sans aucune ligne rouge en dessous.

3. Framework et target

Ouvrez config.lua :

Option	Définir sur	Par défaut
`Config.Framework`	`esx`, `qbcore` ou `qbox`	`esx`
`Config.Target`	`ox_target` ou `qb-target`	`ox_target`
`Config.ESXResourceName`	Le nom de dossier d’ESX, si vous l’avez renommé	`es_extended`
`Config.QBResourceName`	Le nom de dossier de QBCore, si renommé	`qb-core`
`Config.QBoxResourceName`	Le nom de dossier de QBox, si renommé	`qbx_core`
`Config.QBTargetResourceName`	Le nom de dossier de qb-target, si renommé	`qb-target`

Rien n’est détecté automatiquement ici : ces valeurs déterminent quel framework et quel target sont utilisés.

4. La base de données

Rien pour la ressource : les chichas et les meubles posés résident dans la mémoire du serveur, pas dans une table. Sur ESX avec l’inventaire par défaut, les items vont dans la table items — étape suivante.

5. Ajouter les items

La liste complète se trouve sur 🎒 Items. En résumé :

Item	Ce qu’il fait
`hookah_black`, `hookah_blue`, `hookah_green`, `hookah_grey`, `hookah_orange`, `hookah_pink`, `hookah_purple`, `hookah_red`, `hookah_skyblue`, `hookah_yellow`	Utilisez-le pour porter et poser cette chicha
`hookah_table` … `hookah_table5`	Utilisez-le pour poser une table
`hookah_chair` … `hookah_chair6`	Utilisez-le pour poser une chaise où s’asseoir
`hookah_coal`	Remplir le charbon depuis le menu de configuration
`hookah_water`	Remplir l’eau depuis le menu de configuration
`hookah_<flavour>_flavor`	Soixante saveurs, sélectionnables dans le menu

Où se trouvent les définitions prêtes à l’emploi, dans inventory_items/ à l’intérieur de mic_hookah :

Fichier	Pour	Que faire
`esx_items.sql`	ESX avec son inventaire par défaut	Importez-le une fois dans votre base de données
`ox_items.md`	ox_inventory	Collez ses lignes dans `ox_inventory/data/items.lua`
`qb_items.md`	QBCore / QBox avec qb-inventory	Collez ses lignes dans `qb-core/shared/items.lua`

Images : les icônes sont dans inventory_images/, un PNG par item nommé à l’identique. Copiez-les dans le dossier d’images de votre inventaire — ox_inventory/web/images/ ou qb-inventory/html/images/.

Faites ensuite pointer Config.InventoryImagePath vers ce même dossier, pour que les icônes de saveurs s’affichent dans le menu de configuration. Il est configuré par défaut sur nui://ox_inventory/web/images/ ; pour qb-inventory, utilisez nui://qb-inventory/html/images/.

Cela fonctionne si vous pouvez vous donner hookah_red et qu’elle s’affiche dans votre inventaire avec son image.

6. Premier test

Donnez-vous hookah_red, hookah_coal, hookah_water et hookah_mint_flavor.

Utilisez hookah_red. Votre personnage la tient sur un plateau. Appuyez sur E.
Un aperçu suit votre visée. Tournez-le avec la molette de la souris, montez-le ou descendez-le avec les flèches directionnelles, puis appuyez sur E pour le poser.
Ciblez la chicha avec le target et choisissez Open Setup Menu. Ajoutez du charbon, de l’eau, sélectionnez Mint, puis Light Hookah.
Fermez le menu, ciblez à nouveau la chicha et choisissez Grab Hose. Appuyez sur E.

Cela fonctionne si un tuyau relie la chicha à votre personnage et que, sur E, vous prenez une bouffée et de la fumée vert clair s’échappe. Le charbon et l’eau diminuent légèrement dans le menu à chaque bouffée.

Avant d’ouvrir votre ville

Décidez qui peut gérer les chichas. Config.AdminGroups est réglé sur false, ce qui permet à n’importe quel joueur d’ouvrir le menu et de ramasser n’importe quelle chicha ou meuble. Définissez vos groupes d’admins pour limiter cela au propriétaire et au staff. Voir Personnalisation.
Config.InventoryImagePath pointe bien vers le dossier d’images que vous utilisez réellement.
Stress : Config.Stress est activé, mais ReduceStress dans server_functions.lua est vide jusqu’à ce que vous y placiez votre propre appel.
Prévenez vos joueurs que les chichas et les meubles ne sont pas persistants : ils sont réinitialisés lors d’un redémarrage de la ressource ou du serveur.