STG Boombox – Sistema de Som Avançado

STG Boombox – Sistema de Música Avançado para FiveM

Leve uma experiência musical portátil completa para o seu servidor FiveM com Caixa de som STG. Os jogadores podem pegar uma caixa de som JBL personalizada, colocá-la em qualquer lugar do mundo ou usá-la dentro de um veículo e reproduzir músicas do YouTube diretamente no jogo — tudo com uma interface de usuário incrível inspirada no Spotify. Desenvolvido pela STG Scripts (Lyra Store) com suporte para ambos. ESX e QBCore estruturas.

Principais características

• Modelo de alto-falante portátil JBL — Transmissão personalizada qua_jblspeaker Objeto que os jogadores podem segurar, colocar no chão ou usar dentro de veículos.
• Transmissão do YouTube — Reproduza qualquer vídeo do YouTube como música através da caixa de som do jogo com áudio espacial baseado na distância.
• Interface de usuário semelhante à do Spotify — Interface completa e elegante para reprodutor de música, com capas de álbuns, controles de reprodução, reprodução aleatória, repetição e volume.
• Sistema de listas de reprodução — Os jogadores podem criar, nomear e gerenciar listas de reprodução pessoais armazenadas no banco de dados.
• Músicas Curtidas — Os jogadores podem curtir/salvar faixas individuais em sua lista pessoal de músicas favoritas.
• Categorias de Música — Categorias pré-configuradas (Pop, Hip-Hop, Rock, K-Pop, Love, Metal) com cores configuráveis e faixas de servidor personalizadas.
• Procurar — Funcionalidade de busca de músicas na interface do usuário para encontrar faixas rapidamente
• Suporte de Veículo — O Boombox detecta automaticamente quando o reprodutor está em um veículo e reproduz música no modo veículo.
• Áudio espacial — O volume da música diminui com a distância do aparelho de som colocado sobre a base.
• Sincronização de posição — A posição do Boombox é sincronizada com o servidor em tempo real, para que todos os jogadores próximos ouçam a mesma música.
• Suporte para ESX e QBCore — Scripts de cliente/servidor separados para ambas as estruturas, alternados por meio de uma única opção de configuração
• Notificações configuráveis — Utiliza o sistema de notificação existente do seu servidor através de um simples notificar.lua
• API de exportação — Acione o uso do boombox a partir de outros recursos via exports["stg-boombox"]:use()
• Protegido por garantia fiduciária — Os scripts principais estão protegidos via custódia Cfx.re; os arquivos de configuração e notificação permanecem abertos.

O que está incluído

• fxmanifest.lua — Manifesto de recursos (lua54 ativado)
• configuração.lua — Configuração completa: estrutura, modelo de boombox, categorias musicais, idioma/localidade
• notificar.lua — Manipulador de notificações personalizável
• cliente/cliente_esx.lua — Script do cliente ESX
• cliente/cliente_qb.lua — Script do cliente QBCore
• servidor/servidor_esx.lua — Script de servidor ESX
• servidor/servidor_qb.lua — Script de servidor QBCore
• html/ — Interface completa de reprodutor de música NUI (HTML, CSS, JS)
• stream/qua_jblspeaker.ydr/.ytyp — Modelo 3D personalizado de alto-falante JBL
• boombox/[SQL]/dados.sql — Tabelas de banco de dados para músicas, listas de reprodução e músicas curtidas
• boombox/[Imagem do Inventário]/boombox.png — Imagem do item de inventário

Requisitos

• ESX (es_extendido) ou framework QBCore
• mysql-assíncrono (oxmysql ou compatível)
• Um recurso de inventário (ox_inventory, qb-inventory ou similar) para adicionar o item boombox.

Instalação

1. Extraia a pasta de recursos para o seu servidor. recursos/ diretório
2. Adicionar garantir stg-boombox para o seu servidor.cfg
3. Importar boombox/[SQL]/dados.sql em seu banco de dados
4. Definir Lyra.framework para ""esx"" ou ""qb"" em configuração.lua
5. Adicione o item boombox ao seu inventário e configure o uso do item para ativar o gatilho. exports["stg-boombox"]:use()
6. Reinicie seu servidor

A documentação completa está disponível em STG Boombox GitBook.