Skip to main content

Widgets and Layouts

Layout Breakdown

Here's a brief breakdown of the main layouts and widgets that make the UI, and how to modify them to suit your needs.

note

For a comprehensive look at creating and substituting your own components into the Template UI, see Creating Custom Components and Substituting Components in the Template Mod Browser

WBP_ModioModBrowser

modio mod browser This is the main layout for the mod browser. The layouts are built to be navigable on both keyboard & mouse and gamepad. The layout will scale responsively to different screen aspect ratios.
 

WBP_ModioDefaultModTile

The mod tile that will populate the browser. Their scale and padding in the browser can be set via the WBP_ModioDefaultModTile layout in the WBP_ModioModBrowser layout.

modio mod tile

WBP_ModioModDetailsDialog

While the thumbnail gallery should be kept at a consistent aspect ratio of 16:9, the rest of the layout & widgets can be scaled to suit your current layout.

modio mod details dialog

WBP_ModioFilterPanel

The filter panel uses both radio and check boxes for filter and sort options, broken down into sub-categories that can be expanded or collapsed.

modio mod filter panel

File Locations

modio mod filter panel

The main working layout for the mod browser is WBP_ModioModBrowser, which can be found under ModioComponentUI/Content/UI/Templates/Default.

Generally, layouts and elements which have a specific use such as confirmation modals, storage widgets, unique buttons etc. can be found in the UI/Templates folder, and general core elements like buttons, modals, image galleries, etc can be found in the UI/Components folder.

Modifying Layouts

A UI style element is applied to a range of widgets, and allows for colours assigned to their states (static, highlighted, selected, premium, etc) to be called from a data table called DT_UIColors.
 

WBP_ModioDefaultModTile

modifying the mod tile

Border ColourThe outline on highlighted mod tiles
Background ColorThe base colour behind the mod name and details
Text ColorColour of the mod name & details
Price Text ColorColour of the Price tag on Premium Mods


 

WBP_ModioDefaultButton and WBP_ModioDefaultIconButton

modifying buttons

Most buttons will use these as a parent, so the following UI settings will be available to their children:

Button ColorColor of the base of the button
Icon TypeSetting the icon sprite for the IconButton variant
Text ColorColor of the icon text
Text SizeFont size of the icon text
Font PropertiesFont Family, style, size, spacing, skew, material, and outline
Text AlignmentLeft, right, centre, or fill
Text Transform SettingsUpper case, lower case, or none


 

WBP_ModioModBrowser

modifying the mod browser

Inside WBP_ModioModBrowser, you can find a modified grid layout named ModTileView. This is populated with WBP_ModioDefaultModTile. The ModTileView layout controls the size and padding of the tiles.

The size of the thumbnail is locked to a 16:9 aspect ratio — while the mod tiles can be resized to suit your needs, by default they will need to work around this restriction.