Integrations | Quasar Store

Integrations | Quasar Store

How Integrations Work#

When the server starts, the phone looks for the resources below by name and uses the first one it finds running. You do not set anything. Each one is wired through a small, unencrypted bridge file you can read and edit.

Layer	Supported	Without it
Framework	es_extended · qb-core · qbx_core · vrp (experimental)	Standalone: no jobs or framework money.
Inventory	qs-inventory · ox_inventory · qb-inventory · l2s-inventory · ps-inventory · origen_inventory · core_inventory · codem-inventory · tgiann-inventory · ak47_inventory · ak47_qb_inventory

lua

local frameworks = {
    ['es_extended'] = 'esx',
    ['qb-core'] = 'qb',
    ['qbx_core'] = 'qb',
    ['my-renamed-core'] = 'qb', -- your renamed resource
}

local inventories = {
    ['qs-inventory'] = 'qs-inventory',
    ['ox_inventory'] = 'ox_inventory',
    ['my-inventory'] = 'qb-inventory', -- a qb-inventory fork
    -- ...
}

Layer

Folder

Framework

custom/esx/ · custom/qb/ · custom/vrp/ · custom/standalone/

Inventory

server/custom/inventory/adapters/

Garages

server/custom/garage/

Billing

client/custom/billing/ · server/custom/billing/

Vehicle keys

client/custom/vehiclekeys/

Ambulance

client/custom/ambulances/

Notifications, text UI, HUD

custom/client.lua · custom/server.lua

lua

Config.ShowWebhookIP = false -- show the player's IP in the embed

_G.webhook = {
    global = '',
    pictagram = '',   -- posts, comments, likes, follows, stories, live
    tweedle = '',     -- Chirpy: posts, replies, likes, reposts, follows
    beatzy = '',      -- videos, comments, likes, follows, account deletion
    yellowpages = '', -- Findly listings created and deleted
    weazel = '',      -- News articles created, edited and deleted
}

Resource	App	What it does
`qs-smartphone-aura`	Aura AI	Voice assistant: hold B and speak to call, text or open apps.
`phone-radio`	Radio	Talk on frequencies; private channels from `Config.RadioPrivateChannels`.
`phone-recorder`	Recorder	Voice memos.
`phone-booth`	Phone Booths	Public booths for anonymous paid calls, with or without a phone.
`phone-disaster`	Disaster Alarm	City-wide emergency alerts sent by an admin with `/disasteralarm <type> [message]`.
`phone-qchat`	QChat	Real-time chat for both FiveM and mobile.

Resource	App	Requires
`phone-biohazard`	Biohazard	qs-biohazard
`phone-bunkerhq`	Bunker HQ	qs-bunkers-creator
`phone-careershq`	Careers HQ	qs-jobcenter
`phone-crime`	Crime	qs-crime-creator
`phone-deathmatch`	Deathmatch	qs-deathmatch
`phone-diamondcasino`	Diamond Casino	qs-diamondcasino
`phone-fuelstations`	LTD Gasoline	qs-fuelstations
`phone-lottery`	Monkey Lotto	qs-lottery-creator
`phone-motels`	Moteling	qs-motels-creator
`phone-racing`	Racing	qs-advancedracing
`phone-restaurant`	Foodadvisor	qs-restaurant-creator
`phone-tuneshop`	Tuneshop	qs-mechanic-creator
`phone-vendingmachine`	VendGo	qs-vendingmachine-creator
`phone-yacht`	Yacht	qs-yacht

lua

Config.Aura = {
    enabled = true,              -- false = hide Aura even with the add-on installed
    pushToTalkKey = 'B',
    maxRecordingSeconds = 30,
    whisperLanguage = 'english', -- language hint, or 'auto'
}

lua

local ui = 'https://cfx-nui-' .. GetCurrentResourceName() .. '/ui/build/'

local ok, err = exports['qs-smartphone']:addCustomApp({
    id = 'my_app',
    label = 'My App',
    icon = ui .. 'icon.webp',
    category = 'Utilities',
    creator = 'Your Name',
    description = 'Short description for the store.',
    appStoreOnly = true, -- false = installed on the home screen
    price = 450,         -- optional; > 0 = paid download
    sizeMb = 5,
    iframe = { url = ui .. 'index.html' },
    custom = {
        enabled = true,
        bridge = {
            enabled = true,
            allowedOrigins = { 'https://cfx-nui-' .. GetCurrentResourceName() },
        },
    },
})

if not ok then
    print('addCustomApp failed:', err)
end

javascript

const { bridge, api } = QSPhoneBridge.create({
    appId: 'my_app',
    targetOrigin: 'https://cfx-nui-qs-smartphone',
})

api.onReady(() => console.log('Phone bridge ready'))

const state = await api.getPhoneState()   // { visible, mode, activeApp, screen }
const locale = await api.getPhoneLocale() // 'en', 'es', ...
const theme = await api.getThemeMode()

await api.showToastNotification({ title: 'Done', text: 'Saved successfully' })
const name = await api.openTextPrompt({ title: 'Rename', placeholder: 'Name' })
const media = await api.pickGalleryMedia({ mediaFilter: 'photos' })
const photo = await api.pickCameraMedia() // null if cancelled

Method	Does
`getPhoneState · getPhoneLocale · getThemeMode`	Read the phone's state, language and dark/light mode.
`translateText(key)`	A phone translation in the player's language.
`openPhoneApp(id) · closeCurrentPhoneApp()`	Open a built-in app, or close yours.
`showToastNotification · openTextPrompt · openOptionPicker`	Native phone toasts, text inputs and option lists.
`pickGalleryMedia · pickCameraMedia · pickGif`	Let the player pick a photo, take one, or choose a GIF.
`startRecorder · stopRecorder`	Record a voice clip.
`showDynamicIsland · updateDynamicIsland · hideDynamicIsland · getDynamicIsland`	Your own Dynamic Island, from the app.