Cómo usar Azuriom en lugar de una web de Tebex para FiveM

Puedes usar Azuriom para crear la web de tu comunidad de FiveM y convertirla en el destino que visitan los jugadores en lugar de una tienda de Tebex independiente. Úsalo para tu página de inicio, las normas y la información de la comunidad; conecta tu servidor de juego mediante AzLink. Para los paquetes de pago del servidor, mantén Tebex en el flujo de pago: la documentación actual de Cfx.re identifica a Tebex como el proveedor exclusivo de monetización y prohíbe otras plataformas de pago para este fin. Lee los requisitos de monetización de Cfx.re antes de configurar ventas.

Este tutorial cubre la instalación de la web, el recurso oficial AzLink-FiveM y una lista de comprobación práctica para el lanzamiento. Se basa en la revisión de la documentación y del código el 9 de noviembre de 2026; no afirma que se haya hecho una prueba completa con FXServer ni con pagos. Azuriom incluye FiveM entre los juegos compatibles en su documentación. El código del bridge revisado aquí es el commit d2c76cbdf4f7561bf7943aed8524bbce67a9ebc2 del repositorio oficial; su última versión publicada en el momento de la revisión es v0.1.1.

Decide qué quieres que sustituya Azuriom

Una web de comunidad y un servicio de pago resuelven problemas distintos. Un punto de partida útil es un sitio de Azuriom alojado por ti con un enlace visible de «Tienda» en la navegación que lleva a tu tienda de Tebex actual. Así la edición de la web queda separada del pago y la entrega de los paquetes. Puedes lanzar la web antes de intentar una integración de comercio más profunda.

AzLink es una conexión independiente entre Azuriom y FXServer. Intercambia información del servidor y puede ejecutar los comandos que devuelve la web. Instalarlo no conecta automáticamente tus compras de Tebex, no importa suscripciones ni transfiere los datos de los clientes. El repositorio oficial de AzLink-FiveM documenta el recurso; nuestra comparación entre Azuriom y Tebex trata las diferencias más amplias de software y comercio.

Deja fuera de esta configuración de monetización de servidores de FiveM el pago directo con Stripe o PayPal. Que exista un plugin de pago no demuestra que tengas permiso para usar esa vía de pago en tu servidor.

1. Prepara el hosting y conserva la configuración que funciona

Necesitas una cuenta de alojamiento web o un VPS para Azuriom, un dominio con HTTPS, acceso a la base de datos y permiso para gestionar los recursos de tu FXServer y la consola del servidor. Azuriom es una aplicación PHP; colocar sus archivos en una carpeta de recursos de FiveM no creará una web.

En la fecha de la revisión, los requisitos oficiales de instalación especifican PHP 8.2 o superior, las extensiones de PHP indicadas y soporte para enlaces simbólicos. Se recomienda MySQL/MariaDB o PostgreSQL. Pide al proveedor de hosting que compruebe los requisitos completos en lugar de fiarte de un plan descrito solo como «hosting PHP».

Antes de cambiar nada, guarda una copia de server.cfg, de cualquier carpeta de AzLink existente y de la configuración actual de la web. Si sustituyes un CMS existente, haz una copia de seguridad de sus archivos y de su base de datos. Empieza en un nombre de host aparte para que la web y la tienda actuales sigan disponibles durante las pruebas de aceptación. Anota cómo restaurar el DNS y la configuración anterior del servidor web.

Punto de control: el nombre de host previsto carga por HTTPS y puedes acceder al panel de hosting, a la base de datos y a la consola de FXServer. Mantén las contraseñas de la base de datos y las claves del bridge fuera de las capturas de pantalla y de los mensajes públicos de soporte.

2. Instala la web de Azuriom

Descarga el paquete de instalación desde la web oficial de Azuriom. Súbelo y extráelo en la ubicación de la web que configure tu proveedor de hosting, incluidos los archivos ocultos. Sigue las instrucciones originales para el servidor web; en Nginx, la raíz de documentos documentada de la aplicación termina en /public.

