⚙️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

Config.EnableRedeemCommand = true
Config.AllowGifting = true

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.

Config.RedeemablePurchaseTypes = {
    'vehicle',
    'aircraft',
    'boat',
    'vehicleplate',
    'item',
    'charslot',
    'job',
    'crypto',
    'keys'
}

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

Config.DefaultCharacterSlotCount = 1

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.

Config.AutoAddedVehicleGarage = 'legionsquare'
Config.AutoAddedAircraftGarage = 'lsiagen'
Config.AutoAddedBoatGarage = 'helitours'

Garage Labels

Used for in-game notifications.

Config.GarageLabels = {
    ['legionsquare'] = 'Legion Square Garage',
    ['lsiagen'] = 'LSIA Hangar',
    ['helitours'] = 'Heli Tours Marina'
}

---

Package Items

Package items grant multiple items when used.

Config.Packages = {
    ['starterpack'] = {
        { item = 'water_bottle', quantity = 1 },
        { item = 'apple', quantity = 3 },
        { item = 'banana', quantity = 2 },
    },
}

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

Config.CollectionEnabled = true

• 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.

Config.CollectionLocations

Each collection location includes:

• Label

• Blip settings

• NPC configuration

• Optional vehicle spawn point

• Allowed purchase types

---

Vehicle Collection Location Example:

['carcollection'] = {
    label = 'LS Port Vehicle Import Collection',
    blipType = 225,
    blipColor = 3,
    pedCoords = vector4(-100.0078, -2420.878, 5.9999976, 127.98809),
    pedModel = 's_m_m_autoshop_01',
    pedScenario = 'WORLD_HUMAN_CLIPBOARD',
    vehicleSpawn = vector4(-105.9824, -2420.995, 5.3948926, 90.061225),
    redeemableTypes = { 'vehicle' }
}

---

Aircraft Collection Location Example:

['aircraftcollection'] = {
    label = 'LSIA Aircraft Import Collection',
    blipType = 90,
    blipColor = 3,
    pedCoords = vector4(-1371.041, -3282.583, 13.944825, 354.61859),
    pedModel = 's_m_y_pilot_01',
    pedScenario = 'WORLD_HUMAN_CLIPBOARD',
    vehicleSpawn = vector4(-1386.29, -3253.213, 15.045687, 329.39147),
    redeemableTypes = { 'aircraft' }
}

---

Boat Collection Location Example:

['boatcollection'] = {
    label = 'Paleto Bay Marina Boat Import Collection',
    blipType = 68,
    blipColor = 3,
    pedCoords = vector4(-807.2622, -1497.218, 1.5952171, 296.89343),
    pedModel = 's_m_y_busboy_01',
    pedScenario = 'WORLD_HUMAN_CLIPBOARD',
    vehicleSpawn = vector4(-801.8897, -1499.768, 0.1197021, 110.08335),
    redeemableTypes = { 'boat' }
}

---

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

['otherimportcollections'] = {
    label = 'City Hall Import Collection',
    blipType = 605,
    blipColor = 3,
    pedCoords = vector4(-1285.137, -566.5561, 31.712402, 311.49661),
    pedModel = 's_m_y_busboy_01',
    pedScenario = 'WORLD_HUMAN_CLIPBOARD',
    redeemableTypes = { 'item', 'charslot', 'job', 'crypto', 'keys' }
}

---

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