STG Boombox – Système audio avancé

Description

STG Boombox – Système audio avancé pour FiveM

Apportez une expérience musicale portable complète à votre serveur FiveM avec STG Boombox. Les joueurs peuvent récupérer une enceinte JBL personnalisée, la placer n'importe où dans le monde ou l'utiliser dans un véhicule, et écouter de la musique YouTube directement dans le jeu, grâce à une interface utilisateur inspirée de Spotify. Développé par STG Scripts (Lyra Store), ce jeu est compatible avec les deux plateformes. ESX et QBCore cadres.

Caractéristiques principales

• Modèle d'enceinte portable JBL — Diffusion personnalisée qua_jblspeaker accessoire que les joueurs peuvent tenir, poser au sol ou utiliser à l'intérieur des véhicules
• Streaming YouTube — Diffusez n'importe quelle vidéo YouTube en musique via le boombox intégré au jeu, avec un son spatialisé basé sur la distance.
• Interface utilisateur similaire à Spotify — Interface de lecteur de musique complète et élégante avec affichage des pochettes d'album, commandes de lecture, lecture aléatoire, répétition et réglage du volume
• Système de listes de lecture — Les joueurs peuvent créer, nommer et gérer des listes de lecture personnelles stockées dans la base de données
• Chansons aimées — Les joueurs peuvent ajouter des morceaux à leur liste de chansons préférées.
• Catégories musicales — Catégories préconfigurées (Pop, Hip-Hop, Rock, K-Pop, Love, Metal) avec couleurs configurables et pistes de serveur personnalisées
• Recherche — Fonctionnalité de recherche musicale intégrée à l'interface pour trouver rapidement des morceaux
• Assistance aux véhicules — Le Boombox détecte automatiquement lorsque le lecteur se trouve dans un véhicule et diffuse de la musique en mode véhicule.
• Audio spatial — Le volume de la musique diminue avec la distance par rapport à l'accessoire boombox placé
• Synchronisation de position — La position de la Boombox est synchronisée avec le serveur en temps réel afin que tous les joueurs à proximité entendent la même musique.
• Support ESX et QBCore — Scripts client/serveur séparés pour les deux frameworks, commutables via une seule option de configuration
• Notifications configurables — Utilise le système de notification existant de votre serveur via une interface simple notifier.lua
• API d'exportation — Déclencher l'utilisation du boombox à partir d'autres ressources via exports["stg-boombox"]:use()
• Protection par séquestre — Les scripts principaux sont protégés par un système de dépôt fiduciaire Cfx.re ; les fichiers de configuration et de notification restent accessibles.

Ce qui est inclus

• fxmanifest.lua — Manifeste de ressources (lua54 activé)
• config.lua — Configuration complète : cadre, modèle de boombox, catégories musicales, langue/paramètres régionaux
• notifier.lua — Gestionnaire de notifications personnalisable
• client/client_esx.lua — Script client ESX
• client/client_qb.lua — Script client QBCore
• serveur/serveur_esx.lua — Script serveur ESX
• serveur/serveur_qb.lua — Script serveur QBCore
• html/ — Interface complète du lecteur de musique NUI (HTML, CSS, JS)
• flux/qua_jblspeaker.ydr/.ytyp — Modèle 3D personnalisé d'une enceinte JBL
• boombox/[SQL]/data.sql — Tables de base de données pour les chansons, les listes de lecture et les chansons aimées
• boombox/[InventoryImage]/boombox.png — Image de l'article en stock

Exigences

• ESX (es_extended) ou le framework QBCore
• mysql-async (oxmysql ou compatible)
• Une ressource d'inventaire (ox_inventory, qb-inventory ou similaire) pour ajouter l'élément boombox

Installation

1. Extrayez le dossier de ressources sur votre serveur. ressources/ annuaire
2. Ajouter assurer stg-boombox à votre serveur.cfg
3. Importer boombox/[SQL]/data.sql dans votre base de données
4. Ensemble Lyra.framework à ""esx"" ou ""qb"" dans config.lua
5. Ajoutez le boombox à votre inventaire et configurez son utilisation pour déclencher exports["stg-boombox"]:use()
6. Redémarrez votre serveur

La documentation complète est disponible sur le site web. GitBook STG Boombox.