Comment fonctionne DZML

DZML est une manière d'écrire un menu DayZ comme une page HTML. Le jeu ne lit pas le HTML : il lit des fichiers .layout, un format texte qui liste des widgets avec leur position, leur taille et leurs propriétés. DZML contient les mêmes informations écrites en HTML, ce qui est plus facile à lire, à écrire à la main, à comparer avec un diff, et à demander à un assistant. Le Workbench compile la page en le .layout que le jeu charge, et peut reconvertir n'importe quel .layout existant en DZML.

Vous n'êtes pas obligé de l'utiliser. L'Éditeur de layouts ouvre et modifie aussi les fichiers .layout bruts. DZML est la manière recommandée de démarrer une nouvelle UI.

L'idée en un exemple

<body data-dzml="vanilla">
<div data-dz="frame" data-name="Root" class="dz-xy-0-0 dz-wh-full">
  <div data-dz="panel" data-name="Window" class="dz-wh-500px-260px dz-align-cc dz-c-1C1C1CF0">
    <span data-dz="text" data-name="Title" class="dz-xy-0-16px dz-wh-460px-36px dz-align-tc dz-font-28 dz-exact-text">Warning</span>
    <button data-dz="button" data-name="CloseButton" data-on-click="Close" data-style="Colorable"
            class="dz-xy-0-20px dz-wh-160px-40px dz-align-bc dz-c-B03030FF">Close</button>
  </div>
</div>
</body>

De la page au jeu

  1. Vous écrivez MyMod/gui/layouts/my_menu.html.
  2. Le Workbench la vérifie (widgets inconnus, noms en double, tailles manquantes, polices et images qui n'existent pas) et montre les problèmes avec leur ligne.
  3. Il la compile en my_menu.layout à côté de la page. Les deux fichiers vont dans le mod ; le jeu charge le .layout.
  4. Il rend le layout comme le jeu le dessine, à plusieurs résolutions d'écran, avec les polices, styles et images du jeu. Le texte qui déborde, les widgets hors écran ou superposés sont signalés.
  5. Pour une page vanilla, il peut écrire le script du menu : une classe avec un champ par widget nommé, la distribution des événements, et une méthode vide pour chaque data-on-click="Method".

Dans l'Éditeur de layouts, cela correspond au canevas, à la liste des problèmes, à Enregistrer, à Aperçu et à l'onglet Script. Le canevas et le HTML restent synchronisés : déplacez un widget sur le canevas et seule sa balise ouvrante change dans la page ; votre mise en forme et vos commentaires sont conservés.

Faire la visite de DZML (dans l'app) · Démarrer une nouvelle page DZML (dans l'app)

Deux sortes de pages

Pages vanilla (par défaut)

<body data-dzml="vanilla"> est une page pour un mod ordinaire, sans dépendance.

Pages DayZular

DayZular est un mod de framework d'UI pour DayZ : au lieu de remplir les widgets à la main, la page les lie à des données. DZML a d'abord été conçu pour lui, ce qui explique que les attributs de liaison ressemblent à ceux d'un framework web. Dans une page sans data-dzml="vanilla" :

Ces éléments se compilent en classes de script qui n'existent que dans le mod DayZular, donc une page DayZular a besoin de ce mod sur le serveur et chez les clients. Dans une page vanilla, ils sont signalés comme des erreurs (dayzular-only). Si vous ne savez pas lequel il vous faut, il vous faut une page vanilla.

Convertir un layout existant

Ouvrez n'importe quel .layout (le vôtre ou celui du jeu) et choisissez Vers DZML : le Workbench écrit le .html équivalent à côté. Tout layout vanilla survit à l'aller-retour sans changement, donc c'est aussi le moyen le plus rapide d'apprendre : ouvrez un menu du jeu et lisez-le en HTML.

Ouvrir le menu principal du jeu (dans l'app)

Positions et tailles, ce qui surprend

Styles et images

Pièges

Pour les agents

Voir aussi

Éditeur de layouts · Studio de styles · Éditeur de scripts · Premiers pas