{"id":220,"date":"2026-07-23T07:30:41","date_gmt":"2026-07-23T13:30:41","guid":{"rendered":"https:\/\/bad-neighbors.com\/index.php\/xui-distro-tool-help\/"},"modified":"2026-07-23T07:30:41","modified_gmt":"2026-07-23T13:30:41","slug":"xui-distro-tool-help","status":"publish","type":"page","link":"https:\/\/bad-neighbors.com\/index.php\/xui-distro-tool-help\/","title":{"rendered":"XUI Distro Tool Help"},"content":{"rendered":"
\n
\n
XUI<\/div>\n
\n

Bad Neighbors Tools<\/p>\n

XUI Distro Tool Help<\/h1>\n

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.<\/p>\n

\n Open XUI Tool<\/a>\n Home<\/a>\n <\/div>\n <\/div>\n <\/div>\n\n
\n
\n

01<\/p>\n

Paste Or Load XML<\/h2>\n

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

\n

02<\/p>\n

Render The Layout<\/h2>\n

Click Render<\/strong> 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.<\/p>\n <\/article>\n

\n

03<\/p>\n

Use Reference Files<\/h2>\n

Load windows.xml<\/code> to browse windows by name. Load templates.xml<\/code> and styles.xml<\/code> when your pasted XML depends on shared templates, named colors, or custom controls.<\/p>\n <\/article>\n

\n

04<\/p>\n

Match A Screenshot<\/h2>\n

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.<\/p>\n <\/article>\n

\n

05<\/p>\n

Edit By Clicking<\/h2>\n

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.<\/p>\n <\/article>\n

\n

06<\/p>\n

Copy The Result<\/h2>\n

When the preview looks right, use Copy current XML to left editor<\/strong>, review the updated XML, and move the relevant changes back into your mod files.<\/p>\n <\/article>\n <\/div>\n\n

\n

What This Tool Is Good At<\/h2>\n
    \n
  • Quickly checking XUI positions, sizes, labels, grids, sprites, and rough layout relationships.<\/li>\n
  • Comparing a layout against an in-game screenshot without constantly restarting the game.<\/li>\n
  • Testing small position and size adjustments before copying values back into XML.<\/li>\n
  • Finding layout mistakes like overlapping panels, off-screen controls, or bad scale assumptions.<\/li>\n <\/ul>\n <\/div>\n\n
    \n

    What To Remember<\/h2>\n
      \n
    • This is an approximate previewer, not the game renderer.<\/li>\n
    • Real game fonts, textures, controller behavior, bindings, and runtime data may still differ.<\/li>\n
    • Some patches that only modify an existing window cannot be previewed by themselves. Paste or load the full resulting window when possible.<\/li>\n
    • Use the tool for your own layout work. Do not copy, mirror, redistribute, resell, reverse engineer, or claim the tool as your own.<\/li>\n <\/ul>\n <\/div>\n <\/section>\n \n","protected":false},"excerpt":{"rendered":"","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"iawp_total_views":1,"footnotes":""},"class_list":["post-220","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/bad-neighbors.com\/index.php\/wp-json\/wp\/v2\/pages\/220","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bad-neighbors.com\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/bad-neighbors.com\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/bad-neighbors.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/bad-neighbors.com\/index.php\/wp-json\/wp\/v2\/comments?post=220"}],"version-history":[{"count":0,"href":"https:\/\/bad-neighbors.com\/index.php\/wp-json\/wp\/v2\/pages\/220\/revisions"}],"wp:attachment":[{"href":"https:\/\/bad-neighbors.com\/index.php\/wp-json\/wp\/v2\/media?parent=220"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}