Skip to Content
Cobalt

Logs and uploads

cobalt_core exports: logs and uploads.

Log

Server

Queues a log event for FiveMesh. category becomes the event type (banking.deposit), the calling resource fills resource, and security is sent as warn with a security. type prefix. Queued events go out in batches every 5 seconds and on stop. Returns false when FiveMesh is disabled or the arguments are invalid.

exports.cobalt_core:Log(category, message, data, level)
ParameterTypeOptionalDescription
categorystringNo
messagestringNoup to 2048 characters
datatableYesJSON object stored with the event
levelLogLevelYesdefaults to info
ReturnsDescription
booleanqueued
Example
local queued = exports.cobalt_core:Log(
    'garages',
    'Vehicle stored in Legion Square garage',
    { plate = 'COBALT01', garage = 'legion' },
    'debug'
)

LogPlayer

Server

Log with the player's server id, identifiers and citizenid attached, plus a target player's when given.

exports.cobalt_core:LogPlayer(source, category, message, data, level, target)
ParameterTypeOptionalDescription
sourceintegerNo
categorystringNo
messagestringNo
datatableYes
levelLogLevelYes
targetintegerYes
ReturnsDescription
booleanqueued
Example
local queued = exports.cobalt_core:LogPlayer(
    source,
    'garages',
    'Vehicle stored in Legion Square garage',
    { plate = 'COBALT01', garage = 'legion' },
    'debug',
    targetId
)

UploadFile

Server

Uploads a Base64 file to the FiveMesh CDN and returns its public URL. Yields; retries 429 and 5xx.

exports.cobalt_core:UploadFile(path, data, contentType)
ParameterTypeOptionalDescription
pathstringNofolder and file name, such as uploads/phone/123.webp
datastringNostandard Base64 or a data:<type>;base64, URL
contentTypestringYessuch as image/webp
ReturnsDescription
string?url
string?error
Example
local url, error = exports.cobalt_core:UploadFile(
    'screenshots/crash.png',
    'base64-encoded file contents',
    'image/png'
)

On this page