βš™οΈConfiguration

Script Configuration (config.lua)

This page explains how to configure the script using the config.lua file. Each section below details what the setting controls and how it affects in-game behavior.


Staff Permissions

These settings control which permission group is required to use staff-only commands.

Config.ManageCommandAccess = 'god'
Config.ManageDoorLocksAccess = 'god'
Config.IssueManualPurchaseAccess = 'god'

Options

  • ManageCommandAccess Permission required to use:

    /managetebex
  • ManageDoorLocksAccess Permission required to use:

    /managedoorlocks
  • IssueManualPurchaseAccess Permission required to use:

    /issuetebexpurchase

Permission values must match your server’s configured permissions.


Redemption & Gifting Settings

Options

  • EnableRedeemCommand

    • true β†’ Players can redeem purchases via /redeem

    • false β†’ Players must collect purchases from configured locations

  • AllowGifting

    • true β†’ Players can gift redeemable / collectable purchases to other players

    • false β†’ Gifting is disabled


Redeemable Purchase Types

If /redeem is enabled, only the following purchase types will appear in the redeem menu.

Notes

  • vehicleplate must be redeemed via /redeem and cannot be collected from a location.

  • If you want plates to be collectible, issue a customplate item instead.

  • Ensure every purchase type is either redeemable or collectible to provide a fallback if auto-adding fails.


Character Slots

This value must match the default character slot count defined in your multicharacter configuration.


Auto-Added Garages

These garages are used when vehicles are automatically added.

Garage Labels

Used for in-game notifications.


Package Items

Package items grant multiple items when used.

How Packages Work

  • The key (starterpack) must match an item defined in shared.gta5.lua

  • When the package item is used, the player receives the configured items

  • You can add as many packages as you want


Collection System

  • true β†’ Enables physical collection locations

  • false β†’ All purchases must be redeemed via /redeem


Collection Locations

Collection locations allow players to claim purchases from NPCs placed around the map.

Each collection location includes:

  • Label

  • Blip settings

  • NPC configuration

  • Optional vehicle spawn point

  • Allowed purchase types


Vehicle Collection Location Example:


Aircraft Collection Location Example:


Boat Collection Location Example:


General Collection (Items, Jobs, Keys, etc.) Location Example:


Configuration Best Practices

  • Always ensure every purchase type is either redeemable or collectible

  • Keep permission roles restricted for sensitive commands

  • Test collection locations after changes

  • Use package items for bundles and starter kits

Last updated