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

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.

Referencia rápida

El export se escribe Log con L mayúscula. Añade playerSource a la metadata para que el staff pueda filtrar por jugador.

Export	Lado	Qué hace
exports.fmsdk:Log(datasetId, level, message, metadata)	Servidor	Envía un log a un dataset; metadata es opcional
exports.fmsdk:Info(datasetId, message, metadata)	Servidor	Lo mismo, con el nivel fijo en info
exports.fmsdk:Warn(datasetId, message, metadata)	Servidor	Lo mismo, con el nivel fijo en warn
exports.fmsdk:Error(datasetId, message, metadata)	Servidor	Lo mismo, con el nivel fijo en error
exports.fmsdk:takeImage	Cliente	Toma una captura y la sube
exports.fmsdk:takeServerImage	Servidor	Toma una captura de un jugador desde el servidor

Orden en server.cfg: ensure screenshot-basic (solo para imágenes), luego ensure fmsdk y después tus recursos. Define FIVEMANAGE_LOGS_API_KEY y FIVEMANAGE_MEDIA_API_KEY con set, solo para las funciones que uses.

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.

Para ver cómo se compara una skill con otras configuraciones de IA para FiveM, lee nuestra comparativa.

Instala la skill de Fivemanage en 30 segundos

1. Haz clic en "Download SKILL.md" en la parte superior de esta página.
2. 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.
3. 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.