dayz-layout-preview
Renders a DayZ .layout to approximate PNG previews at several screen sizes (1280x720, 1920x1080, 2560x1440, 3440x1440 by default): widget boxes, panel colors, text and image placeholders placed from p
SKILL.mdskills/dayz-layout-preview/SKILL.md
GitHub<!-- skill-dir-note -->
Path note:
<skill-dir>in commands below is the absolute path of this skill's folder. When the agent loads this skill the harness exposes the skill's base directory; substitute it before running. Sibling skills are reached via<skill-dir>\..\dayz-X\.
/dayz-layout-preview
A script reads the .layout, works out every widget's box at each screen size and draws it. It starts no game and needs no DayZ Tools. The AI only looks at the PNGs and the findings and decides what to change.
Follow skills/_shared/dayz-conventions.md. The layout format itself is in skills/_shared/figma-to-dayz-rules.md.
It does not gate on /dayz-preflight: it reads only the .layout files you pass and needs no DayZ Tools, so a layout in your clone previews with P:\ unmounted. When an input path is on P:\ (a vanilla layout) and P:\ is not mounted, the script says so and points you to /dayz-workdrive instead of reporting a plain missing file.
Requirements
Pillow draws the PNGs. If it is missing the script exits 2 with an install hint:
python -m pip install -r "<skill-dir>\requirements.txt"
How to run
python "<skill-dir>\layout_preview.py" <file.layout> [more.layout ...] [options]
| Argument | Notes |
|---|---|
<file.layout> |
One or more layouts. Vanilla ones under P:\gui\layouts\ work too. |
--sizes |
Comma separated WIDTHxHEIGHT list. Default 1280x720,1920x1080,2560x1440,3440x1440. Each width and height must be 1 to 8192 pixels; anything else is refused (exit 1). |
--out |
Folder for the PNGs. Default output\layout-preview\ under the project root, wherever you run it from. A folder inside workspace\<ModName>\ is refused (exit 1), and so is a path that is an existing file. A re-run overwrites PNGs of the same name there. |
--show-hidden |
Also draw widgets with visible 0, faded. By default they and their children are left out. |
--no-labels |
Leave widget names off the boxes. |
--json |
Print every widget's box at every size, and the findings, as JSON. Stdout then holds only the JSON; the [OK], [WARN], [NOTE] and [FAIL] lines go to stderr. |
Each PNG is named <layout>_<W>x<H>.png. When two layouts in one run share a file name, their parent folder names go in front (modA_gui_hud_1280x720.png, modB_gui_hud_1280x720.png) so neither overwrites the other.
Output and exit codes
One [OK] line per PNG, then one [WARN] or [NOTE] line per finding. Findings never change the exit code. Exit 0 when every layout was drawn, 1 when a file is missing or cannot be parsed, a path is on P:\ while P:\ is not mounted (the line says to run /dayz-workdrive), --out is inside a mod's workspace folder or names a file (the line says why), --sizes is malformed or out of range, or a PNG can't be written (for example a folder you can't write to), 2 when Pillow is missing. A layout that fails gets one [FAIL] <path>: <reason> line and the run goes on to the next layout.
| Finding | Line | Means |
|---|---|---|
off-screen |
[WARN] |
A shown widget's box goes past the screen edge at the listed sizes. Often a pixel offset that only fits wide screens. |
no-area |
[WARN] |
A shown widget is under one pixel wide or high at the listed sizes, usually a tiny relative size. |
missing-toggle |
[NOTE] |
A widget leaves out an exact toggle over a nonzero position or size value, so the toggle decides the box. The preview draws it as 0 (relative). Vanilla files do this and load (P:\gui\layouts\day_z_ingamemenu.layout:1 is a full-screen menu root with size 1 1 and no size toggles), so it is a note for the repo rule that every toggle be written (figma-to-dayz-rules.md section 6), not a load problem. A toggle over a value of 0 changes nothing and is not reported, such as position 0 0 with no hexactpos at P:\gui\layouts\day_z_hud.layout:1. |
What the preview draws
- Frames as grey outlines, panels and windows filled with their
color, images as a tinted box with a cross and theimage0name, buttons in green, spacers in purple. - Text from
text, clipped to its box, at"exact text size"when"exact text" 1is set, aligned by"text halign"and"text valign". Localized keys such as#layout_...are drawn as written. - Children in
priorityorder, so higher priority draws on top.
How boxes are worked out
hexactsize 1makes the width that many pixels;hexactsize 0makes it that fraction of the parent's width. The same goes forvexactsize,hexactposandvexactpos.halign right_refmeasures the x offset from the parent's right edge,center_reffrom its center.valign bottom_refandcenter_refwork the same way. The plainright,centerandbottomvalues are treated the same as the_refones.scaled 1multiplies exact pixel values by the screen height divided by 1080.- A
GridSpacerWidgetClasssplits its box, lessPaddingandMargin, intoColumnsbyRowscells and fills them in order. AWrapSpacerWidgetClassflows its children left to right and wraps at its width. Children of either ignore their ownposition.
Limits
- It is an approximation, not the game renderer. Fonts, styles, imageset art,
fixaspect,"Size To Content", safe zones and script that moves widgets at run time are not drawn. - The 1080 reference height for
scaled 1is an assumption. Check a layout that depends on it in game with/dayz-launch-test. - It reads structure loosely. A file the edit hook rejects may still draw; fix what the hook reports first. A
//comment, on its own line or at the end of one, is skipped;//inside a quoted string is kept.
Do not
- Don't treat a clean preview as proof the layout loads. Workbench and the game are the judges;
dayz-layout-validatorchecks the rules. - Don't write PNGs into a mod folder; they would be packed into the PBO. The script refuses an
--outunderworkspace\<ModName>\.