Abre el sitio en un navegador, completa el instalador, indica la conexión a la base de datos y crea el primer administrador. Selecciona la opción de identidad de FiveM adecuada para tu comunidad. El bridge distingue entre identidades basadas en Steam y basadas en Cfx, así que mantén la elección de la web coherente con las cuentas de tus jugadores. No des por hecho que el nombre visible de Discord es el identificador del juego.

Consulta la guía de instalación para las tareas programadas cuando las funciones activadas las requieran. Mantén desactivada la salida de depuración en producción, restringe el acceso a los archivos según el modelo de despliegue de tu proveedor y comprueba que no se puedan descargar los archivos de configuración privados.

Punto de control: inicia sesión como administrador, guarda un pequeño cambio de contenido y míralo después sin sesión iniciada. Comprueba que una cuenta normal no puede abrir las páginas de administración. Que la página de inicio cargue bien es solo la primera de esas comprobaciones.

3. Haz útil la web antes de conectar el comercio

Crea las páginas que necesitan los jugadores: presentación del servidor, instrucciones para entrar, normas y un contacto de soporte claro. Pon la tienda en la navegación principal y usa la URL de tu tienda de Tebex actual como destino. Prueba ese enlace desde un navegador sin sesión iniciada y desde un móvil.

Usa un tema que haga fáciles de encontrar esas tareas. Instala extensiones solo para las funciones que vayas a mantener y anota sus versiones para poder probar las actualizaciones futuras con la misma configuración. Para una lista de planificación más amplia, consulta nuestra guía para crear una web para un servidor de FiveM.

Punto de control: un visitante nuevo encuentra las instrucciones para entrar al servidor, las normas, el soporte y la tienda sin usar una sesión de administrador.

4. Instala el recurso oficial AzLink-FiveM

Descarga el recurso desde la página de Releases del repositorio. Extráelo de modo que la raíz del recurso se llame azlink y contenga directamente fxmanifest.lua y su directorio server. Evita una carpeta extra anidada del archivo comprimido.

resources/
└── azlink/
    ├── fxmanifest.lua
    └── server/

Para el primer arranque, el README original usa estas instrucciones de la consola del servidor. Ejecuta primero refresh si añadiste la carpeta con FXServer ya en marcha:

refresh
start azlink

Para que arranque tras reiniciar el servidor, añade el recurso a server.cfg:

ensure azlink

El manifest del bridge declara un recurso solo de servidor; estas instrucciones no instalan ninguna integración de juego con ESX, QBCore o Qbox. Los comandos que afectan a personajes o inventarios necesitan su propia implementación y pruebas específicas para tu framework. Esta revisión del código no establece una aceptación en ejecución por separado para GTAV Legacy y Enhanced.

Punto de control: FXServer indica que el recurso arrancó sin un error de manifest ausente ni de script. Eso demuestra el arranque, no una conexión que funcione con la web.

5. Enlaza FXServer con la web

En el área de administración de Azuriom, añade tu servidor de juego en Servers. Usa los valores de configuración que se muestran para ese servidor. La implementación del comando revisada acepta la URL base de la web seguida de la clave del sitio:

azlink setup https://community.example.com YOUR_SERVER_SITE_KEY
azlink status
azlink fetch

https://community.example.com y YOUR_SERVER_SITE_KEY son marcadores de posición. Ejecuta la configuración real en la consola del servidor, con los valores de tu propio panel. El recurso añade /api/azlink a la URL base por sí mismo; no lo añadas tú otra vez. Mantén la clave en privado.

Si la configuración se completa, el recurso guarda sus ajustes de conexión en config.json dentro del directorio del recurso. Conserva ese archivo cuando actualices el recurso. Trata su copia de seguridad como información sensible, porque contiene la credencial del bridge. Vuelve a comprobar el resultado tras reiniciar el recurso, para que una conexión temporal en memoria no oculte un fallo al guardar la configuración.

