Fivemanage para FiveM: capturas, logs, errores comunes y la skill de IA

¿No quieres gestionar las skills tú mismo? Consigue la app completa.

Fivemanage es un servicio alojado para servidores de FiveM que guarda imágenes y logs y los muestra en un dashboard. Instalas su SDK como un recurso llamado fmsdk, y el resto de tus recursos llaman a sus exports para tomar capturas, subir imágenes y enviar logs estructurados. Si administras un servidor y quieres pruebas adjuntas a los reportes, o quieres dejar de buscar en la consola de txAdmin qué hizo un jugador, esta es la herramienta. La skill de Fivemanage le da a tu asistente de IA los nombres reales de los exports y el orden de instalación.

Qué te da la skill de Fivemanage

El SKILL.md enlaza a la documentación oficial en docs.fivemanage.com y reparte los temas en archivos de reglas.

rules/installation.md. Requisitos, descarga, extracción en resources, el orden de ensure en server.cfg y dónde van las API keys.
rules/images.md. exports.fmsdk:takeImage en el cliente, takeServerImage y uploadImage en el servidor, y los metadatos que adjuntas: name, description y playerSource.
rules/logs.md. Log, los helpers Info, Warn y Error, LogMessage, datasets, playerSource y targetSource, y el registro automático de eventos.
rules/configuration.md. config.json, eventos automáticos, URLs prefirmadas y un recordatorio sobre las API keys.
rules/reference-links.md. Documentación oficial y enlaces de descarga del SDK.

Los recursos en Lua y en JavaScript pueden llamar a los exports.

Errores comunes con Fivemanage

Subir la API key al repositorio o exponerla al cliente. La key termina en un repositorio público o en un script de cliente que cualquiera puede volcar. Síntoma: desconocidos suben archivos a tu cuenta o leen tus logs. Solución: guarda las keys solo en server.cfg o en configuración de servidor, y nunca las envíes al cliente.
No hacer ensure fmsdk antes de los recursos que lo usan. Tu script llama a exports.fmsdk:takeImage y recibe “attempt to index a nil value”. Solución: pon ensure fmsdk en server.cfg por encima de cada recurso que dependa de él.
Llamar funciones de servidor desde el cliente, o al revés. takeServerImage y uploadImage son exports de servidor, takeImage es de cliente. Síntoma: export nil o un error sin subida. Solución: sigue rules/images.md y pon cada llamada en el lado que le corresponde.
Registrar logs sin playerSource. El evento llega al dashboard sin jugador asociado, así que el staff no puede filtrar por quién lo hizo. Solución: pasa playerSource (y targetSource cuando hay otro jugador implicado) en los metadatos del log.
Enviar logs en cada tick. Una llamada a Log dentro de un bucle de Citizen.CreateThread inunda el dataset y quema los límites de tu plan. Solución: registra eventos reales (compra, ban, muerte, reporte) y usa Info, Warn y Error para que los niveles signifiquen algo.

Por qué los asistentes de IA fallan con Fivemanage

Fivemanage es más joven que la mayoría del código de FiveM del que aprendió un asistente. Pídele a un modelo genérico “captura al reportar” y se inventa un export como exports.fivemanage:screenshot, confunde el nombre del recurso o escribe una llamada a un webhook. También tiende a poner la API key en una tabla Config de cliente porque ahí guardaban los ajustes los scripts antiguos. Nada de esto se ve hasta que el recurso arranca y el export es nil.

La skill de Fivemanage corrige los nombres y las capas. El asistente lee rules/installation.md para el orden de ensure y la ubicación de las keys, rules/images.md para saber qué export corre en cada lado, y rules/logs.md para los metadatos que hacen útil un log en el dashboard. El código que escribe usa exports de fmsdk que existen, en el lado de la red donde existen.

Instala la skill de Fivemanage en 30 segundos

Haz clic en “Download SKILL.md” en la parte superior de esta página.
Descomprímelo en la carpeta de skills o rules de tu herramienta de IA. La sección de instalación de abajo muestra la ruta exacta para Claude Code, Cursor y VS Code.
Pídele al asistente algo concreto, como “toma una captura desde el servidor cuando se banea a un jugador y regístrala con el admin como playerSource”, y comprueba que usa takeServerImage en el servidor y mantiene la API key fuera del código de cliente.

Cómo instalar esta skill

Descarga el zip, descomprímelo y coloca la carpeta donde tu herramienta carga skills o reglas. La ruta exacta depende de la herramienta:

Claude Code

Descomprime en .claude/skills/fivemanage/ dentro del proyecto (la carpeta debe contener SKILL.md). Para todos los proyectos, usa ~/.claude/skills/fivemanage/.

Documentación de skills de Claude Code

Cursor

Cursor carga las reglas del proyecto desde .cursor/rules/. Añade ahí un archivo de regla que apunte a la skill descomprimida, o pega el contenido de SKILL.md y los archivos de reglas en una regla. El formato es .mdc con frontmatter y cambia entre versiones, así que revisa la documentación de tu versión.

Documentación de reglas de Cursor

VS Code / Copilot

Copilot lee archivos de instrucciones desde .github/instructions/*.instructions.md. Copia SKILL.md ahí con un glob applyTo para tus archivos Lua y deja los archivos de reglas al lado.

Documentación de instrucciones de VS Code

El archivo SKILL.md

Este es el archivo que lee tu asistente de IA. Enlaza a los archivos de reglas incluidos en la descarga.

Contenido de la skill (incluye SKILL.md y cualquier otro archivo)

El contenido de la skill está en inglés: es documentación técnica pensada 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

Verify install order and ConVars (read rules/installation.md).
Pick the side and export from Decision Gates.
Attach metadata (name, description, playerSource) so entries are searchable.
Choose a dataset per concern (economy, anticheat, admin_actions).
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

Preguntas frecuentes

¿Fivemanage es gratis?

Fivemanage ofrece un plan gratuito y planes de pago para servidores grandes. Los límites cambian, así que revisa la página de precios en fivemanage.com antes de depender de él en producción.

¿Puedo usar Fivemanage para capturas en reportes de jugadores?

Sí. Llama a exports.fmsdk:takeImage en el cliente o a takeServerImage en el servidor, el SDK sube la imagen y devuelve una URL. Adjunta esa URL al reporte o envíala a tu canal de staff.

¿Puedo usar esta skill con ChatGPT?

Sí, con un paso manual. El SKILL.md y su carpeta rules son markdown plano, así que puedes pegarlos en la conversación como contexto. El soporte nativo de skills es para Claude Code, Cursor y VS Code.

Lecturas más largas del blog de FiveAI sobre el mismo tema.