Vicepad
Vicepad

Setup guide

One resource, no database, no backend to host. It counts shifts, keeps a weekly ledger in the server’s own storage and writes the sheet you pay from.

Install in three steps

  1. Get the resource. Launching gives you one with your settings filled in. Or take the blank one and edit config.lua yourself.

    Launch your city’s coin
  2. Unzip into resources and add two lines to server.cfg, after your framework:

    ensure vicepad
    add_ace group.admin vicepad.admin allow
  3. Restart. The console prints [vicepad] framework: qbcore (or qbox, esx, standalone). Players type /payroll to see their week.

How shifts are counted

Every minute, each player who has moved in the last few minutes earns points: their job’s rate while on duty, a lower rate off duty, and playtime on standalone servers. Idle players earn nothing, each player has a weekly cap, and everything is keyed to their Rockstar license, so alts and AFK farms don’t pay.

config.lua

SettingWhat it does
Config.CityYour city's name, ticker and coin address (mint). Holder perks wait for the mint.
Config.Framework'auto' finds qbx_core, qb-core or es_extended. Or name one, or 'standalone'.
Config.Payroll.jobsOn-duty jobs and their rate per minute. Unlisted jobs use otherJobRate.
Config.Payroll.idleMinutesA player who hasn't moved for this long earns nothing.
Config.Payroll.weeklyCapThe most points one player can earn in a week.
Config.WalletTurns /wallet on or off, and renames it.
Config.HoldersToken amount for holder perks, the ACE group they join and the RPC used to check.
Config.DiscordWebhook URL for the payday post and how many names it lists.

Commands

CommandWhoWhat it does
/payrollEveryoneYour points this week, your rank and your share.
/wallet <address>EveryoneSets the wallet your payroll is paid to. Checked before it's saved.
/payrollexportAdmins, consoleWrites this week's payday sheet now.
/payrolladd <id> <points>Admins, consoleAdds points, or removes them with a negative number.

For developers

Any script can pay for the things your city does: deliveries, races, events, fines collected.

-- from any server script
exports.vicepad:AddShiftPoints(source, 25, 'Finished a cargo run')
exports.vicepad:GetShiftPoints(source)  -- this week's points
exports.vicepad:GetWallet(source)       -- payout wallet or nil
exports.vicepad:IsHolder(source)        -- true when holder perks are on

Payday

When a week ends, the resource writes payday/week-<n>.csv and, if you set a webhook, posts the top earners to Discord. Paste the sheet into the payday sheet, enter what’s in your payroll wallet, and pay each wallet its amount from your own wallet. The resource never holds keys and never sends money.

Before you go live

Rockstar’s rules for GTA V roleplay servers ban cryptocurrency, and Cfx.re’s platform license restricts crypto payment mechanics. A server running a coin-funded payroll can be blocked. Read the current terms on fivem.net and rockstargames.com and decide for your own city.