XUI Distro Tool Help

The quick guide for using the ServerTools XUI Previewer: paste layout XML, render it, line it up against screenshots, adjust positions, and copy the updated XML back into your mod work.

Open XUI Tool Home

Paste Or Load XML

Paste a full <window> block into the left editor. The tool can also read a wrapped <append xpath="/windows"> block or a patch file that contains full window definitions.

Render The Layout

Click Render to preview the layout. The preview estimates positions, grids, colors, panels, sprites, labels, and common controls using the same kind of resolved XUI structure the game works from.

Use Reference Files

Load windows.xml to browse windows by name. Load templates.xml and styles.xml when your pasted XML depends on shared templates, named colors, or custom controls.

Match A Screenshot

Load a real screenshot, then adjust zoom and UI scale until the rendered boxes sit over the in-game layout. Use separate X and Y scale only when a screenshot or capture pipeline stretches the axes differently.

Edit By Clicking

Click a rendered box to edit its attributes in the right panel. Drag elements to test positions. Use the outlines and labels while working, then turn them off when you want a cleaner preview.

Copy The Result

When the preview looks right, use Copy current XML to left editor, review the updated XML, and move the relevant changes back into your mod files.

What This Tool Is Good At

Quickly checking XUI positions, sizes, labels, grids, sprites, and rough layout relationships.
Comparing a layout against an in-game screenshot without constantly restarting the game.
Testing small position and size adjustments before copying values back into XML.
Finding layout mistakes like overlapping panels, off-screen controls, or bad scale assumptions.

What To Remember

This is an approximate previewer, not the game renderer.
Real game fonts, textures, controller behavior, bindings, and runtime data may still differ.
Some patches that only modify an existing window cannot be previewed by themselves. Paste or load the full resulting window when possible.
Use the tool for your own layout work. Do not copy, mirror, redistribute, resell, reverse engineer, or claim the tool as your own.