Рейтинги
Пошук
розширений пошук Ctrl + K для відкриття пошуку

Плагін голосування 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
Ліцензія: Відкритий вихідний код
Підтримка

Потрібна допомога? Наша команда готова допомогти вам.