Plugin de Voto FiveM

Integre facilmente o sistema de votação Top-Games ao seu servidor FiveM e recompense seus jogadores em tempo real.

Baixar v3 Ver código fonte

Compatível FiveM

Tempo real

Compatível com frameworks

Instalação

Baixar o plugin

Baixe a versão mais recente do plugin do nosso repositório GitHub.

Baixar v3

Copiar para resources

Extraia e copie o conteúdo da pasta cfx-vote-plugin para o diretório resources/vote do seu servidor.

resources/vote

Obter o token

Obtenha seu token do painel Top-Games.

Configurar server.cfg

Adicione as seguintes linhas ao seu arquivo server.cfg:

ensure vote
set vote_token "SEU_TOKEN_AQUI"

Ativar o plugin

Ative o "Plugin de votação v3" no seu painel Top-Games. Você pode testar o plugin clicando em "Testar conectividade" e simular um voto.

Configuração e uso

Evento de voto

O plugin dispara automaticamente o evento onPlayerVote quando um jogador vota no seu servidor.

vote-handler.lua

-- Exemplo de uso básico
AddEventHandler('onPlayerVote', function(playername, date)
    print('Novo voto recebido!')
    print('Jogador: ' .. playername)
    print('Data: ' .. date)
    
    -- Adicione aqui sua lógica de recompensa
end)

Exemplo com QBCore Framework

vote-rewards-qbcore.lua

-- Exemplo com QBCore Framework
local QBCore = exports['qb-core']:GetCoreObject()

AddEventHandler('onPlayerVote', function(playerId, date)
    local Player = QBCore.Functions.GetPlayerByCitizenId(playerId)
    
    if Player then
        -- Recompensa em dinheiro
        Player.Functions.AddMoney('cash', 1000, "vote-reward")
        
        -- Recompensa em itens
        Player.Functions.AddItem('lockpick', 5, false, "vote-reward")
        
        -- Notificação ao jogador
        TriggerClientEvent('QBCore:Notify', Player.PlayerData.source, 'Obrigado pelo seu voto! +1000$', 'success', 8000)
        
        -- Mensagem global
        TriggerClientEvent('chat:addMessage', -1, {
            color = {255, 194, 14},
            multiline = true,
            args = {"[VOTE]", Player.PlayerData.charinfo.firstname .. " " .. Player.PlayerData.charinfo.lastname .. " votou no servidor!"}
        })
    else
        -- Gestão de jogador offline
        print("Jogador " .. playerId .. " não encontrado (offline?)")
    end
end)

Exemplo com Qbox Framework

vote-rewards-qbox.lua

-- Exemplo com Qbox Framework
AddEventHandler('onPlayerVote', function(playerId, date)
    local player = exports.qbx_core:GetPlayer(playerId)
    
    if player then
        -- Recompensa em dinheiro
        player.Functions.AddMoney('cash', 1000, "vote-reward")
        
        -- Recompensa em itens
        exports.ox_inventory:AddItem(player.PlayerData.source, 'lockpick', 5)
        
        -- Notificação ao jogador
        exports.qbx_core:Notify(player.PlayerData.source, 'Obrigado pelo seu voto! +1000$', 'success', 8000)
        
        -- Mensagem global
        TriggerClientEvent('chat:addMessage', -1, {
            color = {0, 162, 255},,
            multiline = true,
            args = {"[VOTE]", player.PlayerData.charinfo.firstname .. " " .. player.PlayerData.charinfo.lastname .. " votou no servidor!"}
        })
    else
        -- Gestão de jogador offline
        print("Jogador " .. playerId .. " não encontrado (offline?)")
    end
end)

Solução de problemas

Verifique se a pasta está corretamente colocada em resources/
Certifique-se de que a linha ensure vote está em server.cfg
Reinicie completamente seu servidor

Verifique se seu token está correto em server.cfg
Ative o "Plugin de voto v3" no seu painel Top-Games
Certifique-se de que seu servidor está acessível pela Internet

Verifique a sintaxe do seu AddEventHandler
Certifique-se de que seu script contendo o handler está carregado corretamente
Teste com um simples print() para debugar

Informações

Versão: v3 (Mais recente)

Compatibilidade: FiveM

Frameworks: ESX, QBCore, Qbox

Licença: Código Aberto

Suporte

Precisa de ajuda? Nossa equipe está aqui para ajudá-lo.

Entre em contato Reportar um bug