Substituir um recurso integrado do FiveM

A imagem oficial do FiveM traz vários recursos de sistema embutidos no caminho do binário do servidor (/opt/cfx-server/citizen/system_resources/). Essas pastas fazem parte da imagem só de leitura, e não do volume de dados do teu servidor, por isso não consegues editá-las a partir do gestor de ficheiros nem por SFTP, e o FiveM carrega-as automaticamente em cada arranque.

A Zaroz Cloud deixa-te trocar qualquer um destes quatro recursos de sistema pela tua própria versão:

• chat — a caixa de chat dentro do jogo
• monitor — o painel de administração txAdmin
• webpack — empacota o JavaScript dos recursos durante a fase de compilação
• yarn — instala as dependências dos recursos durante a fase de compilação

Para isso, colocas uma pasta de substituição num local especial dentro dos ficheiros do teu servidor. Tudo o que puseres ali vive dentro do volume de dados do teu servidor, por isso sobrevive a reinícios e reconstruções do contentor.

A maioria só precisa de chat

Substituir chat é, de longe, o caso mais comum. monitor, webpack e yarn são para configurações avançadas — deixa-os em paz a menos que saibas exatamente que precisas deles.

Para o recurso chat existe também a opção de o desativar por completo em vez de o substituir. Vê mais abaixo em Desativar o chat por defeito.

Substituir um recurso pela tua própria pasta

Se quiseres que a tua versão de um recurso ocupe o lugar do que vem por defeito (mesmo nome, mesma ordem de carregamento, mesma prioridade enquanto recurso de sistema), podes colocá-la numa pasta especial que verificamos no arranque. Como não consegues aceder diretamente a /opt/cfx-server/citizen/system_resources/, expomos em alternativa um local 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 com o nome do recurso que queres substituir — chat, monitor, webpack ou yarn.
5. Envia o teu recurso de substituição para dentro dela, por exemplo para /config/.zaroz/chat/.

Por SFTP

Se preferires trabalhar por SFTP, a mesma pasta encontra-se em /server/config/.zaroz/ 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, aqui para o recurso de chat, fica assim:

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

Estrutura final

Cada substituição vai na sua própria pasta dentro de .zaroz/, com o nome exato do recurso. Podes substituir um recurso ou vários ao mesmo tempo:

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

No próximo arranque, o contentor substitui a pasta correspondente dentro de /opt/cfx-server/citizen/system_resources/ por um link simbólico que aponta para a tua pasta .zaroz/<recurso>/. 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.

O nome da pasta tem de coincidir com o do recurso

A pasta dentro de .zaroz/ tem de chamar-se exatamente chat, monitor, webpack ou yarn. Esses são os nomes que o FiveM espera para os seus recursos de sistema. Uma pasta com qualquer outro nome é ignorada.

Substituir monitor substitui o txAdmin

O recurso monitor é o painel de administração txAdmin. Substitui-o apenas se a tua intenção for distribuir um txAdmin modificado — uma pasta monitor vazia ou avariada deixa-te sem painel de administração.

Voltar ao recurso de origem

Para repor um recurso original, basta apagar (ou renomear) a sua pasta dentro de .zaroz/ e reiniciar o servidor. O contentor volta a usar a versão integrada.

Desativar o chat por defeito

O recurso chat tem uma opção extra que os outros não têm: podes removê-lo por completo em vez de o substituir.

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.

Perguntas frequentes

Que recursos posso substituir?

Quatro recursos de sistema: chat, monitor, webpack e yarn. Cada um é substituído de forma independente com a sua própria pasta dentro de .zaroz/.

Posso substituir mais do que um recurso ao mesmo tempo?

Sim. Adiciona uma pasta por recurso dentro de .zaroz/. Cada uma é ligada de forma independente no arranque, e os recursos para os quais não forneceres uma pasta mantêm a sua versão integrada.

Posso desativar o chat por defeito e fornecer o meu 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.

As minhas substituições sobrevivem 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.