Publicação

Instalando o resource

Coloque o resource exportado no seu servidor e execute-o.

Depois de projetar a sua interface no Easelt Builder e exportá-la, você terá um resource de MTA:SA pronto para executar, à espera dentro de um arquivo .zip. Esta página orienta você por cada passo de colocar esse resource no seu servidor, iniciá-lo e fazer com que a sua GUI seja desenhada para os jogadores — além de alguns problemas comuns e como resolvê-los.

O que há na sua exportação

Quando você exporta do Easelt Builder, obtém um .zip contendo um resource de MTA:SA completo e autossuficiente. Antes de instalar qualquer coisa, ajuda saber o que cada parte faz.

meta.xml

O manifesto do resource. Ele declara os seus scripts como type="client" e lista os arquivos que o MTA deve carregar e enviar aos jogadores.

gui.lua

O código de desenho dx do lado do cliente que renderiza a sua interface — os painéis, botões, sliders e textos que você projetou.

lib.lua

A biblioteca de apoio da qual a sua GUI depende. Mantenha-a sempre junto de gui.lua.

assets/

A pasta que contém quaisquer imagens e outros assets que o seu design referencia.

ℹ️

Os scripts são de desenho dx do lado do cliente — o meta.xml os declara como type="client", então a GUI é desenhada localmente para cada jogador que recebe o resource.

Instale passo a passo

Descompacte no seu diretório de resources
Extraia a pasta exportada para o diretório de resources do seu servidor, por exemplo server/mods/deathmatch/resources/. Mantenha meta.xml, gui.lua, lib.lua e a pasta assets/ juntos dentro dessa única pasta de resource.
Atualize a lista de resources
No console do servidor ou no seu painel de administração, execute /refresh para que o MTA examine o diretório de resources e reconheça o resource recém-adicionado.
Inicie o resource
Execute /start <resourceName>, substituindo <resourceName> pelo nome da pasta do seu resource. O MTA começará a enviar os arquivos do cliente aos jogadores conectados.
Mostre o cursor para a interação
Para que botões e sliders registrem os cliques, certifique-se de que showCursor(true) seja chamado para o jogador — seja a partir do seu gamemode ou de um pequeno resource de acionamento próprio.

Referência de comandos do servidor

Estes são os dois comandos que você executará para colocar o resource no ar. Digite-os no console do servidor ou no seu painel de administração.

Comando	O que faz
/refresh	Reexamina o diretório de resources para que o MTA reconheça o resource recém-adicionado.
/start <resourceName>	Inicia o resource e começa a enviar a GUI do cliente aos jogadores.

Como a GUI chega aos jogadores

Como os scripts são do lado do cliente, a GUI é desenhada individualmente para cada jogador que recebe o resource. Quando você dá /start no resource, o MTA transmite os arquivos do cliente aos jogadores conectados e o desenho dx é executado na máquina deles — não há renderização por jogador no servidor para gerenciar.

💡

Para que os controles clicáveis funcionem, showCursor(true) deve estar ativo para o jogador. Sem um cursor visível, botões e sliders não conseguem receber cliques.

Renomeando o resource

Você tem liberdade para renomear a pasta do resource para o que se adequar à convenção de nomes do seu servidor. Apenas lembre-se de iniciá-lo por esse novo nome de pasta com /start <resourceName>.

⚠️

Ao renomear, mantenha meta.xml, gui.lua e lib.lua juntos na mesma pasta. Separá-los quebrará o resource.

Solução de problemas

Sintoma	Solução
Nada aparece na tela	Confirme se o resource está realmente iniciado (`/start <resourceName>`) e se o cliente o baixou — os arquivos do lado do cliente precisam chegar ao jogador antes que algo seja desenhado.
Os cliques não funcionam	Certifique-se de que `showCursor(true)` seja chamado para o jogador. Botões e sliders precisam de um cursor visível para registrar os cliques.

💡

Se uma alteração no seu design não estiver aparecendo, execute /refresh novamente após reexportar e readicionar o resource, e então dê /start nele para que o MTA reenvie os arquivos do cliente atualizados.