Guia

Instalação do resource.

Cada FXServer usa uma instalação e uma credencial próprias. Não reutilize tokens entre servidores ou ambientes.

Requisitos

FXServer com suporte ao manifest `cerulean`.
Acesso ao diretório de resources e ao `server.cfg`.
Uma instalação criada pelo Owner no painel do Traki.
Saída HTTPS do servidor para `api.traki.me`.

1. Instale os arquivos

Valide o checksum SHA-256 do pacote recebido e extraia a pasta como `resources/[local]/traki`. O pacote oficial contém somente `fxmanifest.lua`, `server.lua` e `README.md`.

2. Configure o servidor

Copie o trecho exibido uma única vez pelo painel. Use `set`, nunca `setr` ou `sets`, para a credencial. A permissão adicional impede que outros resources leiam o token por padrão.

server.cfg

set traki_api_url "https://api.traki.me"
set traki_integration_token "COLE_A_CREDENCIAL_DA_INSTALACAO"
add_convar_permission traki read traki_integration_token

ensure traki
ensure seu_resource_consumidor

3. Ajustes opcionais

server.cfg

# Opcionais: use os padrões enquanto não houver necessidade medida
set traki_heartbeat_interval "60"
set traki_queue_limit "1000"

ConVar	Padrão	Faixa
`traki_heartbeat_interval`	60 segundos	15–300 segundos
`traki_queue_limit`	1.000 eventos	10–10.000 eventos

4. Valide a conexão

Recarregue e inicie o resource pelo console do servidor:

console

refresh
ensure traki
traki:status

O resultado esperado contém connected=true e queue=0/1000. O comando `traki:status` só produz saída no console do servidor.

Atualizações

Pare primeiro os resources consumidores.
Pare o `traki` e substitua somente os arquivos do pacote.
Preserve `traki-queue-a.json` e `traki-queue-b.json`.
Inicie `traki` e depois os consumidores.
Confirme versão, heartbeat e fila no painel.