Plugin de vote FiveM

Intégrez facilement le système de vote Top-Serveurs à votre serveur FiveM et récompensez vos joueurs en temps réel.

Télécharger v3 Voir le code source

Compatible FiveM

Temps réel

Framework compatible

Installation

Télécharger le plugin

Téléchargez la dernière version du plugin depuis notre repository GitHub.

Télécharger v3

Copier dans resources

Extrayez et copiez le contenu du dossier cfx-vote-plugin dans le répertoire resources/vote de votre serveur.

resources/vote

Obtenir le token

Récupérez votre token dans le panel Top-Serveurs.

Configurer server.cfg

Ajoutez les lignes suivantes à votre fichier server.cfg :

ensure vote
set vote_token "VOTRE_TOKEN_ICI"

Activer le plugin

Activez le "Plugin de vote v3" dans votre panel Top-Serveurs. Vous pouvez tester le plugin en cliquant sur "Tester la connectivité" et simuler un vote.

Configuration et utilisation

Event de vote

Le plugin déclenche automatiquement l'événement onPlayerVote lorsqu'un joueur vote pour votre serveur.

vote-handler.lua

-- Exemple d'utilisation basique
AddEventHandler('onPlayerVote', function(playername, date)
    print('Nouveau vote reçu!')
    print('Joueur: ' .. playername)
    print('Date: ' .. date)
    
    -- Ajoutez ici votre logique de récompense
end)

Exemple avec QBCore Framework

vote-rewards-qbcore.lua

-- Exemple avec QBCore Framework
local QBCore = exports['qb-core']:GetCoreObject()

AddEventHandler('onPlayerVote', function(playerId, date)
    local Player = QBCore.Functions.GetPlayerByCitizenId(playerId)
    
    if Player then
        -- Récompense en argent
        Player.Functions.AddMoney('cash', 1000, "vote-reward")
        
        -- Récompense en objets
        Player.Functions.AddItem('lockpick', 5, false, "vote-reward")
        
        -- Notification au joueur
        TriggerClientEvent('QBCore:Notify', Player.PlayerData.source, 'Merci pour votre vote ! +1000$', 'success', 8000)
        
        -- Message global
        TriggerClientEvent('chat:addMessage', -1, {
            color = {255, 194, 14},
            multiline = true,
            args = {"[VOTE]", Player.PlayerData.charinfo.firstname .. " " .. Player.PlayerData.charinfo.lastname .. " a voté pour le serveur !"}
        })
    else
        -- Gestion joueur hors ligne
        print("Joueur " .. playerId .. " non trouvé (hors ligne ?)")
    end
end)

Exemple avec Qbox Framework

vote-rewards-qbox.lua

-- Exemple avec Qbox Framework
AddEventHandler('onPlayerVote', function(playerId, date)
    local player = exports.qbx_core:GetPlayer(playerId)
    
    if player then
        -- Récompense en argent
        player.Functions.AddMoney('cash', 1000, "vote-reward")
        
        -- Récompense en objets
        exports.ox_inventory:AddItem(player.PlayerData.source, 'lockpick', 5)
        
        -- Notification au joueur
        exports.qbx_core:Notify(player.PlayerData.source, 'Merci pour votre vote ! +1000$', 'success', 8000)
        
        -- Message global
        TriggerClientEvent('chat:addMessage', -1, {
            color = {0, 162, 255},,
            multiline = true,
            args = {"[VOTE]", player.PlayerData.charinfo.firstname .. " " .. player.PlayerData.charinfo.lastname .. " a voté pour le serveur !"}
        })
    else
        -- Gestion joueur hors ligne
        print("Joueur " .. playerId .. " non trouvé (hors ligne ?)")
    end
end)

Dépannage

Vérifiez que le dossier est bien dans resources/
Assurez-vous que la ligne ensure vote est dans server.cfg
Redémarrez complètement votre serveur

Vérifiez que votre token est correct dans server.cfg
Activez le "Plugin de vote v3" dans votre panel Top-Serveurs
Assurez-vous que votre serveur est accessible depuis Internet

Vérifiez la syntaxe de votre AddEventHandler
Assurez-vous que votre script contenant l'handler est bien chargé
Testez avec un simple print() pour débugger

Informations

Version : v3 (Latest)

Compatibilité : FiveM

Frameworks : ESX, QBCore, Qbox

Licence : Open Source

Support

Besoin d'aide ? Notre équipe est là pour vous accompagner.

Nous contacter Signaler un bug