Keymaster FiveM: qué es y cómo activar tus scripts

Si alguna vez has comprado un script protegido para tu servidor de FiveM y te has preguntado dónde está, por qué no arranca o cómo se activa, la respuesta casi siempre pasa por el mismo sitio: el Keymaster de cfx.re. Este panel gestiona las licencias de tu servidor y los permisos de los assets que compras, y entenderlo bien te ahorra la mayoría de los problemas típicos al montar una comunidad de roleplay. En esta guía te explicamos qué es exactamente, cómo registrar tu servidor, cómo se activan los scripts comprados y qué hacer cuando algo falla.

Qué es el Keymaster de cfx.re y para qué sirve

El Keymaster es el portal oficial de Cfx.re, disponible en portal.cfx.re, donde se administra todo lo relacionado con la identidad legal y técnica de tu servidor de FiveM. Antes vivía en un dominio propio (keymaster.fivem.net), pero hoy está integrado en el portal general de Cfx.re junto con el resto de herramientas para propietarios de servidores.

En la práctica, el Keymaster cumple dos funciones que te afectan directamente como dueño de un servidor.

Licencias de servidor

Todo servidor de FiveM necesita una clave de licencia para arrancar y aparecer en la lista pública. Esa clave se genera gratis desde el portal, queda vinculada a tu cuenta de Cfx.re y solo puede estar activa en un servidor a la vez. Es lo que escribes en la variable sv_licenseKey de tu server.cfg, y es también lo que identifica a tu servidor ante los servicios de Cfx.re cada vez que arranca.

Asset grants

Un asset grant es el permiso de uso sobre un recurso protegido. Cuando compras un script cifrado con el escrow oficial de FiveM, el creador no te envía el código fuente: te concede un grant asociado a tu cuenta de Cfx.re. Ese grant es lo que autoriza a tus servidores a descargar, descifrar y ejecutar el recurso. Puedes ver todos tus grants en la sección de assets del portal, con su fecha de concesión y el creador que los emitió.

La combinación de ambas cosas es lo que hace funcionar el sistema: tu servidor se identifica con su licencia, el Keymaster comprueba qué grants tiene la cuenta propietaria de esa licencia, y solo entonces permite ejecutar los recursos protegidos.

Cómo crear tu cuenta y registrar tu servidor

Si estás empezando desde cero, el proceso completo te llevará unos minutos:

1. Crea una cuenta en el foro de Cfx.re (forum.cfx.re) si aún no la tienes. Es la misma cuenta que usarás para todo el ecosistema.
2. Entra en portal.cfx.re e inicia sesión con esa cuenta.
3. Ve a la sección de servidores y genera una nueva clave de licencia. El portal te pedirá algunos datos básicos sobre el tipo de servidor.
4. Copia la clave resultante (las actuales empiezan por cfxk_) y pégala en tu server.cfg.

El resultado en tu configuración debería verse así:

sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"
sv_hostname "Mi Servidor Roleplay"
sv_maxclients 48

Si usas txAdmin, ni siquiera necesitas editar el archivo a mano: el asistente de configuración inicial te pedirá la clave y la colocará por ti. Si todavía no tienes el servidor montado, te recomendamos empezar por nuestra guía completa para crear un servidor de FiveM, donde cubrimos este paso dentro del proceso completo.

Un detalle importante: trata tu sv_licenseKey como una contraseña. Si compartes tu server.cfg en Discord o en un foro para pedir ayuda, borra la clave antes. Cualquiera que la tenga puede levantar un servidor haciéndose pasar por el tuyo, y tendrías que regenerarla desde el portal.

Cómo funcionan los asset grants al comprar un script protegido

Aquí es donde el Keymaster se cruza con tus compras. El flujo típico en una tienda seria que vende a través de Tebex es este:

1. Añades el script al carrito y vas al checkout de Tebex.
2. Durante el pago, vinculas o confirmas tu cuenta de Cfx.re. Este paso es crítico: el grant se asignará a esa cuenta exactamente.
3. Completas el pago y recibes el correo de confirmación con tu ID de transacción.
4. En cuestión de minutos, el grant aparece en tu Keymaster y puedes descargar el paquete del recurso.
5. Colocas la carpeta en tus resources, añades el ensure correspondiente y reinicias el servidor.

Cuando el servidor arranca, se autentica con tu sv_licenseKey, el Keymaster verifica que la cuenta propietaria tiene el grant del asset, y el runtime descifra y ejecuta el recurso protegido (el archivo .fxap que ves dentro de la carpeta es parte de ese mecanismo de cifrado). Todo esto ocurre de forma automática: no hay códigos de activación manuales ni pasos extra.

