Como enviar resources para seu servidor de MTA:SA

No MTA:SA quase tudo é um resource: o gamemode, o mapa, o sistema de carros, o painel de admin. Todos são o mesmo tipo de coisa e vão todos para o mesmo lugar.

A boa notícia é que, sabendo a pasta, o resto é rápido — e o MTA nem exige reiniciar o servidor para carregar algo novo.

A pasta certa

Este é o ponto que faz perder tempo. As resources não ficam na raiz do servidor. Elas ficam em:

mods/deathmatch/resources/

É lá dentro que vão os seus arquivos. Na mesma pasta mods/deathmatch/ também mora o mtaserver.conf, que é a configuração principal do servidor.

Conectando por SFTP

É SFTP, não FTP. O painel usa SFTP na porta 2022, não o FTP da porta 21. Marcar "FTP" no FileZilla derruba a conexão sem dizer o motivo.

Entre em pelican.vitthost.com.br, abra o servidor e copie os dados de SFTP de lá — o endereço varia conforme o nó e o usuário traz o identificador do servidor.

Enviando a resource

Uma resource pode ser uma pasta ou um arquivo .zip — o MTA aceita os dois. A pasta é mais prática porque dá para editar os arquivos direto no servidor.

1. Conecte no SFTP.
2. Navegue até mods/deathmatch/resources/.
3. Arraste a pasta (ou o .zip) para dentro.

Toda resource precisa de um meta.xml na raiz dela. É esse arquivo que diz ao MTA quais scripts carregar e o que exportar. Se ele não existir, o MTA ignora a pasta.

Cuidado com pasta dentro de pasta. Ao descompactar um download, é comum sobrar um nível extra: minha-resource/minha-resource/meta.xml. Assim não funciona — o meta.xml tem que estar no primeiro nível de dentro da pasta que você enviou.

Ligando sem reiniciar

Esta é a parte boa do MTA: não precisa reiniciar o servidor. Abra o console no painel e digite:

refresh

O refresh faz o servidor reler a pasta de resources e enxergar o que é novo. Depois:

start nome-da-resource

O nome é o da pasta, não o do arquivo .zip nem o que está escrito no meta.xml.

Comandos que valem conhecer:

Fazendo subir sozinho

O start vale para a sessão atual. Se o servidor reiniciar, a resource não volta sozinha.

Para ela subir junto com o servidor, acrescente uma linha no mtaserver.conf, que fica em mods/deathmatch/:

<resource src="nome-da-resource" startup="1" protected="0"/>

O startup="1" é o que manda ligar na inicialização. Coloque junto das outras linhas de <resource> que já estão no arquivo.

Quando dá errado

start responde que a resource não existe. Rode refresh antes. Se persistir, confira o nome da pasta — ele diferencia maiúscula de minúscula.

A resource liga mas não faz nada. Abra o console e procure erro de script. Quase sempre é um caminho errado dentro do meta.xml, apontando para um arquivo que não está lá.

Nada aparece no jogo. Veja se o meta.xml declara os arquivos do lado do cliente com type="client". Script de cliente não declarado não é baixado pelo jogador.

Servidor não sobe depois da alteração. O mtaserver.conf é XML: uma tag sem fechar derruba tudo. Volte a última linha que você mexeu e suba de novo.

Duas coisas que ajudam no dia a dia

Teste com restart em vez de reiniciar o servidor. Enquanto você desenvolve, restart minha-resource recarrega só ela e mantém os jogadores conectados.

Cuidado com resource baixada de fonte desconhecida. Resource é código rodando no seu servidor, com acesso ao banco e aos jogadores. Leia o meta.xml e veja o que ela declara antes de ligar algo que você não escreveu.

Faça cópia antes de mexer. A responsabilidade pelo backup é sua, conforme a cláusula 14 dos Termos de Uso.

Para arquivo solto, use o gerenciador do painel

O painel tem gerenciador de arquivos com editor de texto. Para corrigir uma linha do meta.xml ou do mtaserver.conf, é mais rápido que abrir o FileZilla.

Outros tutoriais desta série:

• Minecraft Java: como enviar plugins e mods
• Minecraft Bedrock: como enviar addons
• open.mp: como enviar gamemodes e plugins

Veja os planos de MTA:SA ou abra um ticket.