Easelt BuilderDocs
Feedback
Abrir o Easelt Builder →
Publicação

Exportar para o MTA

Transforme o seu design num recurso MTA:SA pronto a executar.

Quando o seu design estiver pronto, o Easelt Builder empacota-o num recurso MTA:SA completo que pode colocar diretamente no seu servidor. Esta página descreve exatamente o que é exportado, para que serve cada ficheiro dentro do .zip e a única coisa que o seu recurso anfitrião tem de fazer para que os seus botões e sliders respondam de facto aos cliques.

Como exportar

Existem duas formas de acionar a exportação de um recurso, e ambas produzem o mesmo pacote .zip. Escolha a que melhor se adequa ao seu fluxo.

  1. Use o botão Exportar
    Clique no botão Exportar na barra de ferramentas superior para gerar e transferir o .zip do seu recurso MTA num único clique.
  2. Ou use o menu Ficheiro
    Abra Ficheiro → Exportar recurso MTA… para produzir exatamente o mesmo .zip. Use esta opção se preferir trabalhar a partir dos menus.
ℹ️

Apenas é oferecido o único fluxo Exportar recurso MTA (.zip) — ele agrupa tudo de um design num só arquivo. Não há opções de exportação parcial ou por ficheiro para configurar.

O que está dentro do .zip

O arquivo exportado é um recurso MTA pronto a executar. Contém quatro coisas: dois scripts Lua, um manifesto e uma pasta de recursos. Eis o que cada um faz.

Ficheiro / pastaPara que serve
gui.luaA sua interface. Contém todas as chamadas dxDraw mais a lógica compilada do Blueprint — cliques, condições, abertura e fecho de janelas, e alterações de texto ou cor.
lib.luaUma biblioteca de auxiliares de desenho da qual o gui.lua depende. É carregada automaticamente antes do gui.lua para que as funções auxiliares existam no momento em que a sua interface é executada.
meta.xmlO manifesto do recurso. Lista os scripts como client-side e declara quaisquer ficheiros de recursos para que o MTA os carregue corretamente.
assets/Todas as imagens e fontes que importou, mais a imagem de fundo se o seu design usar uma.

gui.lua

Este é o coração da sua exportação. Contém todas as suas chamadas dxDraw — os pixels reais da sua interface — juntamente com a lógica compilada a partir do seu Blueprint: o que acontece num clique, que condições controlam o comportamento, quando as janelas abrem e fecham, e como o texto e as cores mudam em tempo de execução.

lib.lua

O lib.lua é uma biblioteca partilhada de auxiliares de desenho usada pela sua interface. Como é carregado automaticamente antes do gui.lua, não precisa de o requerer ou configurar você mesmo — as funções auxiliares estão prontas no momento em que o gui.lua começa a desenhar.

meta.xml

O manifesto que o MTA lê para compreender o seu recurso. Regista o lib.lua e o gui.lua como scripts client-side e lista quaisquer ficheiros em assets/ para que o motor saiba que deve transferi-los e transmiti-los aos jogadores.

assets/

Tudo o que importou é entregue aqui — imagens e fontes — juntamente com a imagem de fundo se o seu design usar uma. Estes são os ficheiros referenciados pelo meta.xml e carregados pela sua interface.

ℹ️

Todos os ficheiros exportados incluem o cabeçalho de direitos de autor do Easelt Builder (© Easelt · C4).

Torne a sua interface interativa

Para que botões, sliders e outros controlos recebam cliques, o cursor do rato tem de estar visível no jogo. O Easelt Builder desenha a sua interface, mas mostrar o cursor é tarefa do recurso anfitrião.

⚠️

O seu recurso anfitrião tem de chamar showCursor(true) para que os botões e sliders recebam cliques. Sem isso, a sua interface será desenhada, mas não responderá ao rato.

Exporte antes uma imagem plana

Por vezes só quer uma imagem do seu design — para um mockup, uma publicação num fórum ou uma revisão de design. Use Ficheiro → Exportar design como PNG… para guardar uma imagem plana do seu layout. Isto é separado da exportação do recurso e produz um único .png em vez de um recurso executável.

Exportar recurso MTA (.zip)
O recurso completo e executável — gui.lua, lib.lua, meta.xml e assets/. Use isto para entregar a sua interface a um servidor.
Exportar design como PNG…
Uma imagem plana do seu design. Use isto para pré-visualizações, mockups e partilha — não para executar no jogo.

Próximos passos

Agora tem um .zip de recurso MTA completo. Vá em seguida à página Instalar para aprender a colocá-lo na pasta resources do seu servidor, adicioná-lo ao mtaserver.conf e iniciá-lo no jogo.

Got feedback or an idea?Share it →