Usar um chat personalizado no FiveM

A imagem oficial do FiveM traz o recurso chat embutido no caminho do binário do servidor (/opt/cfx-server/citizen/system_resources/chat). Essa pasta faz parte da imagem só de leitura, e não do volume de dados do teu servidor, por isso não consegues editá-la a partir do gestor de ficheiros nem por SFTP, e remover ensure chat do server.cfg também não chega: o FiveM carrega os recursos de sistema automaticamente.

Para te dar controlo, a Zaroz Cloud disponibiliza duas opções:

1. Desativar o chat integrado, para que o recurso embutido seja removido no arranque, antes de o FiveM o carregar.
2. Substituir o chat integrado pela tua própria pasta, colocando-a num local especial dentro dos ficheiros do teu servidor.

Ambas as opções vivem dentro do volume de dados do teu servidor, por isso sobrevivem a reinícios e reconstruções do contentor.

Opção 1: desativar o chat por defeito

O assistente de configuração do FiveM mostra um interruptor chamado Chat / Ativar o chat predefinido do FiveM na secção Recursos do sistema. Desliga-o e confirma.

Quando a opção está desativada, o contentor apaga /opt/cfx-server/citizen/system_resources/chat em cada arranque, antes de o FiveM ter hipótese de o carregar. Como a imagem é reconstruída do zero em cada arranque, isto é seguro e reversível.

Quando usar esta opção

Escolhe esta opção se quiseres um servidor totalmente sem chat, ou se distribuíres o teu próprio recurso de chat como um addon normal em resources/ e o arrancares pelo server.cfg como qualquer outro recurso.

Podes mudar esta definição a qualquer momento na página de configuração da tua encomenda. A alteração aplica-se no próximo reinício do servidor.

Opção 2: largar a tua própria pasta de chat

Se quiseres que o teu chat personalizado ocupe o lugar do que vem por defeito (mesmo nome, mesma ordem de carregamento, mesma prioridade enquanto recurso de sistema), podes colocá-lo numa pasta especial que verificamos no arranque. Como não consegues aceder diretamente a /opt/cfx-server/citizen/system_resources/chat, expomos em alternativa um ponto de montagem editável dentro dos ficheiros do teu servidor.

A partir do gestor de ficheiros do painel

1. Abre o Gestor de ficheiros do teu servidor a partir do painel.
2. Entra em /.config/.
3. Lá dentro, cria uma pasta chamada .zaroz (atenção ao ponto inicial).
4. Dentro de .zaroz, cria uma pasta chamada chat.
5. Envia o teu recurso de chat personalizado para /.config/.zaroz/chat/.

Por SFTP

Se preferires trabalhar por SFTP, a mesma pasta encontra-se em /server/config/.zaroz/chat/ no teu servidor. Os dados de ligação estão no separador Volume de Dados da página do teu servidor:

Copia diretamente o Connection URL para o teu cliente de SFTP, ou usa os campos de anfitrião, porta, utilizador e palavra-passe que aparecem logo abaixo. Um URL completo a apontar para a pasta de substituição fica assim:

sftp://zaroz@<anfitrião>:<porta>/server/config/.zaroz/chat/

Estrutura final

Independentemente de como a envies, a pasta tem de acabar assim:

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

No próximo arranque, o contentor substitui /opt/cfx-server/citizen/system_resources/chat por um link simbólico que aponta para a tua pasta .zaroz/chat/. O FiveM passa então a carregar o teu recurso como se fosse o recurso de sistema original, sem precisares de mexer no server.cfg.

Mantém o nome do recurso como chat

A pasta dentro de .zaroz/ tem de chamar-se exatamente chat. É o nome de recurso que o FiveM espera quando ensure chat é chamado no server.cfg. Se a renomeares, a substituição não terá efeito.

Voltar ao chat por defeito

Para repor o recurso original, basta apagar (ou renomear) a pasta .zaroz/chat e reiniciar o servidor. O contentor volta a usar o chat integrado.

Perguntas frequentes

Posso usar as duas opções ao mesmo tempo?

Sim. Se desativares o chat por defeito e também fornecer .zaroz/chat/, ganha o teu recurso personalizado: primeiro é removido o por defeito e depois a tua pasta é ligada.

O meu chat personalizado sobrevive a uma mudança de plano ou a uma reconstrução?

Sim. Tudo o que está dentro dos ficheiros do teu servidor (incluindo .zaroz/) vive num volume persistente. Alterar CPU ou RAM, ou reconstruir o contentor, não apaga nada.

A mesma pasta .zaroz/ funciona para outros recursos?

Por agora, .zaroz/chat é o único slot de substituição. Se quiseres sobrepor outros recursos integrados da mesma forma, diz-nos no Discord.