Server Exports | 0Resmon

0R SmartTab — All Exports Reference#

Complete reference for every export available in 0r-smarttab, organized by side and category.

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

Table of Contents#

Server-Side Exports

#	Export	Category
1	IsPlayerTabletOpen	Tablet State
2	GetPlayerByTabletSerial	Tablet State
3	IsAppEnabled	App Management
4	GetAppJobRequirements	App Management
5	SendNotification	Notifications
6	SetAppBadge	Notifications
7	GetPlayerInvoiceList	Billing
8	GetPlayerInvoiceCount	Billing
9	GetPlayerUnpaidInvoiceCount	Billing
10	GetPlayerTotalDebt	Billing
11	CheckUnpaidBills	Billing
12	CreateInvoice	Billing
13	IsPlayerOnDuty	MDT / Police
14	CheckHasWarrant	MDT / Police
15	SendJail	Prison

Client-Side Exports

#	Export	Category
16	IsTabletOpen	Tablet State
17	OpenTabletWithApp	Tablet Control
18	SendNotification	Notifications
19	SetAppBadge	Notifications
20	GetPlayerByTabletSerial	Tablet State
21	GetPlayerInvoiceList	Billing
22	GetPlayerInvoiceCount	Billing
23	GetPlayerUnpaidInvoiceCount	Billing
24	GetPlayerTotalDebt	Billing
25	GetMugShotBase64	Utility

Server-Side Exports#

All of these run in server scripts only.

Tablet State#

1. IsPlayerTabletOpen#

Check whether a player currently has their tablet open.

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

Parameter	Type	Description
`source`	number	Player server ID

Returns	Type
is open	boolean

if exports['0r-smarttab']:IsPlayerTabletOpen(5) then
    print("Player 5 has their tablet open")
end

2. GetPlayerByTabletSerial#

Find the owner of a tablet by its serial number. The owner must be online.

local source, citizenId, name = exports['0r-smarttab']:GetPlayerByTabletSerial(serial)

Parameter	Type	Description
`serial`	string	Tablet serial (e.g. `"0R-A1B2C3"`)

Returns	Type	Description
source	number \| nil	Player server ID
citizenId	string \| nil	Owner citizen ID
name	string \| nil	Player character name

local src, cid, name = exports['0r-smarttab']:GetPlayerByTabletSerial("0R-A1B2C3")
if src then
    print(name .. " owns this tablet (server id: " .. src .. ")")
end

App Management#

3. IsAppEnabled#

Check if a specific app is enabled in server/apps.json.

local enabled = exports['0r-smarttab']:IsAppEnabled(appId)

Parameter	Type	Description
`appId`	string	App ID (e.g. `"app-mail"`, `"app-police"`)

Returns	Type
enabled	boolean

if exports['0r-smarttab']:IsAppEnabled("app-mail") then
    print("Mail app is active")
end

4. GetAppJobRequirements#

Get all job-restricted apps and which jobs they require.

local requirements = exports['0r-smarttab']:GetAppJobRequirements()

Parameters	—
none

Returns	Type	Description
requirements	table	`{ [appId] = { "job1", "job2" } }`

local reqs = exports['0r-smarttab']:GetAppJobRequirements()
-- reqs["app-police"] = { "police", "sheriff" }
-- reqs["app-ems"]    = { "ambulance" }

Notifications#

5. SendNotification (Server)#

Send a notification to a player's tablet from the server. Shows immediately if the tablet is open, otherwise queues as a peek notification.

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

Parameter	Type	Description
`targetSrc`	number	Target player server ID
`data`	table	Notification payload

Payload fields:

Field	Type	Required	Description
`title`	string	yes	Title
`message`	string	yes	Body text
`app`	string	no	App ID for icon
`icon`	string	no	Custom icon
`duration`	number	no	Duration in ms (default 4000)

exports['0r-smarttab']:SendNotification(source, {
    title    = "Delivery",
    message  = "New package available for pickup.",
    app      = "app-mail",
    duration = 5000
})

6. SetAppBadge (Server)#

Set a badge counter on an app icon for a player (from server).

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

Parameter	Type	Description
`targetSrc`	number	Target player server ID
`appId`	string	App ID
`count`	number	Badge number (0 to clear)

exports['0r-smarttab']:SetAppBadge(source, "app-mail", 3)

Billing#

7. GetPlayerInvoiceList#

Get the full invoice list for a player (paid + unpaid). Reads from phone_invoices (QBCore/Qbox) or billing (ESX).

local invoices = exports['0r-smarttab']:GetPlayerInvoiceList(source)

Parameter	Type	Description
`source`	number	Player server ID

Returns	Type
invoices	table \| nil

Each invoice object:

Field	Type	Description
`id`	number/string	Invoice ID
`title`	string	Label
`sender`	string	Sender name / society
`amount`	number	Total (with interest)
`baseAmount`	number	Original amount
`interestAmount`	number	Accrued interest
`status`	string	`"unpaid"` / `"overdue"` / `"paid"`
`dueDate`	string	Due date
`daysOverdue`	number	Days past due

local list = exports['0r-smarttab']:GetPlayerInvoiceList(source)
if list then
    for _, inv in ipairs(list) do
        print(inv.title, inv.amount, inv.status)
    end
end

8. GetPlayerInvoiceCount#

Total number of invoices (paid + unpaid).

local count = exports['0r-smarttab']:GetPlayerInvoiceCount(source)

Parameter	Type
`source`	number

Returns	Type
count	number

9. GetPlayerUnpaidInvoiceCount#

Number of unpaid + overdue invoices only.

local unpaid = exports['0r-smarttab']:GetPlayerUnpaidInvoiceCount(source)

