Plugin di voto FiveM

Integra facilmente il sistema di voto Top-Games al tuo server FiveM e ricompensa i tuoi giocatori in tempo reale.

Scarica v3 Vedi il codice sorgente

Compatibile FiveM

Tempo reale

Framework compatibile

Installazione

Scarica il plugin

Scarica l'ultima versione del plugin dal nostro repository GitHub.

Scarica v3

Copia in resources

Estrai e copia il contenuto della cartella cfx-vote-plugin nella directory resources/vote del tuo server.

resources/vote

Ottieni il token

Ottieni il tuo token dal pannello Top-Games.

Configura server.cfg

Aggiungi le seguenti righe al tuo file server.cfg:

ensure vote
set vote_token "IL_TUO_TOKEN_QUI"

Attivare il plugin

Attivare il "Plugin di voto v3" nel pannello Top-Games. Puoi testare il plugin cliccando su "Testa connettività" e simulare un voto.

Configurazione e utilizzo

Evento di voto

Il plugin attiva automaticamente l'evento onPlayerVote quando un giocatore vota per il tuo server.

vote-handler.lua

-- Esempio di utilizzo base
AddEventHandler('onPlayerVote', function(playername, date)
    print('Nuovo voto ricevuto!')
    print('Giocatore: ' .. playername)
    print('Data: ' .. date)
    
    -- Aggiungi qui la tua logica delle ricompense
end)

Esempio con QBCore Framework

vote-rewards-qbcore.lua

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

AddEventHandler('onPlayerVote', function(playerId, date)
    local Player = QBCore.Functions.GetPlayerByCitizenId(playerId)
    
    if Player then
        -- Ricompensa in denaro
        Player.Functions.AddMoney('cash', 1000, "vote-reward")
        
        -- Ricompensa oggetti
        Player.Functions.AddItem('lockpick', 5, false, "vote-reward")
        
        -- Notifica al giocatore
        TriggerClientEvent('QBCore:Notify', Player.PlayerData.source, 'Grazie per il tuo voto! +1000$', 'success', 8000)
        
        -- Messaggio globale
        TriggerClientEvent('chat:addMessage', -1, {
            color = {255, 194, 14},
            multiline = true,
            args = {"[VOTE]", Player.PlayerData.charinfo.firstname .. " " .. Player.PlayerData.charinfo.lastname .. " ha votato per il server!"}
        })
    else
        -- Gestione giocatore offline
        print("Giocatore " .. playerId .. " non trovato (offline?)")
    end
end)

Esempio con Qbox Framework

vote-rewards-qbox.lua

-- Esempio con Qbox Framework
AddEventHandler('onPlayerVote', function(playerId, date)
    local player = exports.qbx_core:GetPlayer(playerId)
    
    if player then
        -- Ricompensa in denaro
        player.Functions.AddMoney('cash', 1000, "vote-reward")
        
        -- Ricompensa oggetti
        exports.ox_inventory:AddItem(player.PlayerData.source, 'lockpick', 5)
        
        -- Notifica al giocatore
        exports.qbx_core:Notify(player.PlayerData.source, 'Grazie per il tuo voto! +1000$', 'success', 8000)
        
        -- Messaggio globale
        TriggerClientEvent('chat:addMessage', -1, {
            color = {0, 162, 255},,
            multiline = true,
            args = {"[VOTE]", player.PlayerData.charinfo.firstname .. " " .. player.PlayerData.charinfo.lastname .. " ha votato per il server!"}
        })
    else
        -- Gestione giocatore offline
        print("Giocatore " .. playerId .. " non trovato (offline?)")
    end
end)

Risoluzione problemi

Verifica che la cartella sia in resources/
Assicurati che la riga ensure vote sia in server.cfg
Riavvia completamente il tuo server

Verifica che il tuo token sia corretto in server.cfg
Attiva il "Plugin di voto v3" nel tuo pannello Top-Games
Assicurati che il tuo server sia accessibile da Internet

Verifica la sintassi del tuo AddEventHandler
Assicurati che lo script contenente l'handler sia caricato
Testa con un semplice print() per il debug

Informazioni

Versione: v3 (Latest)

Compatibilità: FiveM

Framework: ESX, QBCore, Qbox

Licenza: Open Source

Supporto

Hai bisogno di aiuto? Il nostro team è qui per accompagnarti.

Contattaci Segnala un bug