Client Exports | 0Resmon

0R SmartTab — Client Exports Reference#

Complete reference for every client-side export available in 0r-smarttab.

-- Usage from any other client script
exports['0r-smarttab']:ExportName(...)

All exports below run on the client and apply to the local player unless stated otherwise.

Table of Contents#

#	Export	Category	Async
1	IsTabletOpen	Tablet State	No
2	OpenTabletWithApp	Tablet Control	No
3	SendNotification	Notifications	No
4	SetAppBadge	Notifications	No
5	GetPlayerByTabletSerial	Tablet Lookup	Yes (callback)
6	GetPlayerInvoiceList	Billing	Yes (callback)
7	GetPlayerInvoiceCount	Billing	Yes (callback)
8	GetPlayerUnpaidInvoiceCount	Billing	Yes (callback)
9	GetPlayerTotalDebt	Billing	Yes (callback)
10	GetMugShotBase64	Utility	Yes (yields)

Tablet State#

1. IsTabletOpen#

Check if the local player's tablet is currently open.

local isOpen = exports['0r-smarttab']:IsTabletOpen()

Returns	Type	Description
isOpen	boolean	`true` if the tablet UI is open

Example:

if exports['0r-smarttab']:IsTabletOpen() then
    print("Tablet is open right now")
else
    print("Tablet is closed")
end

Tablet Control#

2. OpenTabletWithApp#

Open the tablet and navigate directly to a specific app. The player must have a tablet item in their inventory (and satisfy metadata checks if enabled).

exports['0r-smarttab']:OpenTabletWithApp(appId)

Parameter	Type	Description
`appId`	string	App id or action from `server/apps.json`

Returns
nothing

Example:

-- Open the Mail app
exports['0r-smarttab']:OpenTabletWithApp("app-mail")

-- Open the Police MDT
exports['0r-smarttab']:OpenTabletWithApp("app-police")

-- Open the EMS app
exports['0r-smarttab']:OpenTabletWithApp("app-ems")

-- Open Settings
exports['0r-smarttab']:OpenTabletWithApp("settings")

-- Open a custom iframe app
exports['0r-smarttab']:OpenTabletWithApp("customapp")

Tip: You can find valid app IDs in server/apps.json. Each app has an id and/or action field — either one works.

Notifications#

3. SendNotification#

Push a notification to the local player's tablet. If the tablet is open, it appears immediately as an in-app notification. If the tablet is closed, it queues and plays a peek animation on screen.

exports['0r-smarttab']:SendNotification(data)

Parameter	Type	Description
`data`	table	Notification payload

Payload fields:

Field	Type	Required	Default	Description
`title`	string	yes	—	Notification title
`message`	string	yes	—	Body text
`app`	string	no	nil	App ID — determines the icon shown
`icon`	string	no	nil	Custom icon override
`duration`	number	no	4000	How long to show (ms)
`type`	string	no	nil	Optional type tag
`category`	string	no	nil	Optional category tag

Returns
nothing

Example:

exports['0r-smarttab']:SendNotification({
    title    = "New Order",
    message  = "You have a delivery waiting at the warehouse.",
    app      = "app-mail",
    duration = 5000
})

4. SetAppBadge#

Set a numeric badge on an app's home-screen icon. Useful for showing unread counts.

exports['0r-smarttab']:SetAppBadge(appId, count)

Parameter	Type	Description
`appId`	string	App ID (e.g. `"app-mail"`)
`count`	number	Badge number — pass `0` to clear

Returns
nothing

Example:

-- Show a badge of 5 on the mail app
exports['0r-smarttab']:SetAppBadge("app-mail", 5)

-- Clear the badge
exports['0r-smarttab']:SetAppBadge("app-mail", 0)

Tablet Lookup#

5. GetPlayerByTabletSerial#

Find the owner of a tablet by its serial number. Sends a request to the server and returns the result via callback. The owner must be online to be found.

exports['0r-smarttab']:GetPlayerByTabletSerial(serial, callback)

Parameter	Type	Description
`serial`	string	Tablet serial number (e.g. `"0R-A1B2C3"`)
`callback`	function	Called with the result table

Callback result:

