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

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

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

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

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

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

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

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

Config.Framework correspond 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.Locale est 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.