En Cube Resources este proceso está pensado para que sea inmediato: la entrega es instantánea tras el pago verificado por Tebex, y si algo no cuadra tienes soporte 24/7 por Discord y tickets para revisarlo con tu ID de transacción en la mano. Si es tu primera compra, nuestra guía sobre cómo instalar un script de FiveM te lleva paso a paso desde la descarga hasta el ensure.

Cómo transferir assets entre cuentas y servidores

Hay dos escenarios distintos que la gente suele mezclar, y conviene separarlos.

Entre servidores de la misma cuenta no hay que transferir nada. Los grants pertenecen a la cuenta, no a una licencia concreta. Si generas una segunda clave de licencia con la misma cuenta de Cfx.re, ese segundo servidor podrá cargar los mismos assets sin tocar nada. Recuerda igualmente revisar los términos del creador, porque el permiso técnico no siempre coincide con el permiso legal de la licencia de uso.

Entre cuentas distintas sí existe una transferencia formal. El portal de Cfx.re permite transferir un asset grant de una cuenta a otra, algo útil si compraste con la cuenta equivocada o si traspasas la comunidad a otro propietario. Ten en cuenta que estas transferencias suelen tener periodos de espera para evitar abusos, y que algunos creadores limitan cuántas veces puede moverse un grant. Si tienes dudas con un script comprado en nuestra tienda, abre un ticket y lo revisamos contigo.

El consejo práctico que evita todo esto: usa siempre la misma cuenta de Cfx.re para todas tus compras y para generar las licencias de tus servidores. Una sola cuenta, cero problemas de grants repartidos.

Errores comunes y cómo resolverlos

Estos son los tres fallos que más tickets generan, con su diagnóstico y solución.

El script aparece como no autorizado

El servidor arranca pero el recurso protegido falla al iniciar con un error de verificación o autorización. Las causas habituales, por orden de probabilidad:

• El grant está en otra cuenta de Cfx.re distinta a la dueña de tu sv_licenseKey. Compruébalo en portal.cfx.re con la sesión correcta.
• La compra no llegó a completarse o está pendiente de procesar. Revisa el correo de confirmación de Tebex.
• Estás usando una versión del recurso descargada de otro sitio (por ejemplo, un leak) que no corresponde a tu grant. Descarga siempre el paquete oficial de tu compra.
• La caché del servidor guarda una versión antigua tras una actualización. Borra la carpeta cache del servidor y reinicia.

Could not authenticate server license key

Este error impide que el servidor arranque y casi siempre tiene una de estas causas:

• La clave está mal copiada en server.cfg: comillas de más, espacios invisibles o una clave truncada. Vuelve a copiarla desde el portal.
• La clave ya está en uso en otra instancia activa. Cada licencia solo admite un servidor encendido a la vez; si tienes un entorno de pruebas, genera una segunda clave.
• La clave fue regenerada desde el portal y la copia de tu server.cfg quedó obsoleta.
• Hay una incidencia temporal en los servicios de Cfx.re. Ocurre poco, pero si todo lo demás está bien, espera unos minutos y reintenta.

El grant está en otra cuenta

El clásico: compraste con una cuenta de Cfx.re en el checkout de Tebex y tu servidor usa una licencia generada con otra. Tienes dos salidas: iniciar la transferencia del grant desde el portal hacia la cuenta correcta, o contactar con el soporte de la tienda para que reasigne la entrega. En ambos casos, el correo de compra y el ID de transacción de Tebex son tu prueba de propiedad, así que guárdalos siempre.

Buenas prácticas con tu Keymaster

Unas cuantas costumbres que te evitarán disgustos a largo plazo:

• Centraliza todo en una sola cuenta de Cfx.re: compras, licencias y administración del portal.
• Protege esa cuenta con una contraseña fuerte y no compartas la sesión con nadie que no sea copropietario real del proyecto.
• Nunca publiques tu sv_licenseKey. Si sospechas que se filtró, regenérala de inmediato desde el portal y actualiza tu server.cfg.
• Guarda los correos de confirmación de Tebex organizados. Ante cualquier disputa o transferencia, son tu recibo.
• Tras cada actualización de un script protegido, borra la caché del servidor antes de reportar un fallo: resuelve una parte sorprendente de los problemas.
• Compra solo en tiendas que entreguen mediante Tebex y escrow oficial. Es la única vía en la que el grant queda registrado a tu nombre ante Cfx.re, con actualizaciones gratuitas de por vida y soporte real detrás.

Con el Keymaster dominado, activar un script pasa de ser un misterio a un trámite de dos minutos. Si estás ampliando tu servidor, echa un vistazo a nuestro catálogo completo de scripts, probados en producción en nuestro propio servidor de roleplay y compatibles con QBCore, ESX, Qbox y standalone.