Field	Type	Description
`source`	number \| nil	Player server ID (`nil` if offline / not found)
`citizenid`	string \| nil	Owner citizen ID / identifier
`name`	string \| nil	Player character name

Example:

exports['0r-smarttab']:GetPlayerByTabletSerial("0R-A1B2C3", function(result)
    if result.source then
        print("Owner: " .. result.name .. " (ID: " .. result.source .. ")")
    else
        print("No online player found for this serial")
    end
end)

Billing#

All billing exports fetch data from the server asynchronously. They return data for the local player only.

6. GetPlayerInvoiceList#

Get the full list of invoices (paid + unpaid) for the local player.

exports['0r-smarttab']:GetPlayerInvoiceList(callback)

Parameter	Type	Description
`callback`	function	Called with the invoice array

Each invoice object:

Field	Type	Description
`id`	number / string	Invoice ID
`title`	string	Invoice label
`sender`	string	Sender name or society
`amount`	number	Total amount (with interest if overdue)
`baseAmount`	number	Original amount before interest
`interestAmount`	number	Accrued interest (0 if not overdue)
`status`	string	`"unpaid"` / `"overdue"` / `"paid"`
`dueDate`	string	Formatted due date
`daysOverdue`	number	Days past the due date (0 if not overdue)

Example:

exports['0r-smarttab']:GetPlayerInvoiceList(function(invoices)
    print("You have " .. #invoices .. " invoice(s)")
    for _, inv in ipairs(invoices) do
        print((" - %s | $%d | %s"):format(inv.title, inv.amount, inv.status))
    end
end)

7. GetPlayerInvoiceCount#

Get the total number of invoices (paid + unpaid).

exports['0r-smarttab']:GetPlayerInvoiceCount(callback)

Parameter	Type
`callback`	function(count: number)

Example:

exports['0r-smarttab']:GetPlayerInvoiceCount(function(count)
    print("Total invoices: " .. count)
end)

8. GetPlayerUnpaidInvoiceCount#

Get the number of unpaid and overdue invoices only.

exports['0r-smarttab']:GetPlayerUnpaidInvoiceCount(callback)

Parameter	Type
`callback`	function(count: number)

Example:

exports['0r-smarttab']:GetPlayerUnpaidInvoiceCount(function(count)
    if count > 0 then
        print("You have " .. count .. " unpaid bill(s)!")
    end
end)

9. GetPlayerTotalDebt#

Get the total debt amount across all unpaid / overdue invoices (interest included).

exports['0r-smarttab']:GetPlayerTotalDebt(callback)

Parameter	Type
`callback`	function(totalDebt: number)

Example:

exports['0r-smarttab']:GetPlayerTotalDebt(function(debt)
    if debt > 0 then
        print("Total debt: $" .. debt)
    else
        print("No outstanding debt")
    end
end)

Utility#

10. GetMugShotBase64#

Capture a ped's headshot and return it as a base64 image string. This is a yielding call — it blocks the current thread until the headshot is ready (up to ~2 seconds).

local base64 = exports['0r-smarttab']:GetMugShotBase64(ped, transparent)

Parameter	Type	Description
`ped`	number	Ped entity handle
`transparent`	boolean	`true` for transparent background, `false` for default

Returns	Type	Description
base64	string	Base64-encoded image data (or empty string on failure)

Example:

local ped = PlayerPedId()
local photo = exports['0r-smarttab']:GetMugShotBase64(ped, false)

if photo and photo ~= "" then
    print("Headshot captured, length: " .. #photo)
end

Note: This function yields (uses Citizen.Await internally). Call it from a CreateThread or async context — do not call it from a synchronous NUI callback handler.

Quick Reference#

Export	Returns	Sync?
`IsTabletOpen()`	boolean	Sync
`OpenTabletWithApp(appId)`	—	Sync
`SendNotification(data)`	—	Sync
`SetAppBadge(appId, count)`	—	Sync
`GetPlayerByTabletSerial(serial, cb)`	via callback	Async
`GetPlayerInvoiceList(cb)`	via callback	Async
`GetPlayerInvoiceCount(cb)`	via callback	Async
`GetPlayerUnpaidInvoiceCount(cb)`	via callback	Async
`GetPlayerTotalDebt(cb)`	via callback	Async
`GetMugShotBase64(ped, transparent)`	string	Yielding