ZeroDev Sound : guide d'installation

Cette ressource ne contient ni ne fournit aucune intégration audio ou musicale tierce. La musique est lue uniquement à partir de fichiers audio que le propriétaire du serveur ajoute à la ressource et de la radio intégrée de GTA. Les joueurs ne peuvent pas saisir de liens. N'ajoutez que de l'audio dont vous êtes propriétaire ou dont vous détenez les droits d'utilisation et de diffusion ; diffuser du contenu en streaming sans autorisation peut enfreindre le Cfx.re Creator Platform License Agreement et la loi.

Des enceintes que les joueurs achètent, transportent, posent et relient, et de l'audio embarqué qu'ils montent dans leurs propres voitures. Ceci est la référence complète. Pour la version courte, lisez docs/SETUP.md (5 étapes) ; pour les problèmes, docs/TROUBLESHOOTING.md ; si vous venez de la 1.x, UPGRADING.md.

Sommaire 1. Prérequis 2. Installation 3. Items pour votre inventaire 4. Premier démarrage : ce que vous devez voir 5. Les réglages les plus souvent modifiés 6. Commandes 7. Audio embarqué 8. Sources musicales 9. Pulse Phone 10. Police, voisins et admins 11. Langues 12. Dépannage 13. Mise à jour

1. Prérequis

Rien d'autre : pas d'ox_lib, pas de clé API, pas de compte Google.

Serveurs Linux : utilisez l'artifact serveur Recommended, pas Latest. Sur la page de téléchargement du serveur FiveM (docs.fivem.net/docs/server-download/), choisissez Linux et la branche de mise à jour Recommended. Un serveur sur le dernier artifact Linux a planté au chargement (FXServer a affiché un dump /proc/self/maps), et passer à l'artifact recommandé a réglé le problème. C'est le seul signalement Linux que nous ayons ; nous n'avons pas encore fait tourner ZeroDev Sound nous-mêmes sur un serveur Linux.

Sur un serveur standalone (sans framework), tout est gratuit : la boutique et les pièces audio ne coûtent rien.

2. Installation

