O arquivo meta.xml explicado

Todo resource do MTA:SA precisa de um meta.xml. Ele diz ao servidor quais scripts rodar, quais arquivos enviar aos jogadores e como o resource se relaciona com outros.

Exemplo completo

<meta>
    <info author="SeuNome" name="Sistema de Empregos" version="1.2.0" type="script" description="Empregos para o RP" />

    <min_mta_version server="1.6.0" client="1.6.0" />
    <oop>true</oop>

    <include resource="banco" />

    <script src="server/main.lua" type="server" />
    <script src="shared/config.lua" type="shared" />
    <script src="client/hud.lua" type="client" cache="false" />

    <file src="img/logo.png" />
    <file src="sons/alerta.mp3" />

    <map src="mapas/empresa.map" dimension="0" />

    <export function="darSalario" type="server" />

    <settings>
        <setting name="*salario_base" value="500" />
    </settings>

    <download_priority_group>10</download_priority_group>
</meta>

Tags principais

<info>

Metadados: autor, nome, versão, tipo (script, gamemode, map, misc) e descrição.

<script>

• type="server" — roda só no servidor;
• type="client" — enviado e executado no jogador;
• type="shared" — roda nos dois lados (bom para configurações e funções utilitárias);
• cache="false" — o script de cliente não fica salvo no disco do jogador (dificulta cópia, mas não é proteção completa).

<file>

Arquivos que os jogadores devem baixar: imagens, sons, fontes, modelos (DFF), texturas (TXD), colisões (COL). Use download="false" para arquivos que você vai baixar sob demanda por script.

<map>

Mapas .map carregados junto com o resource.

<export>

Funções que outros resources podem chamar com exports.nomeDoResource:funcao(). O atributo http="true" permite chamar a função via HTTP.

<include>

Garante que outro resource seja iniciado antes deste.

<min_mta_version>

Exige uma versão mínima de servidor/cliente — importante quando você usa funções mais novas.

<oop>

Ativa a sintaxe orientada a objetos do MTA (ex.: player:getName()).

<settings>

Configurações editáveis, lidas por get() no script. O * torna a configuração pública; elas podem ser alteradas pelo painel admin.

<download_priority_group>

Define a ordem de download entre resources — útil para que o login ou a tela de carregamento baixem primeiro.

Erros comuns

• Arquivo listado que não existe → o resource não inicia;
• Caminho com barra errada ou maiúsculas/minúsculas diferentes → falha no Linux (diferencia maiúsculas);
• XML malformado (tag não fechada) → erro no refresh.

Hospede seu servidor com a VittHost

No MTASA-BR da VittHost (MTA 1.6.0 em Linux), você edita seus meta.xml pelo painel Pterodactyl, e os arquivos de cliente chegam rápido aos jogadores com downloads acelerados por nginx dedicado. Servidores no Brasil, proteção DDoS, MySQL incluso e teste grátis de 3 dias.