General Installation

1. Put the folder in your server resources, for example:

   • resources/[ambr4]/ambr4_ticket

2. Keep folder name as ambr4_ticket.

3. Import:

   • ambr4_ticket.sql in your database.

   • Note: the script also auto-creates/migrates tables on startup if DB permissions are correct.

4. Configure config.lua file

Set these values:

Config.Framework = "esx"    -- "esx", "qbcore", or "qbox"
Config.Inventory = "ox"     -- "ox", "esx", or "qb"

Config.AdminGroups = {
    admin = true,
    mod = true,
    superadmin = true,
    god = true
}

Config.Command = "tickets"
Config.OpenKey = "f7"
Config.Locale = "en"

Config.UseDiscordAvatars = true
Config.DiscordBotToken = ""         -- set your bot token or leave empty/disable avatars
Config.EnableDiscordWebhooks = true
Config.DiscordWebhookUrl = ""       -- optional

Important:

Replace/remove any test tokens/webhooks before release.

For QBCore/Qbox, ensure your permission/group names are included in Config.AdminGroups.

5. Add to server.cfg (start order matters)

Use the correct order for your framework.

Example ESX:

ensure oxmysql
ensure es_extended
ensure ox_inventory    # if you use Config.Inventory = "ox"
ensure ambr4_ticket

Example QBCore:

ensure oxmysql
ensure qb-core
ensure ox_inventory    # if you use Config.Inventory = "ox"
ensure ambr4_ticket

Example Qbox:

ensure oxmysql
ensure qbx_core
ensure ox_inventory    # if you use Config.Inventory = "ox"
ensure ambr4_ticket

6. Start server, or run:

• ensure ambr4_ticket

7. First-run validation checklist:

• Open game and run /tickets (or press F7).

• Create a test ticket.

• Confirm ticket appears in Active tab.

• Confirm message sending works.

• Confirm DB rows appear in:

  • ambr4_tickets

  • ambr4_ticket_messages

• If admin account is configured, confirm admin actions and ratings panel visibility.

• If Discord enabled, confirm avatar/webhook behavior.

Dependencies

oxmysql

oxmysql is required. It handles all SQL operations for tickets, messages, ratings, audit logs, and image storage. Make sure it starts before ambr4_ticket.

ox_lib

ox_lib is utilized for its optimized and useful functions alongside its responsive interface options.

es_extended or qb-core or qbox

This script is compatible with ESX, qb-core and Qbox, offering flexibility and compatibility for various server setups.