Plugin de Voto FiveM

Integra fácilmente el sistema de votación de Top-Games en tu servidor FiveM y recompensa a tus jugadores en tiempo real.

Descargar v3 Ver código fuente

Compatible FiveM

Tiempo real

Compatible con frameworks

Instalación

Descargar el plugin

Descarga la última versión del plugin desde nuestro repositorio de GitHub.

Descargar v3

Copiar a resources

Extrae y copia el contenido de la carpeta cfx-vote-plugin en el directorio resources/vote de tu servidor.

resources/vote

Obtener el token

Obtén tu token desde el panel de Top-Games.

Configurar server.cfg

Añade las siguientes líneas a tu archivo server.cfg:

ensure vote
set vote_token "TU_TOKEN_AQUI"

Activar el plugin

Active el "Plugin de voto v3" en su panel de Top-Games. Puede probar el plugin haciendo clic en "Probar conectividad" y simular un voto.

Configuración y uso

Evento de voto

El plugin activa automáticamente el evento onPlayerVote cuando un jugador vota por tu servidor.

vote-handler.lua

-- Ejemplo de uso básico
AddEventHandler('onPlayerVote', function(playername, date)
    print('¡Nuevo voto recibido!')
    print('Jugador: ' .. playername)
    print('Fecha: ' .. date)
    
    -- Añade aquí tu lógica de recompensas
end)

Ejemplo con QBCore Framework

vote-rewards-qbcore.lua

-- Ejemplo con QBCore Framework
local QBCore = exports['qb-core']:GetCoreObject()

AddEventHandler('onPlayerVote', function(playerId, date)
    local Player = QBCore.Functions.GetPlayerByCitizenId(playerId)
    
    if Player then
        -- Recompensa de dinero
        Player.Functions.AddMoney('cash', 1000, "vote-reward")
        
        -- Recompensa de objetos
        Player.Functions.AddItem('lockpick', 5, false, "vote-reward")
        
        -- Notificación al jugador
        TriggerClientEvent('QBCore:Notify', Player.PlayerData.source, '¡Gracias por tu voto! +1000$', 'success', 8000)
        
        -- Mensaje global
        TriggerClientEvent('chat:addMessage', -1, {
            color = {255, 194, 14},
            multiline = true,
            args = {"[VOTE]", Player.PlayerData.charinfo.firstname .. " " .. Player.PlayerData.charinfo.lastname .. " votó por el servidor!"}
        })
    else
        -- Manejo de jugador desconectado
        print("Jugador " .. playerId .. " no encontrado (¿desconectado?)")
    end
end)

Ejemplo con Qbox Framework

vote-rewards-qbox.lua

-- Ejemplo con Qbox Framework
AddEventHandler('onPlayerVote', function(playerId, date)
    local player = exports.qbx_core:GetPlayer(playerId)
    
    if player then
        -- Recompensa de dinero
        player.Functions.AddMoney('cash', 1000, "vote-reward")
        
        -- Recompensa de objetos
        exports.ox_inventory:AddItem(player.PlayerData.source, 'lockpick', 5)
        
        -- Notificación al jugador
        exports.qbx_core:Notify(player.PlayerData.source, '¡Gracias por tu voto! +1000$', 'success', 8000)
        
        -- Mensaje global
        TriggerClientEvent('chat:addMessage', -1, {
            color = {0, 162, 255},,
            multiline = true,
            args = {"[VOTE]", player.PlayerData.charinfo.firstname .. " " .. player.PlayerData.charinfo.lastname .. " votó por el servidor!"}
        })
    else
        -- Manejo de jugador desconectado
        print("Jugador " .. playerId .. " no encontrado (¿desconectado?)")
    end
end)

Solución de problemas

Verifica que la carpeta esté correctamente ubicada en resources/
Asegúrate de que la línea ensure vote esté en server.cfg
Reinicia completamente tu servidor

Verifica que tu token sea correcto en server.cfg
Activa el "Plugin de voto v3" en tu panel de Top-Games
Asegúrate de que tu servidor sea accesible desde Internet

Verifica la sintaxis de tu AddEventHandler
Asegúrate de que tu script que contiene el handler esté correctamente cargado
Prueba con un simple print() para depurar

Información

Versión: v3 (Última)

Compatibilidad: FiveM

Frameworks: ESX, QBCore, Qbox

Licencia: Código Abierto

Soporte

¿Necesitas ayuda? Nuestro equipo está aquí para asistirte.

Contáctanos Reportar un error