> For the complete documentation index, see [llms.txt](https://brunx-mods.gitbook.io/brunx-mods-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://brunx-mods.gitbook.io/brunx-mods-docs/products/scripts/cinema-system/frameworks/server-guide.md).

# Server guide

Make sure to check the qb.lua and esx.lua files for examples on how to implement the script for your framework. They are always up to date with the latest changes.

## Framework functions

### getIdentifier

This function is used to retrieve a player's identifier to manage and verify tickets.

***

```lua
-- This is an example from the brnx-cinemasystem esx.lua file

-- @param source: number
getIdentifier = function(source)
    return GetPlayerIdentifierByType(source, 'license')
end
```

### canAcessThePanel

***

This function is used to check who can access the tablet.

```lua
-- This is an example from the brnx-cinemasystem esx.lua file

-- @param source: number
canAcessThePanel = function(source)
    local license <const> = GetPlayerIdentifierByType(source, 'license')
    if not license then return false end
    local licenses <const> = {
        ['license:xxxxxxxxxxxxxxxxxxxxxxxx'] = true
    }
    return licenses[license]
end
```

### tryPayment

***

This function is used to attempt to process the payment.

```lua
-- This is an example from the brnx-cinemasystem esx.lua file

-- @param source: number
-- @param price: number
tryPayment = function(source, price)
    local player = ESX.GetPlayerFromId(source)
    if player then
        if (price) and price > 0 then
            if (player?.getAccount("bank")?.money >= price) then
                player.removeAccountMoney("bank", price)
                return true
            end
            return false
        end
    end
    return true
end
```

### buyTicket

***

This function is used to buy the tickets

```lua
-- This is an example from the brnx-cinemasystem esx.lua file

-- @param source: number
-- @param data: table (cinema:string | id:number | room:string | time:string)
-- @param filmData: table (name:string | minutes:string | img:string | synopsis:string | schedules:table | price:number)
buyTicket = function(source, data, filmData)
    if config.item.enabled then
        if tryPayment(source, filmData.price) then
            addItem(source, config.item.spawn, 1)

            setItemMeta(source, {
                room = data.room,
                schedule = data.time,
                date = os.time()
            })

            createHistoric(source, { 
                product = filmData.name, 
                price = filmData.price 
            })

            TriggerClientEvent('brnx-cinemasystem:notify', source, 'success', L('NOTIFYS.PURCHASE_TICKET', {
                name = filmData.name,
                hour = data.time,
                room = data.room,
                price = Lib.Shared.formatCurrency(filmData.price, L('CURRENCY'))
            }), 5000)
        else
            TriggerClientEvent('brnx-cinemasystem:notify', source, 'denied', L('NOTIFYS.NO_PURCHASE_TICKET'), 5000)
        end
    else
        local identifier <const> = getIdentifier(source)
        
        local hasTicket <const> = oxmysql:scalar_async(GET_TICKET_DB, { identifier, data.room, data.time })
        if not hasTicket then
            if tryPayment(source, filmData.price) then
                oxmysql:insert_async([[
                    INSERT IGNORE INTO 
                        brnx_cinema_tickets(identifier,room,schedule)
                    VALUES(?,?,?)
                ]], { identifier, data.room, data.time })

                createHistoric(source, { 
                    product = filmData.name, 
                    price = filmData.price 
                })

                TriggerClientEvent('brnx-cinemasystem:notify', source, 'success', L('NOTIFYS.PURCHASE_TICKET', {
                    name = filmData.name,
                    hour = data.time,
                    room = data.room,
                    price = Lib.Shared.formatCurrency(filmData.price, L('CURRENCY'))
                }), 5000)
            else
                TriggerClientEvent('brnx-cinemasystem:notify', source, 'denied', L('NOTIFYS.NO_PURCHASE_TICKET'), 5000)
            end
        else
            TriggerClientEvent('brnx-cinemasystem:notify', source, 'denied', L('NOTIFYS.HAS_TICKET'), 5000)
        end
    end
end
```

data:

* cinema: `string`
* id: `number`
* room: `string`
* time: `string`

filmData:

* name: `string`
* minutes: `string`
* img: `string`
* synopsis: `string`
* schedules: `table`
* price: `number`

### buyItem

***

This function is used to purchase items from the cinema store.

```lua
-- This is an example from the brnx-cinemasystem esx.lua file

-- @param source: number
-- @param itemData: table (item:string | label:string | image:string | price:number)
buyItem = function(source, itemData)
    local amount <const> = 1
    if canAddItem(source, itemData.item, amount) then
        if tryPayment(source, itemData.price) then
            addItem(source, itemData.item, amount)

            createHistoric(source, { 
                product = itemData.label, 
                price = itemData.price 
            })

            TriggerClientEvent('brnx-cinemasystem:notify', source, 'success', L('NOTIFYS.PURCHASE_ITEM', {
                name = itemData.label,
                price = Lib.Shared.formatCurrency(itemData.price, L('CURRENCY'))
            }), 5000)
        else
            TriggerClientEvent('brnx-cinemasystem:notify', source, 'denied', L('NOTIFYS.NO_PURCHASE_ITEM'), 5000)
        end
    else
        TriggerClientEvent('brnx-cinemasystem:notify', source, 'denied', L('NOTIFYS.NO_SPACE'), 5000)
    end
end
```

itemData:

* item: `string`
* label: `string`
* image: `string`
* price: `number`