Рейтинги
Поиск
Расширенный поиск

Плагин голосования FiveM

Легко интегрируйте систему голосования Top-Games на ваш сервер FiveM и награждайте игроков в реальном времени.

Совместим с FiveM
В реальном времени
Совместим с фреймворками

Установка

1
Скачать плагин

Скачайте последнюю версию плагина из нашего GitHub репозитория.

Скачать v3
2
Скопировать в resources

Извлеките и скопируйте содержимое папки cfx-vote-plugin в директорию resources/vote вашего сервера.

resources/vote
3
Получить токен

Получите ваш токен из панели Top-Games.

4
Настроить server.cfg

Добавьте следующие строки в ваш файл server.cfg:

ensure vote
set vote_token "ВАШ_ТОКЕН_ЗДЕСЬ"
5
Активировать плагин

Активируйте "Плагин голосования v3" в панели Top-Games. Вы можете протестировать плагин, нажав на "Тестировать подключение" и симулировать голос.

Настройка и использование

Событие голосования

Плагин автоматически вызывает событие onPlayerVote когда игрок голосует за ваш сервер.

vote-handler.lua
-- Пример базового использования
AddEventHandler('onPlayerVote', function(playername, date)
    print('Получен новый голос!')
    print('Игрок: ' .. playername)
    print('Дата: ' .. date)
    
    -- Добавьте сюда логику наград
end)
Пример с QBCore Framework
vote-rewards-qbcore.lua
-- Пример с QBCore Framework
local QBCore = exports['qb-core']:GetCoreObject()

AddEventHandler('onPlayerVote', function(playerId, date)
    local Player = QBCore.Functions.GetPlayerByCitizenId(playerId)
    
    if Player then
        -- Денежная награда
        Player.Functions.AddMoney('cash', 1000, "vote-reward")
        
        -- Награда предметами
        Player.Functions.AddItem('lockpick', 5, false, "vote-reward")
        
        -- Уведомление игрока
        TriggerClientEvent('QBCore:Notify', Player.PlayerData.source, 'Спасибо за ваш голос! +1000$', 'success', 8000)
        
        -- Глобальное сообщение
        TriggerClientEvent('chat:addMessage', -1, {
            color = {255, 194, 14},
            multiline = true,
            args = {"[VOTE]", Player.PlayerData.charinfo.firstname .. " " .. Player.PlayerData.charinfo.lastname .. " проголосовал за сервер!"}
        })
    else
        -- Управление оффлайн игроком
        print("Игрок " .. playerId .. " не найден (оффлайн?)")
    end
end)
Пример с Qbox Framework
vote-rewards-qbox.lua
-- Пример с Qbox Framework
AddEventHandler('onPlayerVote', function(playerId, date)
    local player = exports.qbx_core:GetPlayer(playerId)
    
    if player then
        -- Денежная награда
        player.Functions.AddMoney('cash', 1000, "vote-reward")
        
        -- Награда предметами
        exports.ox_inventory:AddItem(player.PlayerData.source, 'lockpick', 5)
        
        -- Уведомление игрока
        exports.qbx_core:Notify(player.PlayerData.source, 'Спасибо за ваш голос! +1000$', 'success', 8000)
        
        -- Глобальное сообщение
        TriggerClientEvent('chat:addMessage', -1, {
            color = {0, 162, 255},,
            multiline = true,
            args = {"[VOTE]", player.PlayerData.charinfo.firstname .. " " .. player.PlayerData.charinfo.lastname .. " проголосовал за сервер!"}
        })
    else
        -- Управление оффлайн игроком
        print("Игрок " .. playerId .. " не найден (оффлайн?)")
    end
end)

Устранение неполадок

  • Проверьте, что папка правильно размещена в resources/
  • Убедитесь, что строка ensure vote находится в server.cfg
  • Полностью перезапустите ваш сервер

  • Проверьте, что ваш токен правильный в server.cfg
  • Активируйте "Плагин голосования v3" в вашей панели Top-Games
  • Убедитесь, что ваш сервер доступен из интернета

  • Проверьте синтаксис вашего AddEventHandler
  • Убедитесь, что ваш скрипт с обработчиком правильно загружен
  • Протестируйте с простым print() для отладки
Информация
Версия: v3 (Последняя)
Совместимость: FiveM
Фреймворки: ESX, QBCore, Qbox
Лицензия: Открытый исходный код
Поддержка

Нужна помощь? Наша команда готова помочь вам.