Configuration | 0Resmon

Fetching Players' Email Addresses#

This document shows how to call the GetPlayerEmail export from the kibra-smartpad resource in your FiveM scripts. Simply copy and paste the examples below into your server or client scripts.

Server-Side Usage#

-- In your other server script:
local playerServerId = source -- or any valid server ID
local email = exports['kibra-smartpad']:GetPlayerEmail(playerServerId)

if email ~= 'notFound' then
    print(('Player %d email: %s'):format(playerServerId, email))
else
    print(('No email configured for player %d'):format(playerServerId))
end

Client-Side Usage#

Since the export is exposed to the client without parameters, you can retrieve the local player’s email directly:

-- client.lua
local email = exports['kibra-smartpad']:GetPlayerEmail()
if email ~= 'notFound' then
    print('My email:', email)
else
    print('Email not set')
end

StartMiniGame Usage#

Use the StartMiniGame export in any script where you want to trigger the minigame (like a robbery or hacking).

local CloseTablet = true -- Ensures that the tablet shuts down after the minigame ends.
local CloseApp = false -- Ensures that the hack application closes after the minigame ends.
local NumderOfTrials = 5 -- Number of failures
local result = exports['kibra-smartpad']:StartMiniGame(CloseTablet, CloseApp, NumderOfTrials)

if result then
    -- Minigame success
else
    -- Minigame failed
end

Creating New Mail Records#

You can create and send a new mail entry using the CreateNewMail export. For example, register a server command:

RegisterCommand('testmail', function(source, args)
    local Receiver = 'boruhan.naster@0resmon.com'
    local MailContent = {
        subject = 'Urgent: You Have Unpaid Debts',
        message = "Hello, you have unpaid invoices to our mechanical company. We kindly ask you to pay.",
    }
    local From_Name = 'Los Santos Mechanic'
    local From = 'lossantos@0resmon.com'
    local Type = 0
    exports['kibra-smartpad']:CreateNewMail(Receiver, MailContent, From_Name, From, Type)
end)

Receiver (string): The recipient's email address.
MailContent (table): A table with subject and message keys.
From_Name (string): The display name of the sender.
From (string): The sender's email address.
Type (number): A numeric identifier for mail type (e.g., 0 for normal mail).

Copy and paste these snippets to integrate email retrieval and creation quickly!

Custom Create Invoice#

This export allows you to create and send a bill (invoice) to a player through the in-game tablet.

exports["kibra-smartpad"]:CreateNewBill(identifier, dueDate, products, status, note, jobName)

📌 Parameters#

Parameter	Type	Description
`identifier`	string	The target player's unique ID (Steam or Rockstar license).
`dueDate`	string	The bill's due date. Must be in the format `"YYYY-MM-DD"`, e.g., `"2025-06-29"`.
`products`	table	A list of products or services included in the bill. See format below.
`status`	number	Bill status: `0` for Pending, `1` for Paid.
`note`	string	Optional note added to the bill, e.g., `"Please pay your invoice."`
`jobName`	string	The job of the player creating the bill (e.g., `"mechanic"` or `"police"`).

Place events, exports or functions that hide and open your border within these functions.

Example Usage#

RegisterCommand('testbill', function(source)
    local Player = Resmon.Lib.GetPlayerFromSource(source)

    local DueDate = '2025-06-29'

    local Products = {
        {
            Description = 'Car Repair',
            Quantity = 1,
            Price = 1000
        }
    }

    local Status = 0 -- Pending
    local Note = 'Please pay your invoice.'

    exports["kibra-smartpad"]:CreateNewBill(
        Player.identifier,
        DueDate,
        Products,
        Status,
        Note,
        Player.job.name
    )
end)

Fetching Players' Email Addresses#

This document shows how to call the GetPlayerEmail export from the kibra-smartpad resource in your FiveM scripts. Simply copy and paste the examples below into your server or client scripts.

Server-Side Usage#

-- In your other server script:
local playerServerId = source -- or any valid server ID
local email = exports['kibra-smartpad']:GetPlayerEmail(playerServerId)

if email ~= 'notFound' then
    print(('Player %d email: %s'):format(playerServerId, email))
else
    print(('No email configured for player %d'):format(playerServerId))
end

Client-Side Usage#

Since the export is exposed to the client without parameters, you can retrieve the local player’s email directly:

-- client.lua
local email = exports['kibra-smartpad']:GetPlayerEmail()
if email ~= 'notFound' then
    print('My email:', email)
else
    print('Email not set')
end

Copy and paste these snippets to integrate email retrieval quickly!

How to Use GiveTablet Function on Server Side#

This function allows you to give a unique SmartPad tablet to a player in your FiveM server, with an automatically generated serial number.

Usage#

You can trigger this function from a server-side command, admin menu, or any other server script.

Example: Using with a Command#

RegisterCommand('givetablet', function(source, args)
    exports['kibra-smartpad']:GiveTablet(source)
end)

GetPlayerUnpaidInvoices#

Description#

Retrieves all unpaid invoices for a given player from the kibra-smartpad resource.

Usage#

-- In a server-side script
local source = source -- FiveM player source ID
local unpaidInvoices = exports['kibra-smartpad']:GetPlayerUnpaidInvoices(source)

Parameters#

source (number): The server ID of the player whose unpaid invoices you wish to fetch.

Returns#

(table): An array of invoice objects. Each object contains:
- id (number): Invoice identifier.
- amount (number): Amount due.
- dueDate (string): Due date in ISO format (YYYY-MM-DD).
- issuedDate (string): Date the invoice was issued.
- status (string): Invoice status ("unpaid").

Example#

-- Example: Check a player's unpaid invoices and send a chat message
RegisterCommand('checkInvoices', function(source, args, rawCommand)
    local invoices = exports['kibra-smartpad']:GetPlayerUnpaidInvoices(source)

    if #invoices > 0 then
        for _, invoice in ipairs(invoices) do
            TriggerClientEvent('chat:addMessage', source, {
                args = {
                    string.format(
                        'Invoice #%d: $%0.2f due on %s',
                        invoice.id,
                        invoice.amount,
                        invoice.dueDate
                    )
                }
            })
        end
    else
        TriggerClientEvent('chat:addMessage', source, {
            args = { 'You have no unpaid invoices!' }
        })
    end
end, false)

Notes#

This export must be called from a server-side context.
Ensure the kibra-smartpad resource is started before invoking this export.