Aller au contenu

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.


Vous avez besoinPourquoi
ESX, QBCore ou QBox, en cours d’exécutionLes oiseaux sont des items utilisables, enregistrés via votre framework
Accès à la liste des items de votre inventaireQuatorze items doivent y figurer
Accès au dossier d’images de votre inventairePour que chaque item ait son icône

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.


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.


Ouvrez config.lua et configurez Config.Framework avec l’une des valeurs suivantes :

ValeurPour
esxESX (valeur par défaut)
qb-coreQBCore
qboxQBox

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.


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


Chaque nom d’item appelle un oiseau spécifique. Les noms d’items correspondent à la clé de gauche dans Config.BirdItems dans config.lua.

ItemOiseauModèle
crowCrowJeu de base
pigeonPigeonJeu de base
seagullSeagullJeu de base
cormorantCormorantJeu de base
chickenhawkChicken HawkJeu de base
macawMacawModèle streamé
parrotParrotModèle streamé
falconFalconModèle streamé
vultureVultureModèle streamé
eagleEagleModèle streamé
owlOwlModèle streamé
hornbillHornbillModèle streamé
sparrowSparrowModèle streamé
warblerWarblerModè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.


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.


  • 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.