Étape 1. Déposez le dossier. Placez le dossier zerodev-sound dans votre dossier resources (n'importe quel sous-dossier convient, par exemple resources/[zerodev]/zerodev-sound). Gardez le nom de dossier zerodev-sound : les entrées d'items ox_inventory l'appellent par ce nom.

Étape 2. Ajoutez-le à server.cfg, après votre base de données, votre framework et votre inventaire :

ensure oxmysql
ensure es_extended        # or qb-core / qbx_core, or nothing on a standalone server
ensure ox_inventory       # or your inventory
ensure ox_target          # optional, or qb-target
ensure phone              # optional: Pulse Phone
ensure zerodev-sound

Étape 3. Donnez à vos admins la permission admin (pas de limite d'enceintes, la liste /soundadmin, arrêt et suppression à distance) :

add_ace group.admin zerodev.sound.admin allow

Étape 4. Configurez les items pour votre inventaire : section 3. Sur l'inventaire ESX et sur QBCore, c'est fait pour vous.

Étape 5. Redémarrez le serveur (un redémarrage complet, pas seulement la ressource, pour que chaque joueur charge les modèles) et vérifiez la console : section 4.

3. Items pour votre inventaire

Il y a 12 items : dix enceintes, le pied de micro et le kit de réparation.

Les images se trouvent dans zerodev-sound/web/img/items/. Vous n'avez jamais à deviner : dès que quelque chose manque, la console du serveur affiche les entrées exactes pour votre inventaire et nomme toute image qui n'est pas encore en place.

Quel inventaire avez-vous ?

Pour ajouter les items à qb-core à la main au lieu de laisser le script le faire, collez le bloc QBCore dans qb-core/shared/items.lua.

Un autre inventaire qui reprend l'une de ces API : définissez Config.Inventory sur celle-ci (voir la section 5). Un inventaire maison peut être connecté dans server/bridge.lua, qui est lisible : chaque inventaire y tient en trois petites fonctions (compter, ajouter, retirer).

Bloc ox_inventory

Collez à l'intérieur de la table return { ... } de ox_inventory/data/items.lua :

    ['zds_repair_kit'] = { label = 'Speaker Repair Kit', weight = 600, stack = false, close = true, description = 'Fixes a broken speaker. Use it next to one.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_repair_kit.png' } },
    ['zds_roam'] = { label = 'Roam Portable Speaker', weight = 2000, stack = false, close = true, description = 'Portable speaker with twin bass radiators. Carry it or set it down.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_roam.png' } },
    ['zds_room_ceiling'] = { label = 'Ceiling Speaker', weight = 2000, stack = false, close = true, description = 'Indoor. Round ceiling or wall speaker for background music in a business.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_ceiling.png' } },
    ['zds_room_shelf'] = { label = 'Shelf Speaker', weight = 4000, stack = false, close = true, description = 'Indoor. Bookshelf speaker: link several around a home or shop.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_shelf.png' } },
    ['zds_room_sub'] = { label = 'Home Subwoofer', weight = 8000, stack = false, close = true, description = 'Indoor. Cube subwoofer: link it to your indoor speakers for deep bass.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_sub.png' } },
    ['zds_room_tower'] = { label = 'Tower Speaker', weight = 10000, stack = false, close = true, description = 'Indoor. Floor-standing tower with two woofers: deep, clean sound for a whole room.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_tower.png' } },
    ['zds_stage_array'] = { label = 'Line Array Speaker', weight = 12000, stack = false, close = true, description = 'Concert. Line-array speaker for long throw over a big crowd. Stack them.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_array.png' } },
    ['zds_stage_mic'] = { label = 'Mic Stand', weight = 3000, stack = false, close = true, description = 'Concert. A mic on a boom stand: link it to your concert speakers, stand at it and sing through them (/soundmic).',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_mic.png' } },
    ['zds_stage_mixer'] = { label = 'DJ Mixer', weight = 5000, stack = false, close = true, description = 'Concert. Not a speaker: whoever stands at it runs every linked concert speaker (volume, bass, sound, timing).',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_mixer.png' } },
    ['zds_stage_monitor'] = { label = 'Stage Monitor', weight = 6000, stack = false, close = true, description = 'Concert. Wedge monitor so the DJ or band hears the mix on stage.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_monitor.png' } },
    ['zds_stage_pa'] = { label = 'PA Speaker', weight = 10000, stack = false, close = true, description = 'Concert. Powered 15" PA top on a tripod: link many for an event.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_pa.png' } },
    ['zds_stage_sub'] = { label = 'Concert Subwoofer', weight = 15000, stack = false, close = true, description = 'Concert. Double 18" sub cabinet: the bass you feel at a show.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_sub.png' } },

Bloc QBCore

