Installation
Cinq minutes. Aucun fichier SQL dédié et aucune ressource secondaire : la seule manipulation en dehors du dossier consiste à ajouter les items d’oiseaux dans votre inventaire.
Avant de commencer
Section intitulée « Avant de commencer »| Vous avez besoin | Pourquoi |
|---|---|
| ESX, QBCore ou QBox, en cours d’exécution | Les oiseaux sont des items utilisables, enregistrés via votre framework |
| Accès à la liste des items de votre inventaire | Quatorze items doivent y figurer |
| Accès au dossier d’images de votre inventaire | Pour que chaque item ait son icône |
1. Mettez le dossier en place
Section intitulée « 1. Mettez le dossier en place »Déposez mic_parrots dans vos ressources, par exemple dans resources/[mic]/. Conservez le nom de dossier d’origine ; le menu communique avec la ressource en utilisant son propre nom.
Les neuf oiseaux personnalisés se trouvent dans le dossier stream/ et leurs paramètres de vol dans flight.meta. Les deux sont chargés automatiquement par le manifest ; vous n’avez pas besoin de les déplacer.
2. Démarrez-le après votre framework
Section intitulée « 2. Démarrez-le après votre framework »Dans server.cfg, placez ensure mic_parrots en dessous de votre framework (es_extended, qb-core ou qbx_core) et sous votre inventaire.
Vérification : le serveur démarre mic_parrots sans aucune ligne rouge.
3. Indiquez votre framework
Section intitulée « 3. Indiquez votre framework »Ouvrez config.lua et configurez Config.Framework avec l’une des valeurs suivantes :
| Valeur | Pour |
|---|---|
esx | ESX (valeur par défaut) |
qb-core | QBCore |
qbox | QBox |
Il n’y a pas d’auto-détection : cette valeur détermine la façon dont les items sont enregistrés et dont les notifications s’affichent.
4. La base de données
Section intitulée « 4. La base de données »Rien à importer pour la ressource elle-même. Sur ESX avec l’inventaire par défaut, les items résident dans la table items, vous les y ajouterez donc (étape suivante).
5. Ajoutez les items
Section intitulée « 5. Ajoutez les items »Chaque nom d’item appelle un oiseau spécifique. Les noms d’items correspondent à la clé de gauche dans Config.BirdItems dans config.lua.
| Item | Oiseau | Modèle |
|---|---|---|
crow | Crow | Jeu de base |
pigeon | Pigeon | Jeu de base |
seagull | Seagull | Jeu de base |
cormorant | Cormorant | Jeu de base |
chickenhawk | Chicken Hawk | Jeu de base |
macaw | Macaw | Modèle streamé |
parrot | Parrot | Modèle streamé |
falcon | Falcon | Modèle streamé |
vulture | Vulture | Modèle streamé |
eagle | Eagle | Modèle streamé |
owl | Owl | Modèle streamé |
hornbill | Hornbill | Modèle streamé |
sparrow | Sparrow | Modèle streamé |
warbler | Warbler | Modèle streamé |
Où trouver les définitions prêtes à l’emploi : le fichier readme.md à la racine de la ressource comporte trois blocs, un par inventaire :
- ox_inventory — le bloc destiné à
ox_inventory/data/items.lua. Collez-le dans ce fichier. - QBCore — le bloc destiné à
qb-core/shared/items.lua. Collez-le dans ce fichier. - ESX — le bloc intitulé “ITEMS FOR ESX SQL”. Exécutez-le une fois sur votre base de données.
Images : les quatorze icônes se trouvent dans le dossier inventory_images/, nommées d’après l’item (crow.png, eagle.png…). Copiez-les dans le dossier d’images de votre inventaire — pour ox_inventory il s’agit de ox_inventory/web/images/, pour qb-inventory qb-inventory/html/images/.
Vérification : donnez-vous un parrot et vérifiez qu’il apparaît dans votre inventaire avec son illustration.
6. Premier test
Section intitulée « 6. Premier test »Donnez-vous un oiseau et utilisez-le depuis l’inventaire.
Vérification : votre personnage siffle, un oiseau arrive par derrière et se pose sur votre épaule droite. Appuyez sur U (ou tapez /parrot) et le menu Bird Companion s’ouvre avec Shoulder, Head, Dismiss et Follow. Dismiss le renvoie et vous permet d’en appeler un autre.
Avant d’ouvrir votre serveur
Section intitulée « Avant d’ouvrir votre serveur »Config.Frameworkcorrespond bien à votre serveur. Une valeur incorrecte est la cause la plus courante d’un item inerte.- Les quatorze items existent bien, y compris
sparrow, et chacun possède son icône. Config.Localeest configuré sur la langue souhaitée pour les notifications.- La touche U est libre. Si un autre script utilise la touche U, modifiez
Config.MenuKey— voir Personnalisation.