Publicación

Instalación del recurso

Coloca el recurso exportado en tu servidor y ejecútalo.

Una vez que hayas diseñado tu interfaz en Easelt Builder y la hayas exportado, tendrás un recurso de MTA:SA listo para ejecutar esperando en un archivo .zip. Esta página te guía por cada paso para colocar ese recurso en tu servidor, iniciarlo y conseguir que tu GUI se dibuje para los jugadores, además de algunos inconvenientes comunes y cómo solucionarlos.

Qué contiene tu exportación

Cuando exportas desde Easelt Builder, obtienes un .zip que contiene un recurso de MTA:SA completo y autónomo. Antes de instalar nada, conviene saber qué hace cada pieza.

meta.xml

El manifiesto del recurso. Declara tus scripts como type="client" y enumera los archivos que MTA debe cargar y enviar a los jugadores.

gui.lua

El código de dibujo dx del lado del cliente que renderiza tu interfaz: los paneles, botones, sliders y texto que diseñaste.

lib.lua

La biblioteca de soporte en la que se basa tu GUI. Mantenla junto a gui.lua en todo momento.

assets/

La carpeta que contiene las imágenes y otros recursos a los que hace referencia tu diseño.

ℹ️

Los scripts son dibujo dx del lado del cliente: meta.xml los declara como type="client", por lo que la GUI se dibuja localmente para cada jugador que recibe el recurso.

Instálalo paso a paso

Descomprime en tu directorio de recursos
Extrae la carpeta exportada en el directorio de recursos de tu servidor, por ejemplo server/mods/deathmatch/resources/. Mantén meta.xml, gui.lua, lib.lua y la carpeta assets/ juntos dentro de esa única carpeta de recurso.
Actualiza la lista de recursos
En la consola del servidor o en tu panel de administración, ejecuta /refresh para que MTA escanee el directorio de recursos y detecte el recurso recién agregado.
Inicia el recurso
Ejecuta /start <resourceName>, reemplazando <resourceName> por el nombre de la carpeta de tu recurso. MTA comenzará a enviar los archivos del cliente a los jugadores conectados.
Muestra el cursor para la interacción
Para que los botones y sliders registren clics, asegúrate de que se llame a showCursor(true) para el jugador, ya sea desde tu gamemode o desde un pequeño recurso disparador propio.

Referencia de comandos del servidor

Estos son los dos comandos que ejecutarás para poner el recurso en marcha. Escríbelos en la consola del servidor o en tu panel de administración.

Comando	Qué hace
/refresh	Vuelve a escanear el directorio de recursos para que MTA vea el recurso recién agregado.
/start <resourceName>	Inicia el recurso y comienza a enviar la GUI del cliente a los jugadores.

Cómo llega la GUI a los jugadores

Como los scripts son del lado del cliente, la GUI se dibuja individualmente para cada jugador que recibe el recurso. Cuando ejecutas /start en el recurso, MTA transmite los archivos del cliente a los jugadores conectados y el dibujo dx se ejecuta en su máquina: no hay renderizado por jugador en el servidor que gestionar.

💡

Para que los controles clicables funcionen, showCursor(true) debe estar activo para el jugador. Sin un cursor visible, los botones y sliders no pueden recibir clics.

Renombrar el recurso

Eres libre de renombrar la carpeta del recurso con lo que se ajuste a la convención de nombres de tu servidor. Solo recuerda iniciarlo con ese nuevo nombre de carpeta mediante /start <resourceName>.

⚠️

Al renombrar, mantén meta.xml, gui.lua y lib.lua juntos en la misma carpeta. Separarlos romperá el recurso.

Resolución de problemas

Síntoma	Solución
No aparece nada en pantalla	Confirma que el recurso realmente está iniciado (`/start <resourceName>`) y que el cliente lo ha descargado: los archivos del lado del cliente deben llegar al jugador antes de que se dibuje nada.
Los clics no funcionan	Asegúrate de que se llame a `showCursor(true)` para el jugador. Los botones y sliders necesitan un cursor visible para registrar clics.

💡

Si un cambio en tu diseño no aparece, ejecuta /refresh de nuevo tras volver a exportar y volver a agregar el recurso, luego ejecuta /start en él para que MTA reenvíe los archivos actualizados del cliente.