Skip to main content

Basic Configuration

Open config.lua to customize R_Store settings.

Framework Settings

R.Framework = "ESX" -- Options: ESX, qbcore, qbx
R.newESX = true -- Set to false for ESX 1.1
R.CoreName = "es_extended" -- Your core resource name
R.Inventory = "ox_inventory" -- Options: ESX, qb-inventory, ox_inventory, quasar

Target System

R.UseTarget = false -- Set to true if you use target
R.Target = "ox_target" -- Options: ox_target, qb-target

Debug Mode

R.Debug = false -- Enable for troubleshooting

Commands

Configure the commands players and admins can use:
R.GiveCreditCommand = "giveCredits" -- Console command to give credits
R.OpenStoreCommand = "store" -- User command to open store
R.ShowLicenseCommand = "storelicense" -- User command to copy license

Fast Key Access

Allow players to open the store with a hotkey:
R.EnableFastKey = true
R.ToggleKey = "F4" -- Key to open store
R.KeyText = "Open store" -- Key text for the command
Popular keys: F4, F5, F6. Avoid keys used by other scripts.

Currency Settings

Set which currency type is used for money purchases:
R.MoneyCurrency = "bank" -- Options: bank, cash, black_money, etc.

Enabled Pages

Control which categories are available in the store:
R.EnabledPages = {
    vehicles = true, -- Vehicle shop
    money = true, -- Money shop
    items = true, -- Item shop
    weapons = true, -- Weapon shop
}
Disable pages you don’t want to offer in your store.

Test Drive System

Configure the vehicle test drive feature:
R.TestDriveTime = 1 -- Duration in minutes
R.TestDriveCooldownTime = 5 -- Cooldown between tests (minutes)
R.TestDrivePos = vector4(-1274.5339, -3389.3430, 13.9401, 329.8687)

Setting Test Drive Location

  1. Go to your desired location in-game
  2. Type /getcoords or similar command
  3. Copy the vector4 coordinates
  4. Paste into R.TestDrivePos

NPC Configuration

Customize the store NPC:
R.Ped = {
    Model = "g_m_m_armboss_01", -- NPC model
    Scenario = "WORLD_HUMAN_AA_CLIPBOARD", -- Animation
    Location = vector4(-258.5634, -973.3538, 31.2200, 159.6876),
}

Map Blip

Configure the store blip on the map:
R.EnableBlip = true
R.BlipSettings = {
    Name = "Store", -- Blip name
    Pos = vector3(-258.5634, -973.3538, 31.2200),
    Sprite = 59, -- Blip icon
    Display = 4,
    Scale = 0.5, -- Blip size
    Colour = 15, -- Blip color
}
View all blip sprites and colors

Casino Integration

Link R_Store with R_Casino:
R.EnableCasino = false -- Set to true to show casino button
R.CasinoResourceName = "r_casino" -- Your r_casino resource name
R.CasinoCommand = "casino" -- Command to open casino
Only enable if you have R_Casino installed!

Notifications

Enable/disable purchase notifications:
R.EnablePurchaseNotifys = true

Logging

Enable Discord logging for purchases:
R.Enablelogs = true
Set your webhook in server/sv_custom.lua file.

Auto-Insert

Enable automatic database table creation:
R.EnableAutoinsert = true

Next Steps