Rankings
Pesquisa
Busca Avançada

Plugin de Voto FiveM

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

Compatível FiveM
Tempo real
Compatível com frameworks

Instalação

1
Baixar o plugin

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

Baixar v3
2
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
3
Obter o token

Obtenha seu token do painel Top-Games.

4
Configurar server.cfg

Adicione as seguintes linhas ao seu arquivo server.cfg:

ensure vote
set vote_token "SEU_TOKEN_AQUI"
5
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.