[V3.0] Changes to xui.xml — The ruleset Layer Is Gone

The single most important change to xui.xml (the file that defines window_group entries) is the removal of the <ruleset> layer. Both XUi_InGame/xui.xml and XUi_Menu/xui.xml changed in the same way.

Key Changes

• Simplified hierarchy
  • Old: <xui><ruleset name="default" scale="1.255" ...>...window_group...</ruleset></xui>
  • New: <xui scale="1.255" stackpanel_scale="1.05">...window_group...</xui> (ruleset is gone, ignore_missing_class is gone too, and attributes like scale have been promoted to the root element)
• Attributes are now all lowercase: defaultSelected → defaultselected, actionSet → actionset (this affects every window_group)
• New always_update="true": added to the crafting and radial window_groups
• Added window_groups: combine, workstation_forge_nosmelting, popupMenu (split out from toolTip), bagStorage (replaces the old vehicleStorage), signGallery/signEditor, sandboxOptions, and more
• Removed/replaced: vehicleStorage → bagStorage, and editing-related windows such as bugReportWindow have been cleaned up

Impact on MODs

• Any xpath rooted at /xui/ruleset/... will completely break. Since there is no longer a ruleset node, expressions like /xui/ruleset/window_group[@name='character'] will miss. Use /xui/window_group[@name='character'] instead.
• Attribute selectors that key on @defaultSelected / @actionSet must all be switched to @defaultselected / @actionset (lowercase).
• If you add your own tabs/screens as a window_group, fix their placement to sit directly under /xui, and move your patch location from Config/XUi/xui.xml → Config/XUi_InGame/xui.xml (or XUi_Menu for the menu side).
• If you depend on removed group names such as vehicleStorage, you will hit broken references (switch to bagStorage).

Reference: Example Diff

-<xui>
-   <ruleset name="default" scale="1.255" stackpanel_scale="1.05" ignore_missing_class="false">
-       <window_group name="crafting" ... defaultSelected="bp.content">
+<xui scale="1.255" stackpanel_scale="1.05">
+   <window_group name="crafting" ... defaultselected="bp.content" always_update="true">
 ...
-   </ruleset>
-</xui>
+</xui>

*Based on investigation performed right after applying the experimental build (equivalent to B252).

---

Related: List of MOD-making articles