Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.rktscripts.com/llms.txt

Use this file to discover all available pages before exploring further.

📥 Instalação

  1. Baixe o script através da sua conta FiveM Keymaster.
  2. O script requer xsound para funcionar corretamente.
  3. Extraia o arquivo .zip baixado.
  4. Coloque a pasta extraída dentro do diretório resources do seu servidor FiveM.
  5. Abra seu server.cfg e adicione a seguinte linha no final para garantir que o script inicie corretamente na inicialização do servidor:
    ensure xsound
    ensure rkt_firework
    
  6. Salve o arquivo server.cfg.
  7. Reinicie seu servidor ou execute os seguintes comandos no console do servidor para carregar o script sem reiniciar:
    refresh
    ensure xsound
    ensure rkt_firework
    
Pronto! O script agora deve estar rodando e pronto para uso.
Nenhuma dependência adicional é necessária.

⚙️ Configuração

shared/shared.lua
    ['simple'] = {
        -- URL do vídeo que fornece o áudio para o efeito de fogos de artifício
        -- Se você não quiser usar uma animação, defina isso como false.
        video = 'https://youtu.be/yrwbpO-zAWY',

        -- Animação principal: { dict, animName }
        anim = { "missmic4premiere", "interview_short_lazlow" },

        -- Lista de offsets para cada efeito de partícula (relativo à coordenada base)
        offsets = {
            { x = 0, y = 0, z = 12 }, -- 1ª partícula: centro, 12 unidades acima
            { x = 3, y = 0, z = 12 }, -- 2ª partícula: 3 unidades para o lado (x)
            { x = 0, y = 3, z = 12 }, -- 3ª partícula: 3 unidades para frente (y)
            { x = 0, y = 3, z = 12 }, -- 4ª partícula (repetida)
            { x = 0, y = 3, z = 12 }, -- 5ª partícula (repetida)
            { x = 0, y = 3, z = 12 }, -- 6ª partícula (repetida)
            { x = 0, y = 3, z = 12 }, -- 7ª partícula (repetida)
        },

        -- Tempo de espera entre cada partícula (em milissegundos)
        delays = { 500, 400, 300, 200, 100, 700, 0 },

        -- Nome do objeto prop que será spawnado (ex: casca de fogos ou lançador)
        prop = "rojao_simples",

        -- Efeito de partícula: { asset, nome do efeito }
        particle = { 
            "scr_sm_counter",        -- o asset que contém os efeitos de partícula
            "scr_sm_counter_chaff"   -- nome específico do efeito dentro do asset
        },

        -- Configuração de anexo para segurar o prop na mão/corpo do jogador
        -- Se você não quiser usar anexo, defina isso como false.
        attach = {
            -- Dicionário de animação e nome usado ao segurar o prop
            anim = { dict = "missmic4premiere", anim = "interview_short_lazlow" },

            -- Offsets de posição e rotação relativos ao osso
            pos = { vec3(0.1, 0.1, 0.0), vec3(190.0, 0.0, 0.0) },

            -- ID do osso para anexar o prop (57005 = mão direita)
            bone = 57005
        }
    },

🎈 Como Usar

Para acionar o fogos de artifício, simplesmente chame o evento rkt_rojao:start e passe a chave de índice que corresponde à sua entrada em Config.fireworks.
client
    -- Exemplo do lado do cliente
    -- Substitua 'simple' pela chave da configuração de fogos que você deseja
    TriggerEvent('rkt_rojao:start', 'simple')
server
    -- Exemplo do lado do servidor
    -- Substitua 'simple' pela chave da configuração de fogos que você deseja
    TriggerClientEvent("rkt_rojao:start", source, "simple")