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

281 instalações no skills.sh

Baixar SKILL.md Comunidade

Não quer gerenciar as skills por conta própria? Obtenha o app completo.

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.

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.

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.

Como instalar esta skill

Baixe o zip, descompacte e coloque a pasta onde a sua ferramenta carrega skills ou regras. O caminho exato depende da ferramenta:

Claude Code

Descompacte em .claude/skills/fivemanage/ dentro do projeto (a pasta precisa conter SKILL.md). Para todos os projetos, use ~/.claude/skills/fivemanage/.

Documentação de skills do Claude Code

Cursor

O Cursor carrega as regras do projeto de .cursor/rules/. Adicione ali um arquivo de regra apontando para a skill descompactada, ou cole o conteúdo do SKILL.md e dos arquivos de regras em uma regra. O formato é .mdc com frontmatter e muda entre versões, então confira a documentação da sua versão.

Documentação de regras do Cursor

VS Code / Copilot

O Copilot lê arquivos de instruções em .github/instructions/*.instructions.md. Copie o SKILL.md para lá com um glob applyTo para os seus arquivos Lua e mantenha os arquivos de regras ao lado.

Documentação de instruções do VS Code

O arquivo SKILL.md

Este é o arquivo que o seu assistente de IA lê. Ele aponta para os arquivos de regras incluídos no download.

Conteúdo da skill (inclui SKILL.md e quaisquer outros arquivos)

O conteúdo da skill está em inglês: é documentação técnica feita para agentes de IA.

Fivemanage SDK

Screenshots, image uploads and centralized logs for FiveM through exports.fmsdk.

Activation Contract

Load this skill when the user installs or configures the Fivemanage SDK, captures or uploads player screenshots, sends logs to the Fivemanage dashboard, or calls any exports.fmsdk function in Lua or JavaScript.

Hard Rules

  • The resource folder must be named fmsdk and sit directly in resources/; category folders are not supported.
  • screenshot-basic is required for takeImage / takeServerImage and must ensure BEFORE fmsdk in server.cfg.
  • API keys are ConVars in server.cfg (FIVEMANAGE_MEDIA_API_KEY, FIVEMANAGE_LOGS_API_KEY), never in config.json. Set only the keys for the features used.
  • takeImage is CLIENT-side; takeServerImage(playerSource, ...) and uploadImage(buffer, ...) are SERVER-side.
  • Log(dataset, level, message, metadata) is the primary log export; Info/Warn/Error(dataset, message, metadata) are fixed-level shorthands. LogMessage is legacy.
  • Include playerSource / targetSource in metadata so the SDK attaches player identifiers automatically.
  • Never expose API tokens to NUI; use presigned URLs for client-side uploads.

Decision Gates

Need Call
Screenshot from the player's own client exports.fmsdk:takeImage({ ... })
Screenshot of a player from the server exports.fmsdk:takeServerImage(playerSource, { ... })
Upload an existing image file/buffer exports.fmsdk:uploadImage(buffer, { ... })
Log with explicit level exports.fmsdk:Log(dataset, level, message, metadata)
Quick log exports.fmsdk:Info/Warn/Error(dataset, message, metadata)
Automatic player/chat/resource logs config.json inside fmsdk

Execution Steps

  1. Verify install order and ConVars (read rules/installation.md).
  2. Pick the side and export from Decision Gates.
  3. Attach metadata (name, description, playerSource) so entries are searchable.
  4. Choose a dataset per concern (economy, anticheat, admin_actions).
  5. Enable automatic events in config.json when useful (read rules/configuration.md).

Output Contract

Return the server.cfg lines when installing, then runnable Lua or JS using exports.fmsdk with the side explicit and metadata included.

References

  • rules/installation.md — download, folder placement, server.cfg order, API keys.
  • rules/images.md — takeImage, takeServerImage, uploadImage, metadata.
  • rules/logs.md — Log, Info/Warn/Error, LogMessage, datasets, identifiers.
  • rules/configuration.md — config.json, automatic events, presigned URLs.
  • rules/reference-links.md — official docs and SDK download.

Upstream docs: https://docs.fivemanage.com/fivem-sdk/installation

Perguntas frequentes

O Fivemanage é gratuito?
O Fivemanage oferece um plano gratuito e planos pagos para servidores maiores. Os limites mudam, então confira a página de preços em fivemanage.com antes de depender dele em produção.
Posso usar o Fivemanage para capturas em denúncias de jogadores?
Sim. Chame exports.fmsdk:takeImage no cliente ou takeServerImage no servidor, o SDK envia a imagem e retorna uma URL. Anexe essa URL à denúncia ou mande para o canal da staff.
Posso usar esta skill com o ChatGPT?
Sim, com um passo manual. O SKILL.md e a pasta rules são markdown puro, então você pode colá-los na conversa como contexto. O suporte nativo a skills é para Claude Code, Cursor e VS Code.

Guias relacionados

Leituras mais longas do blog da FiveAI sobre o mesmo tema.

Mais skills