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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « Ajouter un oiseau »- Ajoutez une ligne à
Config.BirdItemsavec 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 dansflight.meta, à la suite des neuf déjà présentes. Sans l’entréeflight.meta, le modèle charge mais ne se comportera pas comme un oiseau. - Faites
refresh, puisrestart mic_parrots.
Supprimer un oiseau
Section intitulée « 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/
Section intitulée « 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.
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
Section intitulée « 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
Section intitulée « 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 |