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
Get the resource. Launching gives you one with your settings filled in. Or take the blank one and edit config.lua yourself.
Unzip into resources and add two lines to server.cfg, after your framework:
ensure vicepad add_ace group.admin vicepad.admin allow
Restart. The console prints
[vicepad] framework: qbcore(or qbox, esx, standalone). Players type/payrollto 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
| Setting | What it does |
|---|---|
Config.City | Your 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.jobs | On-duty jobs and their rate per minute. Unlisted jobs use otherJobRate. |
Config.Payroll.idleMinutes | A player who hasn't moved for this long earns nothing. |
Config.Payroll.weeklyCap | The most points one player can earn in a week. |
Config.Wallet | Turns /wallet on or off, and renames it. |
Config.Holders | Token amount for holder perks, the ACE group they join and the RPC used to check. |
Config.Discord | Webhook URL for the payday post and how many names it lists. |
Commands
| Command | Who | What it does |
|---|---|---|
/payroll | Everyone | Your points this week, your rank and your share. |
/wallet <address> | Everyone | Sets the wallet your payroll is paid to. Checked before it's saved. |
/payrollexport | Admins, console | Writes this week's payday sheet now. |
/payrolladd <id> <points> | Admins, console | Adds 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.