Classements
Recherche
Recherche avancée

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.

Compatible FiveM
Temps réel
Framework compatible

Installation

1
Télécharger le plugin

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

Télécharger v3
2
Copier dans resources

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

resources/vote
3
Obtenir le token

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

4
Configurer server.cfg

Ajoutez les lignes suivantes à votre fichier server.cfg :

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