Le format d'item QBCore, que lisent qb-, ps-, lj- et qs-inventory :

    ['zds_repair_kit'] = { name = 'zds_repair_kit', label = 'Speaker Repair Kit', weight = 600, type = 'item', image = 'zds_repair_kit.png', unique = true, useable = true, shouldClose = true, description = 'Fixes a broken speaker. Use it next to one.' },
    ['zds_roam'] = { name = 'zds_roam', label = 'Roam Portable Speaker', weight = 2000, type = 'item', image = 'zds_roam.png', unique = true, useable = true, shouldClose = true, description = 'Portable speaker with twin bass radiators. Carry it or set it down.' },
    ['zds_room_ceiling'] = { name = 'zds_room_ceiling', label = 'Ceiling Speaker', weight = 2000, type = 'item', image = 'zds_room_ceiling.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Round ceiling or wall speaker for background music in a business.' },
    ['zds_room_shelf'] = { name = 'zds_room_shelf', label = 'Shelf Speaker', weight = 4000, type = 'item', image = 'zds_room_shelf.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Bookshelf speaker: link several around a home or shop.' },
    ['zds_room_sub'] = { name = 'zds_room_sub', label = 'Home Subwoofer', weight = 8000, type = 'item', image = 'zds_room_sub.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Cube subwoofer: link it to your indoor speakers for deep bass.' },
    ['zds_room_tower'] = { name = 'zds_room_tower', label = 'Tower Speaker', weight = 10000, type = 'item', image = 'zds_room_tower.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Floor-standing tower with two woofers: deep, clean sound for a whole room.' },
    ['zds_stage_array'] = { name = 'zds_stage_array', label = 'Line Array Speaker', weight = 12000, type = 'item', image = 'zds_stage_array.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Line-array speaker for long throw over a big crowd. Stack them.' },
    ['zds_stage_mic'] = { name = 'zds_stage_mic', label = 'Mic Stand', weight = 3000, type = 'item', image = 'zds_stage_mic.png', unique = true, useable = true, shouldClose = true, description = 'Concert. A mic on a boom stand: link it to your concert speakers, stand at it and sing through them (/soundmic).' },
    ['zds_stage_mixer'] = { name = 'zds_stage_mixer', label = 'DJ Mixer', weight = 5000, type = 'item', image = 'zds_stage_mixer.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Not a speaker: whoever stands at it runs every linked concert speaker (volume, bass, sound, timing).' },
    ['zds_stage_monitor'] = { name = 'zds_stage_monitor', label = 'Stage Monitor', weight = 6000, type = 'item', image = 'zds_stage_monitor.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Wedge monitor so the DJ or band hears the mix on stage.' },
    ['zds_stage_pa'] = { name = 'zds_stage_pa', label = 'PA Speaker', weight = 10000, type = 'item', image = 'zds_stage_pa.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Powered 15" PA top on a tripod: link many for an event.' },
    ['zds_stage_sub'] = { name = 'zds_stage_sub', label = 'Concert Subwoofer', weight = 15000, type = 'item', image = 'zds_stage_sub.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Double 18" sub cabinet: the bass you feel at a show.' },

Si vous avez modifié un libellé, un prix ou un poids dans config/catalogue.lua, copiez plutôt les entrées depuis votre propre console : elle les affiche à partir de vos réglages.

4. Premier démarrage : ce que vous devez voir

Dans la console du serveur