Punto de control: el estado confirma la conectividad, fetch se completa y la web refleja el servidor conectado. Entra con una cuenta de prueba y compara la información del jugador con FXServer. Verifica el modo de identidad seleccionado antes de intentar acciones específicas de un jugador.

6. Mantén los paquetes de pago en la vía de Tebex

Para el lanzamiento más sencillo, conserva el enlace de navegación a tu tienda de Tebex. Configura la entrega de los paquetes de pago mediante la conexión actual de Tebex y no dupliques esas acciones en AzLink. Si todavía necesitas esa conexión, nuestro tutorial para configurar una tienda de Tebex en FiveM explica la parte de la tienda.

Si más adelante quieres explorar los paquetes dentro de Azuriom, el marketplace incluye una extensión Tebex Integration de Bricec6 de terceros. Su listado describe una integración con la Tebex Headless API. Revisa su compatibilidad actual, sus dependencias y su mantenimiento antes de adoptarla. Este artículo no ha probado esa extensión, así que la configuración básica anterior no depende de ella.

Antes de poner en marcha un nuevo flujo de compra, verifica la identificación de la cuenta, el destino real del pago, la entrega de los paquetes y la vía de soporte. Mantén el historial de compras y las suscripciones activas en el sistema que funciona hasta que exista una migración probada por separado. Un rediseño de la web no es prueba de que esos registros ni los acuerdos de renovación se hayan trasladado.

Solución de problemas de AzLink

No se encuentra el recurso

Comprueba el nombre de la carpeta y su anidación. El manifest debe estar en resources/azlink/fxmanifest.lua. Actualiza la lista de recursos tras añadir los archivos y revisa el primer error de la consola del servidor.

El recurso arranca, pero la web está desconectada

Comprueba la URL base HTTPS configurada y que la clave del servidor coincida. El cliente HTTP llama al endpoint /api/azlink de la web. Revisa los registros de acceso y de errores de la web para esa ruta. Los fallos de DNS, los problemas de TLS, las redirecciones a otro nombre de host, las puertas de autenticación o los desafíos del navegador pueden impedir que FXServer reciba la respuesta de API esperada.

Corrige el acceso a la ruta de API prevista sin desactivar la protección de toda la web. Cuando pidas ayuda, indica el estado HTTP, la marca de tiempo y la versión del recurso; oculta las credenciales y los identificadores de jugadores.

El estado funciona, pero el jugador o la acción son incorrectos

Comprueba la coincidencia de identidad entre Steam y Cfx, la conexión actual del jugador y los requisitos del comando de destino. El bridge sustituye la información del jugador en los comandos y los ejecuta a través de la consola del servidor. Una petición HTTP correcta no puede demostrar que el comando haya producido el cambio de juego previsto.

Usa primero una acción inofensiva con una cuenta de prueba. Prueba por separado el comportamiento con jugadores desconectados antes de depender de una acción que espera un ID de servidor en línea. Por eso la administración de la web y las credenciales del bridge merecen el mismo cuidado que cualquier otra vía capaz de lanzar comandos en el servidor.

Comprobaciones de lanzamiento y de vuelta atrás

Lanza cuando hayas comprobado la web sin sesión iniciada, los permisos de los usuarios normales, la navegación móvil, la conexión persistente del bridge y la vía de compra prevista de Tebex. Guarda un registro de las versiones del CMS, de las extensiones y del recurso, de la fecha y de lo que realmente probaste.

Si la conexión con la web da problemas, devuelve a los visitantes a la web anterior, restaura su configuración y su base de datos cuando haga falta y detén AzLink mientras investigas. Restaura la configuración guardada del recurso solo cuando siga coincidiendo con la web y el registro de servidor previstos. Mantén disponible el sistema de comercio actual durante todo el cambio.

Azuriom te da control sobre la web que usan tus jugadores. Para un servidor de FiveM, esta guía mantiene a Tebex como responsable del flujo de monetización mientras AzLink se encarga de la conexión entre la web y el servidor.