SFTP (SSH File Transfer Protocol) é um protocolo de rede criptografado para transferência de arquivos por uma conexão SSH. Ele permite trocar arquivos com segurança entre seu PC e seu servidor de jogos. Com o SFTP, você pode acessar e gerenciar os arquivos do servidor — seja para enviar e baixar arquivos ou editá-los diretamente.
Os servidores de jogos ZapX oferecem acesso exclusivamente via SFTP. O FTP tradicional, sem criptografia, não é compatível.
Para acessar via SFTP, você precisa de um cliente SFTP compatível. Há várias opções disponíveis, mas dois dos clientes mais conhecidos e consolidados são o FileZilla e o WinSCP.
| Cliente SFTP | Download |
|---|---|
| FileZilla | Site oficial |
| WinSCP | Site oficial |
No FiveM, você usa o SFTP principalmente para seus resources, o server.cfg e os dados do txAdmin. A conexão e os dados de acesso funcionam exatamente como descrito acima. Mesmo que muita gente fale em "FiveM FTP": na ZapX você sempre se conecta via SFTP.
Depois de entrar, os arquivos do FiveM ficam na pasta fivem e, dentro dela, na pasta da sua variante, por exemplo fivem/standard. Lá você encontra:
| Pasta / arquivo | Conteúdo |
|---|---|
<Nome>_<Código>.base (ex.: Qbox_E99E54.base) | A pasta do servidor que o txAdmin cria ao configurar o servidor com uma receita (recipe). Nela ficam o server.cfg e a pasta resources. |
default | O perfil do txAdmin com as configurações (config.json), os dados e os logs |
admins.json | As contas de administrador do txAdmin |
server-data | Outra pasta de servidor com o próprio server.cfg e a própria pasta resources |
artifacts | Os arquivos de servidor do FiveM (FXServer). Aqui você não precisa alterar nada. |
Na ZapX não existe uma pasta txData separada. Os dados do txAdmin ficam diretamente nesta pasta da variante.
Para ver qual pasta de servidor está ativa, abra o txAdmin e acesse Settings → FXServer, campo Server Data Folder. Alterações em um server.cfg de outra pasta não têm efeito.
- Extraia o resource baixado no seu PC. O arquivo
fxmanifest.lua(__resource.luaem resources mais antigos) precisa estar diretamente na pasta do resource. - Pare o seu servidor.
- Envie a pasta via SFTP para a pasta
resourcesda sua pasta de servidor ativa. - Adicione o resource ao
server.cfgcomstart <nomedapasta>e inicie o servidor.
Você encontra mais detalhes no guia FiveM: Instalação de Resources.
- Pare o servidor antes de alterar o
server.cfg, arquivos da pastadefaultou oadmins.json. O servidor e o txAdmin gravam nesses arquivos, então alterações feitas com o servidor rodando podem ser sobrescritas. - Baixe antes uma cópia do arquivo para poder voltar ao estado anterior se algo der errado.
- Alterações menores no
server.cfgtambém podem ser feitas diretamente no CFG Editor do txAdmin.
No FiveM, a pasta que mais cresce é a cache, dentro da pasta do servidor (<Nome>_<Código>.base/cache). Você pode excluí-la com o servidor parado, o FiveM a recria na próxima inicialização. Você também pode remover arquivos de log antigos em default/logs. Não altere a pasta artifacts nem os demais arquivos do txAdmin.
Verifique se o nome da pasta corresponde exatamente ao nome no comando start (maiúsculas e minúsculas fazem diferença) e se o fxmanifest.lua está diretamente na pasta, e não em uma subpasta. Você encontra outros problemas em FiveM: Problemas comuns.