ZeroDev Sound affiche un encadré de vérification (tapez soundcheck dans la console du serveur pour l'afficher à nouveau) : base de données et schéma, framework, argent, inventaire et items, table des garages, système de target, Pulse Phone, modèles, ateliers d'installation et réglages modifiés en jeu. Chaque ligne qui n'est pas OK indique quoi faire ; docs/SETUP.md montre un exemple et docs/TROUBLESHOOTING.md explique chaque ligne.

• La ligne du framework nomme ce qui a été trouvé. Si c'est faux, définissez Config.Framework ou Config.Inventory dans config/config.lua.
• Une ligne jaune Add these to ox_inventory/data/items.lua ... (ou ... if these items are not in ... yet, add them) suivie d'entrées d'items : faites la section 3 pour votre inventaire, puis redémarrez. Le message d'ox_inventory disparaît une fois les items ajoutés. Sur qs-, codem-, origen- et tgiann-inventory, les entrées sont affichées à chaque démarrage comme rappel, que vous les ayez ajoutées ou non.
• Une ligne jaune Copy zds_....png from zerodev-sound/web/img/items into ... : ces images ne sont pas encore dans le dossier d'images de votre inventaire. Elle nomme le dossier.
• Pulse Phone app not registered: ... : Pulse Phone tourne mais a refusé l'app. Voir la section 9.

En jeu (cinq vérifications)

1. La carte affiche un blip ZeroDev Sound à Legion Square et un blip Car audio bay chez Benny's.
2. À la boutique, un vendeur se tient près d'un stand où les enceintes sont exposées. Ciblez le vendeur (ou appuyez sur E s'il n'y a pas de ressource de target) et achetez une Roam Portable Speaker.
3. Utilisez-la depuis votre inventaire. Elle sort dans vos mains. Appuyez sur E, ouvrez Library et lancez Night Drive (un morceau de démo fourni avec le script). Les personnes autour de vous l'entendent.
4. Montez dans une voiture. Les premières fois, le coin de l'écran indique quelle touche ouvre l'autoradio (K par défaut).
5. Entrez dans l'atelier d'installation audio en tant que conducteur et appuyez sur E. L'installateur s'ouvre sur votre voiture.

5. Les réglages les plus souvent modifiés

En jeu : /soundadmin > Settings modifie les réglages courants en direct pour tout le monde (ateliers d'installation, qui peut installer, quelles voitures, prix, volume maximum, heures calmes, limites, boutique, police et dégâts). Ils sont enregistrés dans la base de données et priment sur config.lua jusqu'à ce que vous appuyiez sur Reset to config dans le panneau.

Tout se trouve dans config/config.lua, sauf indication contraire. Les produits, prix et pièces audio sont dans config/catalogue.lua ; le son d'origine de chaque voiture est dans config/vehicles.lua.

Noms d'items. Si un autre script utilise déjà l'un des noms d'items zds_, renommez la clé de ce produit dans Catalogue.Speakers (par exemple zds_roam = { ... }), puis utilisez le nouveau nom dans votre inventaire et renommez son image en conséquence.

6. Commandes

Dans la télécommande : Music (la bibliothèque de votre serveur), Queue (à suivre, playlists enregistrées), Speakers (alimentation et volume de chaque enceinte, liaison, rangement) et Tune (six modes de son, un égaliseur trois bandes, qui choisit la musique, horaires d'ouverture et « Real distance » pour les installations de concert). Qui choisit la musique : Only me ; Party, où toute personne à proximité peut demander des morceaux que le propriétaire approuve ; ou Anyone, où les personnes à proximité peuvent lire, mettre en pause, passer, mettre en file et avancer. Opening hours lance tout seul l'une des playlists du propriétaire entre deux heures, pour une boutique ou un club.

Le micro (nécessite pma-voice). Tant que vous le tenez, toute personne proche d'une enceinte de ce système entend votre voix à travers elle, avec un son de sono, aussi fort que cette enceinte joue la musique et aussi loin qu'elle porte ; éloignez-vous de 4 m de la table de mixage ou du pied de micro, déconnectez-vous ou reposez le micro, et votre voix redevient normale. Seul le propriétaire du système (et les admins, pour une voiture) peut chanter à travers lui ; donnez l'ace zds.mic aux autres joueurs pour qu'ils puissent utiliser n'importe quel système. Votre voix ne part pas de l'emplacement de chaque enceinte : le chat vocal ne peut pas placer une voix à cet endroit, donc les personnes proches d'une enceinte vous entendent au volume de cette enceinte. Réglages : Config.Mic.

7. Audio embarqué

Comment les joueurs équipent leur voiture

1. Entrez dans l'atelier d'installation audio (Benny's par défaut) et appuyez sur E en tant que conducteur.
2. Partez d'un kit prêt à l'emploi (Daily thump, Competition, Trunk wall, Sound quality, Clean and hidden) ou choisissez vos pièces : caissons de basses (8" à 18"), caisses, amplificateurs, haut-parleurs de portière, tweeters, pods, faux planchers, panneaux, plexi, condensateur, seconde batterie, bande LED et autoradio.
3. Faites glisser chaque pièce à sa place dans la voiture. Les caissons se logent dans les découpes de leur caisse. Chaque pièce reçoit une finition (huit couleurs), et les caissons et haut-parleurs une grille et un anneau lumineux. Mirror copie une pièce de l'autre côté ; Fine position la déplace par petits pas. Cinq vues caméra : coffre, habitacle, côté, avant, dessus. Taille : les caissons existent en 8", 10", 12", 15" et 18" (tous les caissons d'une même caisse ont la même taille et la caisse est construite autour d'eux, jusqu'à 30 % plus grande ou plus petite que prévu à l'origine) ; les haut-parleurs de portière en 5.25", 6.5" et 6x9" ; toutes les autres pièces de 80 % à 130 % par pas de 5 % (l'autoradio a une taille standard). Les caisses et panneaux plus grands coûtent plus cher ; une pièce rendue plus petite ne coûte rien. Les cônes ont plus de débattement sur les plus grands haut-parleurs, et un haut-parleur de portière plus grand descend plus bas.
4. Appuyez sur Test system pour écouter l'installation jouer dans la voiture avant de payer. Elle lance le premier morceau de Config.Library (le morceau de démo fourni, sauf si vous l'avez changé).
5. Appuyez sur Install. Seules les pièces nouvelles pour la voiture sont facturées ; les pièces conservées de la dernière installation ne sont pas facturées une deuxième fois.

L'installation est enregistrée avec la plaque et revient chaque fois que la voiture revient : depuis n'importe quel garage, fourrière ou réapparition. Rien à modifier dans votre script de garage.

Ce que les joueurs entendent

• Chaque voiture a déjà un son d'origine selon sa classe et son modèle : un système à 4 haut-parleurs, un système premium à 10 haut-parleurs ou un système de référence à 13 haut-parleurs, des haut-parleurs de carénage sur les motos ; les vélos, avions et trains n'en ont pas. Les haut-parleurs installés remplacent les haut-parleurs d'origine les plus proches ; les caissons s'y ajoutent.
• À l'extérieur de la voiture, ce sont surtout les basses qui traversent la carrosserie. Les portières ouvertes, les vitres ouvertes et un coffre ouvert laissent chacun sortir davantage de son, du côté vers lequel ils sont orientés.
• Une voiture avec des caissons rebondit doucement sur ses suspensions avec les basses quand elle est garée ou roule au pas (jamais en roulant), et tous ceux à bord sentent le kick.
• L'autoradio (K) a le volume, le niveau du caisson, le fader et la balance.
• Les caissons poussés bien au-delà de ce que permettent leur ampli et leur puissance nominale, près du volume maximum, pendant un moment, peuvent griller. Tout le monde près de la voiture voit un mince filet de fumée sortir de ce caisson et entend un pop sourd. Un caisson grillé ne bouge plus, les basses baissent, et son cône reste carbonisé jusqu'à son remplacement à l'atelier (un nouveau caisson se paie ; effacer la trace n'est pas une réparation gratuite). Le staff peut le montrer : /soundblow dans la voiture, ou soundblow <plate> dans la console du serveur.

Quelles voitures peuvent être équipées (Config.Install.vehicles)

• 'owned' (par défaut) : uniquement les voitures de la table des véhicules possédés de votre framework (owned_vehicles sur ESX, player_vehicles sur QBCore et Qbox).
• 'any' : aussi les voitures qui n'appartiennent à personne (voitures de PNJ, voitures spawnées, locations).
• Dans les deux cas, une voiture qui appartient à un autre joueur reste la sienne : seul son propriétaire, un mécanicien en service de Config.Install.jobs, ou un admin peut la modifier. Sur un serveur standalone, toutes les voitures comptent comme possédées.

Garages, plaques et fourrières

• Les plaques sont comparées sans espaces superflus et en majuscules, donc les garages qui complètent ou changent la casse des plaques correspondent quand même.
• Une voiture avec une fausse plaque ou une plaque changée ne retrouve son installation qu'une fois sa plaque enregistrée remise.
• Les voitures qui n'existent que sur l'écran d'un seul joueur (aperçus de garage, certaines voitures de showroom) n'ont jamais d'installation : ce ne sont pas de vraies voitures pour les autres.

Autres scripts de son ou d'autoradio

ZeroDev Sound est une ressource à part avec ses propres commandes (/sound, /caraudio, ...), events et state bags de véhicule : il ne remplace ni ne modifie d'autres scripts (quand il joue dans une voiture, il coupe seulement la radio d'origine de GTA). Faire tourner deux scripts d'audio embarqué sur la même voiture en même temps n'a pas été testé : utilisez un seul autoradio par voiture.

8. Sources musicales

La musique est lue uniquement à partir de fichiers audio que vous ajoutez à la ressource. Les joueurs choisissent dans votre liste ; ils ne peuvent pas saisir de liens, et aucune adresse web n'est jamais lue. N'ajoutez que de l'audio dont vous êtes propriétaire ou dont vous détenez les droits d'utilisation et de diffusion.

• Placez des fichiers mp3 ou ogg dans zerodev-sound/web/library/ et listez chacun dans Config.Library sous la forme { title = '...', artist = '...', file = 'name.mp3' }. Ils bénéficient de l'expérience complète : son 3D, pièces et murs, habitacles de voiture, modes de son, EQ et cônes qui bougent avec les vraies basses.
• Config.Sources.library = false désactive la bibliothèque.
• L'autoradio propre à GTA continue de fonctionner dans n'importe quelle voiture tant qu'aucun morceau de cette ressource n'y est lu.
• La boîte de démarrage indique combien de morceaux les joueurs peuvent choisir et signale chaque entrée ignorée (un nom de fichier qui n'est pas un mp3 ou ogg dans web/library/).
• Mise à jour depuis la 3.0.0 : les morceaux enregistrés, les morceaux récents et les entrées de playlist qui étaient des liens ne sont plus affichés ni lus. Les morceaux de la bibliothèque continuent de fonctionner.

9. Pulse Phone

Rien à configurer. Quand Pulse Phone tourne sur le serveur (nom de ressource phone, quelle que soit l'édition) :

• Chaque téléphone reçoit une app Sound sur son écran d'accueil. C'est la même télécommande que /sound : se connecter à une enceinte ou à la voiture, choisir la musique, gérer tout le groupe. Les joueurs peuvent la supprimer et la récupérer depuis App Hub.
• Ce qui joue sur l'enceinte ou la voiture connectée, avec le temps restant, s'affiche sur l'Island et l'écran verrouillé. Un appui ouvre l'app Sound.
• Pulse Drive (l'écran de voiture de Pulse, F10 par défaut) affiche l'autoradio de la voiture dans laquelle vous êtes assis : morceau, artiste et pochette, avec lecture, pause, précédent, suivant et volume, ainsi qu'un bouton Open pour l'app Sound. Cela nécessite Pulse Phone 1.2.9 ou plus récent ; les versions plus anciennes ne l'affichent tout simplement pas.

Les joueurs sans téléphone utilisent /sound et K, qui font tout ce que fait l'app.

Si vous avez renommé le dossier du téléphone, ajoutez cette ligne à config/config.lua avec son nom :

Config.PulseResource = 'phone'

10. Police, voisins et admins

11. Langues

Le script est livré dans les mêmes 25 langues que Pulse Phone. Choisissez-en une dans config/config.lua :

Config.Locale = 'de', par exemple. La valeur par défaut, 'auto', suit Pulse Phone : le serveur reprend le Config.Locale de Pulse, et chaque joueur reçoit Sound dans la langue choisie sur son téléphone. Sans Pulse, c'est en anglais. Les messages du jeu, les invites de touche, les noms d'objets et le nom de la touche de l'autoradio sont dans locales/<code>.lua ; l'interface (télécommande, autoradio, magasin, installateur, app Pulse) est dans locales/<code>_ui.lua. Tout ce qui manque s'affiche en anglais.

Pour modifier une ligne, éditez-la dans le fichier de cette langue. Gardez chaque %s, %d, %.1f, %% et ~a~ tels quels. Pour ajouter votre propre langue, copiez locales/en.lua vers locales/xx.lua, remplacez Locales['en'] par Locales['xx'] (aux deux endroits), traduisez le texte entre les guillemets et mettez Config.Locale = 'xx'. locales/ui_strings.txt liste toutes les clés d'interface pour un xx_ui.lua.

12. Dépannage

Les joueurs ne peuvent pas utiliser les items d'enceintes

• ox_inventory : les entrées doivent être dans ox_inventory/data/items.lua avec leur ligne client, et ox_inventory doit être redémarré après le collage. Le dossier doit toujours s'appeler zerodev-sound (les entrées appellent zerodev-sound.useItem).
• QBCore / ESX : zerodev-sound doit démarrer après votre framework dans server.cfg.
• codem-inventory sur QBCore : effectuez l'étape propre à codem-inventory qui fait pointer QBCore.Functions.UseItem vers lui.
• Aucun inventaire : les enceintes ne sont pas des items. Les joueurs ouvrent /sound et appuient sur Set up sous Your speakers.

Les images des items manquent

• ox_inventory : rien à copier ; le chemin de l'image pointe vers zerodev-sound. Si elles sont vides, vérifiez la ligne image = 'nui://zerodev-sound/...' de l'entrée et le nom du dossier.
• Autres inventaires : lisez la ligne de console Copy ... into ... : elle liste les images manquantes et le dossier où elles vont. Copiez-les depuis zerodev-sound/web/img/items/ et redémarrez l'inventaire.

Un joueur ne peut pas lire un lien

C'est voulu : les joueurs ne choisissent que dans votre bibliothèque. Ajoutez le morceau à Config.Library (section 8).

Aucun son

• Le navigateur intégré de FiveM lance le son sans clic, donc les joueurs n'ont jamais besoin d'appuyer sur quoi que ce soit pour « autoriser » l'audio. Si un joueur n'entend rien alors que les autres entendent, vérifiez FiveM dans son mélangeur de volume Windows.
• Vérifiez l'enceinte dans l'onglet Speakers de la télécommande : elle est peut-être éteinte, ou Broken.
• La police l'a peut-être éteinte (pendant Config.Police.silenceMinutes), ou les heures calmes plafonnent peut-être le volume (Config.QuietHours).
• Un joueur entend au maximum Config.Streaming.maxAudibleSessions morceaux différents à la fois (6), les plus proches en premier.
• Test system dans l'installateur reste silencieux quand Config.Library est vide ou Config.Sources.library = false : il lance le premier morceau de la bibliothèque.

La boutique n'est pas là

• Config.Shop.enabled doit valoir true.
• Le vendeur et le stand n'apparaissent que lorsqu'un joueur est à environ 70 m de Config.Shop.locations, et uniquement sur l'écran de ce joueur. Vérifiez les coordonnées que vous avez définies.
• Avec ox_target ou qb-target, ciblez le vendeur. Sans eux, placez-vous devant le vendeur : E Browse speakers.

Une enceinte apparaît comme une simple enceinte GTA, ou pas du tout

Le dossier stream/ manque ou a été renommé, ou le joueur s'est connecté avant le démarrage de la ressource. Redémarrez le serveur et reconnectez-vous.

Messages de l'audio embarqué et leur signification

La police ne voit pas ses options

Ajoutez les noms de vos métiers de police à Config.Police.jobs. Les joueurs doivent être en service.

13. Mise à jour

Passage de la 1.x à la 2.0 : lisez UPGRADING.md. Entre deux versions 2.x :

1. Sauvegardez votre dossier config/, locales/ si vous l'avez traduit, et tous les morceaux que vous avez ajoutés à web/library/.
2. Arrêtez le serveur. Remplacez le dossier zerodev-sound par le nouveau (gardez le nom).
3. Remettez vos fichiers config/. Si les notes de mise à jour mentionnent de nouveaux réglages, copiez ces lignes des nouveaux fichiers dans les vôtres.
4. Démarrez le serveur et lisez la console. Les nouveaux items éventuels sont affichés pour votre inventaire.

Les enceintes posées, les installations embarquées et les playlists sont conservées dans la base de données (zds_speakers, zds_car_builds, zds_playlists, zds_stash) et ne sont pas touchées par une mise à jour.

Revenir en arrière : gardez l'ancien dossier zerodev-sound en dehors de resources jusqu'à ce que la nouvelle version tourne bien, et sauvegardez la base de données avant la mise à jour. Pour revenir en arrière, arrêtez le serveur, remettez l'ancien dossier et votre config/, puis démarrez-le. Le retour de la 3.0 à la 2.x sur la même base de données n'a pas été testé, donc restaurez la sauvegarde de la base si quelque chose semble anormal.