Documentation
Add, lock and sell FiveM character slots with Multicharacter: Tebex setup with sv_tebexSecret, transaction ID redeem, one-time vs monthly packages and the /addslot admin command.
Every player gets the free slots you configure. On top of those you can add locked slots: they appear in the selection room with a padlock, a Buy slot button that opens your Tebex store, and a field where the player pastes the transaction ID of their purchase. Staff can also unlock them by hand with /addslot.
Slot | Set with | Who can use it |
|---|---|---|
Free |
| Everyone. |
Locked |
|
Players who redeemed a Tebex purchase or were given the slot by staff. |
Unlocks belong to the player's Rockstar license, not to a character, and are stored in qs_multicharacter_slots. Locked slots open in order — the first purchase unlocks the lowest locked slot. When every locked slot is open, further redeems are refused with You have reached the maximum number of slots.
Slot 0 is always free. If you set
tebex = trueon the first slot the console prints an error and the setting is ignored — every player needs at least one character.
In config/main.lua, switch tebex on for each slot you want to sell. This example keeps two free slots and locks two:
Config.CharacterPositions = {
[0] = { coords = vec3(-1009.08, -475.67, 48.49), heading = 201.25, lookAt = vec3(-1005.92, -478.54, 50.02),
animation = { [0] = { dict = 'anim@amb@office@boardroom@boss@male@', anim = 'base' }, [1] = { dict = 'anim@amb@office@boardroom@boss@male@', anim = 'base' } },
tebex = false },
[1] = { --[[ ... ]] tebex = false },
[2] = { --[[ ... ]] tebex = true }, -- locked
[3] = { --[[ ... ]] tebex = true }, -- locked
}The number of slots equals the number of entries in Config.CharacterPositions. A new slot needs three entries, or its card never appears:
Add Config.CharacterPositions[4] with its coordinates, heading, look-at point, animations and tebex flag.
Add 4 to the slots list of an existing camera in Config.CharacterCameraPositions, or add a new camera that points at it.
[2] = { coords = vec3(-1005.28, -476.46, 50.02), pointAt = vec3(-1004.95, -476.04, 50.02), slots = { 3, 4 } },Add a fifth entry to Config.CharacterSlots with where the card sits on screen:
{ position = 'fixed', left = '50vw', top = '40vh' },Multicharacter checks each transaction ID against Tebex's API, so your server has to be connected to your Tebex store first.
In the Tebex creator panel, open Integrations in the left menu, then Game Servers.
Press Connect Game Server and choose Plugin.
Give the server a name and skip the Packages part. Tebex then shows a command with your secret key — copy it into server.cfg and restart the server:
sv_tebexSecret your-secret-keyWhen the indicator turns green and reads Connected, press Continue.
Go to Packages, press Add New → Package, and give it a title, description, image and price. One purchase unlocks one slot.
Put your store address in Config.TebexUrl so the Buy slot button opens it:
Config.TebexUrl = 'https://your-store.tebex.io'The package needs no game server command. The slot is unlocked when the buyer redeems their transaction ID, so an
addslot {transaction}command left over from an older guide only prints an error in the console — remove it from the package.
After paying, the player receives a transaction ID that starts with tbx- in their Tebex receipt. They can redeem it two ways:
In the selection room — on a locked card, under Have a transaction ID?, paste it and press Redeem. The slot opens on the spot.
In game — type /addslot tbx-XXXXXXXX in chat.
Each ID works once. A payment that is not complete, already used, or unknown to your store is rejected, and the menu allows one attempt every three seconds.
A slot from a one-time package is permanent. A slot from a monthly (recurring) package is checked against Tebex again and locks itself when the subscription ends — the character is kept, the card shows a padlock until the subscription is renewed.
Tebex does not say whether a package is monthly, so list the IDs of your recurring packages yourself:
Config.TebexAccess = {
SubscriptionPackageIds = {
[123456] = true, -- your monthly slot package
},
CheckCacheSeconds = 300, -- re-check a subscription at most every 5 minutes
FailOpenOnApiError = true, -- keep access if Tebex is down, instead of locking everyone out
}To find a package ID, open creator.tebex.io, go to Webstore → Packages, open the package and copy the number at the end of the URL (.../package/123456).
Without Tebex — or as a gift, a refund or an event prize — an admin unlocks the next locked slot for any online player:
/addslot [server id]Both players get a chat message, and the unlock is logged in qs_multicharacter_transactions as type admin. Admin unlocks are permanent. Who counts as an admin is listed on Commands and Exports.
Locked a slot but not using Tebex? The console reminds you that
sv_tebexSecretis missing. That is harmless as long as you only unlock slots with/addslot [server id]— the message mentions/giveslot, but the command is/addslot.