Sustituye un recurso integrado de FiveM

La imagen oficial de FiveM trae varios recursos de sistema empaquetados dentro del propio binario del servidor, en /opt/cfx-server/citizen/system_resources/. Esas carpetas viven 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 tocarlas ni desde el gestor de archivos ni por SFTP, y FiveM las carga por su cuenta en cada arranque.

En Zaroz Cloud puedes cambiar cualquiera de estos cuatro recursos de sistema por tu propia versión:

• chat — la caja de chat dentro del juego
• monitor — el panel de administración txAdmin
• webpack — empaqueta el JavaScript de los recursos durante la fase de compilación
• yarn — instala las dependencias de los recursos durante la fase de compilación

Para ello solo tienes que dejar una carpeta de sustitución en una ruta concreta de los archivos de tu servidor. Todo lo que pongas ahí vive dentro de tu volumen de datos, así que aguanta reinicios y reconstrucciones del contenedor sin perderse.

A la mayoría solo le hace falta chat

Sustituir chat es, con diferencia, el caso más habitual. monitor, webpack y yarn son para configuraciones avanzadas: déjalos en paz salvo que sepas exactamente que los necesitas.

Con el recurso chat además tienes la opción de desactivarlo del todo en lugar de sustituirlo. Lo tienes más abajo, en Desactivar el chat por defecto.

Sustituye un recurso con tu propia carpeta

Si lo que quieres es que tu versión de un recurso 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/ 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 una carpeta con el nombre del recurso que quieras sustituir: chat, monitor, webpack o yarn.
5. Sube tu recurso de sustitución dentro de ella, por ejemplo a /config/.zaroz/chat/.

Por SFTP

Si te apañas mejor por SFTP, esa misma carpeta está en /server/config/.zaroz/ en tu servidor. 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. Una URL completa apuntando a la carpeta de sustitución del recurso de chat, por ejemplo, queda así:

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

Cómo debe quedar

Cada sustitución va en su propia carpeta dentro de .zaroz/, con el nombre exacto del recurso. Puedes sustituir uno o varios recursos a la vez:

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

En el siguiente arranque, el contenedor reemplaza la carpeta correspondiente dentro de /opt/cfx-server/citizen/system_resources/ por un enlace simbólico que apunta a tu carpeta .zaroz/<recurso>/. 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.

El nombre de la carpeta tiene que coincidir con el del recurso

La carpeta dentro de .zaroz/ tiene que llamarse exactamente chat, monitor, webpack o yarn. Esos son los nombres que FiveM espera para sus recursos de sistema. Una carpeta con cualquier otro nombre se ignora.

Sustituir monitor sustituye txAdmin

El recurso monitor es el panel de administración txAdmin. Sustitúyelo solo si tu intención es distribuir un txAdmin modificado: una carpeta monitor vacía o rota te dejará sin panel de administración.

Volver al recurso de serie

Para restaurar un recurso original basta con borrar (o renombrar) su carpeta dentro de .zaroz/ y reiniciar el servidor. El contenedor vuelve a usar la versión integrada.

Desactivar el chat por defecto

El recurso chat tiene una opción extra que los demás no tienen: puedes quitarlo por completo en lugar de sustituirlo.

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.

Preguntas frecuentes

¿Qué recursos puedo sustituir?

Cuatro recursos de sistema: chat, monitor, webpack y yarn. Cada uno se sustituye de forma independiente con su propia carpeta dentro de .zaroz/.

¿Puedo sustituir varios recursos a la vez?

Sí. Añade una carpeta por recurso dentro de .zaroz/. Cada una se enlaza de forma independiente al arrancar, y los recursos para los que no pongas carpeta conservan su versión de serie.

¿Puedo desactivar el chat por defecto y poner el mío a la vez?

Sí. 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.

¿Mis sustituciones se pierden 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.