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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « Avant d’ouvrir votre ville »- Décidez qui peut gérer les chichas.
Config.AdminGroupsest réglé surfalse, 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.InventoryImagePathpointe bien vers le dossier d’images que vous utilisez réellement.- Stress :
Config.Stressest activé, maisReduceStressdansserver_functions.luaest 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.