Widget Editor

The Widget Editor allows you to create custom UI components (i.e. widgets) for your game.

To create a new widget, click the “Add” button () on the main toolbar and then provide a unique ID that will be assigned to it. Once created, the width and height of the widget can be adjusted from the “Widget Properties” panel on the left-hand side of the editor. Elements (item slots, text fields, buttons, etc.) can be dragged and dropped from the “Widget Tools” panel onto the grid layout of the widget.

Elements that have been placed can be resized by selecting the element and then dragging the handles of the selection box. To delete an element, select it and press the Delete key or drag and drop it outside of the widget.

See the “Elements” section below for a description of each element type that can be added to a widget.

The “Widget Properties” panel contains various settings that can be adjusted for the active widget. It is displayed on the left-hand side of the editor when no elements are currently selected.

Icon	Property	Description
	Widget ID	Unique ID assigned to the widget. This ID is used to reference the widget in scripts and other places.
	Display Name	Name shown in the “Widgets” dropdown on the main toolbar. This is only used by the editor for display purposes.
	Grid Width (Columns)	Width of the widget, or number of columns in the grid. Elements placed into the widget are aligned to this grid.
	Grid Height (Rows)	Height of the widget, or number of rows in the grid. Elements placed into the widget are aligned to this grid.
	Initial Position	Determines where the widget will be initially positioned on the screen. This is particularly useful for widgets that are fixed (i.e. not draggable).
	Show Frame	Determines whether or not the frame graphic (i.e. the borders and background) is visible for this widget. Currently this graphic is inherited from the item container window style in your game's default theme.
	Draggable	Determines whether or not the player can move the widget around by clicking and dragging the titlebar or empty area of the window. The “Show Frame” property must be enabled for this option to be available.
	Show Titlebar	Determines whether or not the titlebar area is visible for this widget. The “Show Frame” property must be enabled for this option to be available.
	Titlebar Text	Text that will be displayed in the titlebar of the widget. The “Show Titlebar” property must be enabled for this field to be available.

Various elements can be added to a widget using the “Widget Tools” panel on the left-hand side of the editor. A brief description of each type is provided below. You can click on the name of a particular element for more information about that element and any properties that can edited once added to a widget.

Icon	Type	Description
	Item Storage Slot	Slot for storing an item or stack of items. This is useful for inventory windows, item container windows, or other widgets that are meant for storing items into for later retrieval and usage.
	Item Quick Slot	Slot for assigning an item to that the player currently possesses (for example, a health potion). This type of slot acts as a shortcut and allows the player to easily access the item during gameplay instead of being required to open their inventory.
	Equipment Slot	Slot for equipping an item to (for example, a sword or shield). The player can equip an item to the slot if the item has been configured as equippable in the Item Editor and it includes a tag matching the slot ID assigned to the equipment slot.
	Skill Slot	Slot for assigning a skill to (for example, a healing spell or physical ability).
	Shop Item Slot	Slot for allowing an item to be purchased by the player. The cost of the item is configured in the Item Editor.
	Crafting Input Slot	Slot that an item can be placed into for crafting purposes. Adding multiple crafting input slots to a widget, along with a button configured as a “Crafting” button, will allow the player to combine items together to create something new. The ingredients/materials required to craft a particular item is configured in the Item Editor.
	Text Label	Element for displaying plain text (for example, a header or label to accompany an adjacent element or group of elements).
	Text Field	Element for displaying text within a scrollable box. This is useful for descriptions and other instances of multi-line text that could vary in length. It can also be used as a text entry field, allowing the player to input text.
	Button	Clickable element that can be configured to run a script, close the parent widget, craft a new item into a storage slot using any populated input slots, or craft a specific item using the player's inventory.
	Image	Element for displaying a static image.
	Progress Bar	Element for visualizing the progression of a value relative to a maximum value (for example, a traditional HP bar to show the player's current health compared to their maximum health). The tracked value and its maximum value are currently set using variable expressions.
	3D Model	Element for displaying a 3D model that the player can rotate by clicking and dragging. This is currently limited to displaying the player character's model, with future updates allowing it to display others.
	Minimap	Element for displaying a top-down view of the current map.