Personnalisation

Presque tout est réuni dans un seul fichier court. Le reste du code Lua est également laissé ouvert, ce qui vous permet de modifier le comportement interne si nécessaire.

Quel fichier décide de quoi

Fichier ou dossier	Ce qu’il décide	Modifiable ?
`config.lua`	Framework, langue, touche et commande de menu, liste des oiseaux	Ouvert
`locales/*.lua`	Textes des notifications, un fichier par langue	Ouvert
`client/utils.lua`	Affichage des notifications selon le framework	Ouvert
`client/client.lua`	Touche du menu, commande `/parrot` et action de chaque bouton du menu	Ouvert
`client/bird_management.lua`	Vol d’arrivée, atterrissage, déplacements, suivi et départ de l’oiseau	Ouvert
`server/server.lua`	Enregistrement de chaque oiseau comme item utilisable et synchronisation entre joueurs	Ouvert
`html/`	Le menu Bird Companion : `index.html`, `style.css`, `script.js` et les icônes dans `html/img/`	Fichiers bruts
`stream/`	Les neuf modèles d’oiseaux personnalisés	Assets
`flight.meta`	Les données de ped pour les neuf oiseaux personnalisés	Données
`inventory_images/`	Les quatorze icônes d’items	Assets
`readme.md`	Lignes d’items prêtes à l’emploi pour ox_inventory, QBCore et ESX	Référence

locales/main.lua est le seul fichier Lua sous escrow.

Paramètres généraux — `config.lua`

Option	Ce qu’elle fait	Défaut
`Config.Framework`	`esx`, `qb-core` ou `qbox`. Détermine l’enregistrement des items et les notifications	`esx`
`Config.Locale`	Langue des notifications : `en`, `es`, `de`, `fr`, `it`, `pl`, `pt`, `ru`, `tr`	`en`
`Config.MenuKey`	Index de commande FiveM qui ouvre le menu. `303` correspond à U	`303`
`Config.OpenMenuCommand`	Commande de chat qui ouvre le menu	`parrot`
`Config.NoActiveBirdNotification`	Afficher un message si quelqu’un essaie d’ouvrir le menu sans oiseau actif	`false`

Config.MenuKey est un numéro de contrôle FiveM, et non une lettre. La liste des numéros se trouve sur la documentation des contrôles FiveM. Comme cette touche est lue directement, les joueurs ne peuvent pas la réassigner dans leurs paramètres personnels ; la commande chat reste toujours disponible comme alternative.

Les oiseaux — `Config.BirdItems`

Une liste associant nom d’item → modèle de ped. Chaque entrée devient un item utilisable au démarrage du serveur.

Item	Modèle
`crow`	`a_c_crow`
`pigeon`	`a_c_pigeon`
`seagull`	`a_c_seagull`
`cormorant`	`a_c_cormorant`
`chickenhawk`	`a_c_chickenhawk`
`macaw`	`Macaw`
`parrot`	`Parrot`
`falcon`	`Falcon`
`vulture`	`Vulture`
`eagle`	`Eagle`
`owl`	`Owl`
`hornbill`	`Hornbill`
`sparrow`	`Sparrow`
`warbler`	`Warbler`

Ajouter un oiseau

Ajoutez une ligne à Config.BirdItems avec le nom de votre nouvel item et le modèle de ped qu’il doit faire apparaître.
Ajoutez l’item à votre inventaire de la même façon que les autres (voir Installation) et attribuez-lui une icône.
Un oiseau du jeu de base (tout modèle commençant par a_c_…) ne nécessite rien d’autre.
Un oiseau personnalisé nécessite ses fichiers de modèle dans stream/ et sa propre entrée dans flight.meta, à la suite des neuf déjà présentes. Sans l’entrée flight.meta, le modèle charge mais ne se comportera pas comme un oiseau.
Faites refresh, puis restart mic_parrots.

Supprimer un oiseau

Supprimez sa ligne dans Config.BirdItems. L’item cessera toute action ; retirez-le également de votre inventaire afin que personne ne conserve un item inactif.

Le menu — `html/`

Les libellés du menu (Bird Companion, Shoulder, Head, Dismiss, Follow, Close) sont codés en dur dans html/index.html et non dans les fichiers de locales. Traduisez-les ou renommez-les directement à cet endroit. Les couleurs et la disposition sont dans html/style.css, et les icônes de boutons sont les PNGs dans html/img/.

html/index.html contient également deux boutons commentés, Dance et Sing. Aucune action ne leur est associée côté Lua, laissez-les donc commentés.

La touche Échap ou le bouton Close ferme le menu.

Langues

Neuf langues sont fournies, avec un fichier chacune dans locales/ : en, es, de, fr, it, pl, pt, ru, tr. Choisissez-en une via Config.Locale.

Chaque fichier contient six messages : pas de permission, possède déjà un oiseau, pas d’oiseau sur l’épaule, oiseau déjà sur l’épaule, oiseau déjà sur la tête, et nécessité d’avoir un oiseau actif pour ouvrir le menu.

Pour ajouter une langue : copiez locales/en.lua vers un nouveau fichier (par exemple locales/nl.lua), changez la clé de langue en tête de fichier de en vers nl, traduisez les six textes, et ajoutez le nouveau fichier aux deux listes client_scripts et server_scripts dans fxmanifest.lua. Réglez ensuite Config.Locale sur nl, faites un refresh et redémarrez.

Notifications

Le fichier client/utils.lua prend en charge l’envoi de toutes les notifications : ESX.ShowNotification sur ESX, QBCore.Functions.Notify sur QBCore, l’export de notification QBox sur QBox, et le fil d’actualité standard de GTA pour tout le reste. Remplacez le corps de cette fonction pour rediriger les messages vers votre propre ressource de notification.

Commandes

Commande ou touche	Ce qu’elle fait	Définie dans
`/parrot`	Ouvre le menu Bird Companion lorsqu’un oiseau est sorti	`Config.OpenMenuCommand`
U	Même action que la commande	`Config.MenuKey`