Publication

Installation de la ressource

Déposez la ressource exportée dans votre serveur et lancez-la.

Une fois que vous avez conçu votre interface dans Easelt Builder et que vous l'avez exportée, vous disposez d'une ressource MTA:SA prête à l'emploi qui vous attend dans un fichier .zip. Cette page vous accompagne à chaque étape pour déposer cette ressource dans votre serveur, la démarrer et faire en sorte que votre GUI s'affiche pour les joueurs — en plus de quelques pièges courants et de la manière de les corriger.

Contenu de votre export

Lorsque vous exportez depuis Easelt Builder, vous obtenez un .zip contenant une ressource MTA:SA complète et autonome. Avant d'installer quoi que ce soit, il est utile de savoir à quoi sert chaque élément.

meta.xml

Le manifeste de la ressource. Il déclare vos scripts comme type="client" et liste les fichiers que MTA doit charger et envoyer aux joueurs.

gui.lua

Le code de dessin dx côté client qui rend votre interface — les panneaux, boutons, curseurs et textes que vous avez conçus.

lib.lua

La bibliothèque de support sur laquelle repose votre GUI. Conservez-la toujours aux côtés de gui.lua.

assets/

Le dossier contenant toutes les images et autres ressources auxquelles votre design fait référence.

ℹ️

Les scripts sont du dessin dx côté client — meta.xml les déclare comme type="client", de sorte que le GUI est dessiné localement pour chaque joueur qui reçoit la ressource.

Installation étape par étape

Décompressez dans votre répertoire de ressources
Extrayez le dossier exporté dans le répertoire de ressources de votre serveur, par exemple server/mods/deathmatch/resources/. Conservez ensemble meta.xml, gui.lua, lib.lua et le dossier assets/ à l'intérieur de ce même dossier de ressource.
Actualisez la liste des ressources
Dans la console du serveur ou votre panneau d'administration, exécutez /refresh afin que MTA analyse le répertoire de ressources et détecte la ressource nouvellement ajoutée.
Démarrez la ressource
Exécutez /start <resourceName>, en remplaçant <resourceName> par le nom du dossier de votre ressource. MTA commencera à envoyer les fichiers client aux joueurs connectés.
Affichez le curseur pour l'interaction
Pour que les boutons et les curseurs enregistrent les clics, assurez-vous que showCursor(true) est appelé pour le joueur — soit depuis votre gamemode, soit depuis une petite ressource déclencheuse que vous créez vous-même.

Référence des commandes serveur

Voici les deux commandes que vous exécuterez pour mettre la ressource en ligne. Saisissez-les dans la console du serveur ou votre panneau d'administration.

Commande	Ce qu'elle fait
/refresh	Réanalyse le répertoire de ressources afin que MTA voie la ressource nouvellement ajoutée.
/start <resourceName>	Démarre la ressource et commence à envoyer le GUI client aux joueurs.

Comment le GUI parvient aux joueurs

Comme les scripts sont côté client, le GUI est dessiné individuellement pour chaque joueur qui reçoit la ressource. Lorsque vous exécutez /start sur la ressource, MTA diffuse les fichiers client aux joueurs connectés et le dessin dx s'exécute sur leur machine — il n'y a aucun rendu serveur par joueur à gérer.

💡

Pour que les contrôles cliquables fonctionnent, showCursor(true) doit être actif pour le joueur. Sans curseur visible, les boutons et les curseurs ne peuvent pas recevoir de clics.

Renommer la ressource

Vous êtes libre de renommer le dossier de la ressource avec ce qui convient à la convention de nommage de votre serveur. N'oubliez simplement pas de la démarrer avec ce nouveau nom de dossier à l'aide de /start <resourceName>.

⚠️

Lorsque vous renommez, conservez meta.xml, gui.lua et lib.lua ensemble dans le même dossier. Les séparer cassera la ressource.

Dépannage

Symptôme	Correctif
Rien ne s'affiche à l'écran	Vérifiez que la ressource est bien démarrée (`/start <resourceName>`) et que le client l'a téléchargée — les fichiers côté client doivent parvenir au joueur avant que quoi que ce soit ne s'affiche.
Les clics ne fonctionnent pas	Assurez-vous que `showCursor(true)` est appelé pour le joueur. Les boutons et les curseurs ont besoin d'un curseur visible pour enregistrer les clics.

💡

Si une modification de votre design n'apparaît pas, exécutez à nouveau /refresh après avoir réexporté et réajouté la ressource, puis exécutez /start sur celle-ci afin que MTA renvoie les fichiers client mis à jour.