Docs/ORB Donations/Tebex & Credits

Tebex & Credits

Players pay real money on Tebex for credits, then spend those credits in the in-game store. Credits arrive through one Tebex command.

Setup

  1. 01Set sv_tebexSecret in your server.cfg.
  2. 02In your Tebex package, add one game-server command and tick "execute even if the player is offline":
orb_donate_credit {"transid":"{transaction}","identifier":"{id}","credit":"1000"}

Change 1000 to whatever that package grants. There is no store setting to change{id} works out of the box.

Use `{id}`, not `{username}` or `{hexid}`

VariableWhat it isVerdict
{id}The player's Cfx.re UUIDWorks online and offline, for everyone
{username}The player's display nameNot an identifier
{hexid}The Steam idBlank for players without Steam
{sid}Server idOnly exists while online

The credit is banked under whatever identifier arrived and swept onto the player's character the next time they load or open the store, so offline purchases work. Every transid is recorded, so a retried or manually re-run command is ignored instead of paying out twice.

Credit packages (the "Buy Credit" tab)

The packages shown in the store's Buy Credit tab are edited in-game from the admin panel's Settings tab — add, remove, re-price, and set each one's Tebex link there. Config.BuyCredits in config.lua is only the starting set for a fresh install.

Testing without Steam or Tebex

Run in the server console while the target player is online:

orb_donations_testtebex <serverId> [amount]

It prints every identifier that player has, then banks credit under their Cfx.re id and delivers it to their character — the exact path a real purchase takes.

To replay a real Tebex command, first clear its recorded transaction (Tebex reuses the id on resend):

orb_donations_forget <transid>

Set Config.Debug = true to print the raw JSON of every Tebex command received.

Commands

CommandWhoWhat
/donateEveryoneOpen the store (also F10, configurable)
/addcredit AdminGive credits — a negative amount removes
/checkcredit [id]AdminRead a player's balance

Admin access passes if any of these is true: the orb.donations ACE, an admin rank in your framework, a group. ACE, or blanket command access. When someone is denied, the console prints exactly which routes were checked.