FiveM · contrato v1
Logs estruturados, sem depender da sua base.
O Traki é um resource server-side standalone. Qualquer resource Lua pode registrar eventos explicitamente com um único export, sem ESX ou QBCore.Como funciona
- O Owner cria uma instalação para um servidor no painel do Traki.
- O operador adiciona o resource e a credencial somente ao FXServer.
- Resources consumidores chamam o export server-side quando algo relevante acontece.
- O Traki valida, enfileira e envia os eventos sem bloquear a execução do servidor.
Seu primeiro log
Chame o export somente depois de validar a ação no servidor. O nome do resource, o ID e a data do evento são preenchidos pelo Traki.
local result = exports.traki:log({
event = 'economy.purchase',
severity = 'info',
message = 'Compra concluída',
author = source,
metadata = {
item = 'water',
amount = 2
}
})
if not result.accepted then
print(('Traki recusou o evento: %s'):format(result.error))
endContinue por aqui
Instalar o resource Configure a credencial, a ordem de inicialização e valide o heartbeat.Conhecer o export Consulte campos, limites, retorno e códigos de erro do contrato v1.Adaptar exemplos Veja padrões para economia, inventário, punições e eventos do sistema.Investigar problemas Interprete conexão, fila, descartes, persistência e falhas de credencial.
Princípios do SDK
- Server-side: a credencial nunca é enviada aos jogadores.
- Explícito: o Traki não captura chat, comandos, mortes ou economia automaticamente.
- Assíncrono: o retorno confirma a fila local, não uma gravação imediata na API.
- Resiliente: indisponibilidade temporária usa persistência e retentativas automáticas.
- Independente: o contrato não conhece nem exige um framework de roleplay.