Fivemanage para FiveM: capturas, logs, erros comuns e a skill de IA

Fivemanage é um serviço hospedado para servidores de FiveM que guarda imagens e logs e mostra tudo em um dashboard. Você instala o SDK como um recurso chamado fmsdk, e os seus outros recursos chamam os exports dele para tirar capturas, enviar imagens e mandar logs estruturados. Se você administra um servidor e quer provas anexadas às denúncias, ou quer parar de vasculhar o console do txAdmin para saber o que um jogador fez, esta é a ferramenta. A skill do Fivemanage dá ao seu assistente de IA os nomes reais dos exports e a ordem de instalação.

Referência rápida

O export se escreve Log com L maiúsculo. Adicione playerSource à metadata para a staff filtrar por jogador.

Export	Lado	O que faz
exports.fmsdk:Log(datasetId, level, message, metadata)	Servidor	Envia um log para um dataset; metadata é opcional
exports.fmsdk:Info(datasetId, message, metadata)	Servidor	O mesmo, com o nível fixo em info
exports.fmsdk:Warn(datasetId, message, metadata)	Servidor	O mesmo, com o nível fixo em warn
exports.fmsdk:Error(datasetId, message, metadata)	Servidor	O mesmo, com o nível fixo em error
exports.fmsdk:takeImage	Cliente	Tira uma captura e envia
exports.fmsdk:takeServerImage	Servidor	Tira uma captura de um jogador a partir do servidor

Ordem no server.cfg: ensure screenshot-basic (só para imagens), depois ensure fmsdk e então seus resources. Defina FIVEMANAGE_LOGS_API_KEY e FIVEMANAGE_MEDIA_API_KEY com set, só para os recursos que você usa.

O que a skill do Fivemanage te dá

O SKILL.md aponta para a documentação oficial em docs.fivemanage.com e divide os temas em arquivos de regras.

• rules/installation.md. Pré-requisitos, download, extração em resources, a ordem de ensure no server.cfg e onde ficam as API keys.
• rules/images.md. exports.fmsdk:takeImage no cliente, takeServerImage e uploadImage no servidor, e os metadados que você anexa: name, description e playerSource.
• rules/logs.md. Log, os helpers Info, Warn e Error, LogMessage, datasets, playerSource e targetSource, e o registro automático de eventos.
• rules/configuration.md. config.json, eventos automáticos, URLs pré-assinadas e um lembrete sobre as API keys.
• rules/reference-links.md. Documentação oficial e links de download do SDK.

Recursos em Lua e em JavaScript podem chamar os exports.

Erros comuns com o Fivemanage

• Commitar a API key ou expô-la ao cliente. A key vai parar em um repositório público ou em um script de cliente que qualquer um consegue extrair. Sintoma: desconhecidos enviam arquivos para a sua conta ou leem os seus logs. Correção: mantenha as keys só no server.cfg ou em configuração de servidor, e nunca as envie ao cliente.
• Não dar ensure fmsdk antes dos recursos que o usam. O seu script chama exports.fmsdk:takeImage e recebe "attempt to index a nil value". Correção: coloque ensure fmsdk no server.cfg acima de cada recurso que depende dele.
• Chamar funções de servidor no cliente, ou o contrário. takeServerImage e uploadImage são exports de servidor, takeImage é de cliente. Sintoma: export nil ou um erro sem envio. Correção: siga rules/images.md e coloque cada chamada no lado certo.
• Registrar logs sem playerSource. O evento chega ao dashboard sem jogador associado, então a staff não consegue filtrar por quem fez. Correção: passe playerSource (e targetSource quando outro jogador está envolvido) nos metadados do log.
• Enviar logs a cada tick. Uma chamada a Log dentro de um loop de Citizen.CreateThread inunda o dataset e queima os limites do seu plano. Correção: registre eventos reais (compra, ban, morte, denúncia) e use Info, Warn e Error para que os níveis signifiquem algo.

Por que assistentes de IA erram com o Fivemanage

O Fivemanage é mais novo que a maior parte do código de FiveM com que um assistente aprendeu. Peça a um modelo genérico "captura ao denunciar" e ele inventa um export como exports.fivemanage:screenshot, confunde o nome do recurso ou escreve uma chamada de webhook. Ele também tende a colocar a API key em uma tabela Config de cliente porque era ali que os scripts antigos guardavam as configurações. Nada disso aparece até o recurso subir e o export ser nil.

A skill do Fivemanage corrige os nomes e as camadas. O assistente lê rules/installation.md para a ordem de ensure e o lugar das keys, rules/images.md para saber qual export roda em cada lado, e rules/logs.md para os metadados que tornam um log útil no dashboard. O código que ele escreve usa exports do fmsdk que existem, no lado da rede onde existem.

Para ver como uma skill se compara a outras configurações de IA para FiveM, leia nosso comparativo.

Instale a skill do Fivemanage em 30 segundos

1. Clique em "Download SKILL.md" no topo desta página.
2. Descompacte na pasta de skills ou rules da sua ferramenta de IA. A seção de instalação abaixo mostra o caminho exato para Claude Code, Cursor e VS Code.
3. Peça ao assistente algo concreto, como "tire uma captura pelo servidor quando um jogador for banido e registre com o admin como playerSource", e confira que ele usa takeServerImage no servidor e mantém a API key fora do código de cliente.