Usa un chat personalizado en FiveM

La imagen oficial de FiveM trae su recurso chat empaquetado dentro del propio binario del servidor, en /opt/cfx-server/citizen/system_resources/chat. Esa ruta vive dentro de la imagen del contenedor, que es de solo lectura, y no en el volumen de datos donde están tus archivos. Eso significa que no puedes tocarla ni desde el gestor de archivos ni por SFTP. Quitar ensure chat del server.cfg tampoco soluciona el tema, porque FiveM carga los recursos de sistema por su cuenta, sin pedir permiso.

Para que puedas saltarte esa limitación, en Zaroz Cloud te dejamos dos opciones:

1. Desactivar el chat integrado, para que el recurso se borre al arrancar antes de que FiveM lo cargue.
2. Sustituir el chat integrado por tu propia carpeta, dejándola en una ruta concreta de los archivos de tu servidor.

Las dos opciones viven dentro de tu volumen de datos, así que aguantan reinicios y reconstrucciones del contenedor sin perderse.

Opción 1: desactivar el chat por defecto

En el asistente de configuración de FiveM, dentro de Recursos del sistema, verás un interruptor llamado Chat / Activar el chat predeterminado de FiveM. Desactívalo y confirma.

Cuando el interruptor está apagado, el contenedor borra /opt/cfx-server/citizen/system_resources/chat en cada arranque, antes de que FiveM llegue a cargarlo. Como cada arranque parte siempre de la imagen original, el cambio es seguro y se puede deshacer en cualquier momento.

Cuándo te conviene esta opción

Te conviene si quieres un servidor totalmente sin chat, o si tu chat personalizado ya lo tienes como un addon más dentro de resources/ y lo cargas desde server.cfg como cualquier otro recurso.

Puedes cambiar este ajuste cuando quieras desde la página de configuración del pedido. El cambio se aplica en el siguiente reinicio.

Opción 2: deja tu carpeta de chat dentro del servidor

Si lo que quieres es que tu chat ocupe exactamente el sitio del que viene de serie, con su mismo nombre, su mismo orden de carga y su misma prioridad como recurso de sistema, no hace falta que toques server.cfg. Como /opt/cfx-server/citizen/system_resources/chat no es accesible para ti, te hemos preparado una ruta dentro de tus archivos donde puedes colgar tu propia carpeta.

Desde el gestor de archivos del panel

1. Abre el Gestor de archivos de tu servidor desde el panel.
2. Entra en /.config/.
3. Crea ahí una carpeta llamada .zaroz (ojo al punto al principio).
4. Dentro de .zaroz, crea otra carpeta llamada chat.
5. Sube tu recurso de chat a /.config/.zaroz/chat/.

Por SFTP

Si te apañas mejor por SFTP, esa misma carpeta está en /server/config/.zaroz/chat/. Los datos de conexión los tienes en la pestaña Volumen de Datos de la página de tu servidor:

Copia directamente la URL de conexión en tu cliente SFTP, o usa los campos de host, puerto, usuario y contraseña que aparecen justo debajo. La URL completa apuntando a la carpeta de sustitución queda así:

sftp://zaroz@<host>:<puerto>/server/config/.zaroz/chat/

Cómo debe quedar

Da igual cómo subas los archivos, al final el recurso tiene que quedar así:

.zaroz/
└── chat/
    ├── fxmanifest.lua
    ├── client/
    ├── server/
    └── ...

En el siguiente arranque, el contenedor reemplaza /opt/cfx-server/citizen/system_resources/chat por un enlace simbólico que apunta a tu carpeta .zaroz/chat/. A partir de ahí, FiveM carga tu recurso como si fuera el de serie y no tienes que tocar server.cfg ni hacer nada más.

No le cambies el nombre

La carpeta dentro de .zaroz/ tiene que llamarse exactamente chat. Es el nombre que FiveM busca cuando ejecuta ensure chat desde server.cfg. Si la llamas de otra forma, la sustitución no se aplica y volverá a cargarse el chat original.

Volver al chat de serie

Para volver al original basta con borrar (o renombrar) la carpeta .zaroz/chat y reiniciar el servidor. El contenedor vuelve a usar el chat de FiveM como si no hubieras tocado nada.

Preguntas frecuentes

¿Puedo usar las dos opciones a la vez?

Sí, no hay problema. Si desactivas el chat por defecto y además dejas tu carpeta en .zaroz/chat/, gana lo tuyo: primero se borra el de serie y después se enlaza tu carpeta en su lugar.

¿Mi chat se pierde si cambio de plan o se reconstruye el contenedor?

No. Todo lo que está dentro de los archivos del servidor (incluida .zaroz/) vive en un volumen persistente. Cambiar la CPU o la RAM, o reconstruir el contenedor, no borra nada.

¿Vale la misma carpeta .zaroz/ para otros recursos del sistema?

De momento .zaroz/chat es la única carpeta especial que reconocemos. Si te gustaría hacer lo mismo con otros recursos integrados, cuéntanoslo por Discord.