Parameter	Type
`source`	number

Returns	Type
count	number

10. GetPlayerTotalDebt#

Total debt across all unpaid/overdue invoices (interest included).

local debt = exports['0r-smarttab']:GetPlayerTotalDebt(source)

Parameter	Type
`source`	number

Returns	Type
totalDebt	number

11. CheckUnpaidBills#

Quick boolean check + count for unpaid bills.

local hasUnpaid, count = exports['0r-smarttab']:CheckUnpaidBills(source)

Parameter	Type
`source`	number

Returns	Type	Description
hasUnpaid	boolean	`true` if any unpaid bills exist
count	number	Number of unpaid bills

local hasUnpaid, count = exports['0r-smarttab']:CheckUnpaidBills(source)
if hasUnpaid then
    print("Player owes " .. count .. " bill(s)")
end

12. CreateInvoice#

Create a new invoice for a target citizen. Officer info is auto-resolved from source. Supports QBCore/Qbox (phone_invoices) and ESX (billing).

exports['0r-smarttab']:CreateInvoice(source, targetId, amount, reason)

Parameter	Type	Description
`source`	number	Officer / sender server ID
`targetId`	string	Target citizen ID / identifier
`amount`	number	Amount (> 0)
`reason`	string	Invoice label / reason

Returns nothing (async).

exports['0r-smarttab']:CreateInvoice(source, "ABC12345", 5000, "Speeding violation")

MDT / Police#

13. IsPlayerOnDuty#

Check if a player is currently on duty (job onduty flag).

local onDuty = exports['0r-smarttab']:IsPlayerOnDuty(source)

Parameter	Type
`source`	number

Returns	Type
onDuty	boolean

if exports['0r-smarttab']:IsPlayerOnDuty(source) then
    print("Officer is on duty")
end

14. CheckHasWarrant#

Check if a citizen has active warrants in the MDT.

local hasWarrant, count, records = exports['0r-smarttab']:CheckHasWarrant(citizenid)

Parameter	Type
`citizenid`	string

Returns	Type	Description
hasWarrant	boolean	`true` if warrants exist
count	number	Number of warrants
records	table	Array of warrant rows

local has, count, recs = exports['0r-smarttab']:CheckHasWarrant("ABC12345")
if has then
    print(count .. " active warrant(s)")
end

Prison#

15. SendJail#

Send a player to jail. Auto-detects the prison resource (xt-prison, qb-prison, qb-policejob, esx_policejob).

exports['0r-smarttab']:SendJail(source, targetId, jailTime)

Parameter	Type	Description
`source`	number	Officer server ID
`targetId`	string	Target citizen ID / identifier
`jailTime`	number	Time in months/minutes (> 0)

Returns nothing. Target must be online.

exports['0r-smarttab']:SendJail(source, "ABC12345", 30)

Client-Side Exports#

All of these run in client scripts only and affect the local player.

Tablet State & Control#

16. IsTabletOpen#

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

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

Parameters	—
none

Returns	Type
isOpen	boolean

if exports['0r-smarttab']:IsTabletOpen() then
    print("My tablet is open")
end

17. OpenTabletWithApp#

Open the tablet and jump directly to a specific app. The player must have a tablet item in their inventory.

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

Parameter	Type	Description
`appId`	string	App ID or action from `apps.json`

Returns nothing.

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

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

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

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

Notifications#

18. SendNotification (Client)#

Send a notification to the local player's tablet. If open, appears immediately; if closed, queues and shows a peek animation.

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

Parameter	Type	Description
`data`	table	Notification payload (same fields as server version)

exports['0r-smarttab']:SendNotification({
    title   = "Alert",
    message = "Something happened nearby.",
    app     = "app-police",
    duration = 4000
})

19. SetAppBadge (Client)#

Set a badge counter on an app icon (local player only).

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

Parameter	Type	Description
`appId`	string	App ID
`count`	number	Badge number (0 to clear)

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

Tablet Lookup (Async)#

20. GetPlayerByTabletSerial (Client)#

Look up a tablet's owner by serial number. Queries the server asynchronously.

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

Parameter	Type	Description
`serial`	string	Tablet serial number
`callback`	function	`function(result)` — result is a table

Result table:

Field	Type
`source`	number \| nil
`citizenid`	string \| nil
`name`	string \| nil

exports['0r-smarttab']:GetPlayerByTabletSerial("0R-A1B2C3", function(result)
    if result.source then
        print(result.name .. " — server id: " .. result.source)
    end
end)

Billing (Async)#

All client billing exports query the server and return data via callback.

21. GetPlayerInvoiceList (Client)#

exports['0r-smarttab']:GetPlayerInvoiceList(function(list)
    for _, inv in ipairs(list) do
        print(inv.title, inv.amount, inv.status)
    end
end)

Parameter	Type
`callback`	function(list)

22. GetPlayerInvoiceCount (Client)#

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

Parameter	Type
`callback`	function(count)

23. GetPlayerUnpaidInvoiceCount (Client)#

exports['0r-smarttab']:GetPlayerUnpaidInvoiceCount(function(count)
    print("Unpaid: " .. count)
end)

Parameter	Type
`callback`	function(count)

24. GetPlayerTotalDebt (Client)#

exports['0r-smarttab']:GetPlayerTotalDebt(function(debt)
    print("Total debt: $" .. debt)
end)

Parameter	Type
`callback`	function(totalDebt)

Utility#

25. GetMugShotBase64#

Capture a ped's headshot as a texture dictionary string (for NUI/UI display).

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

Parameter	Type	Description
`ped`	number	Ped handle
`transparent`	boolean	Use transparent background

Returns	Type	Description
txd	string	Texture dictionary name (`"none"` on failure)

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