— — — — —
— — — — —
— — — — —
— — — — —
— — — — —
— — — — —
— — — — —
— — — — —
This is an old revision of the document!
The Widget Editor allows you to create custom UI components (i.e. widgets) for your game.
Custom widgets can be displayed in-game using the Show Widget scripting function. You can also add them to the management screen by adding their IDs to the comma-separated list of widgets in the “Experimental” section of your Game Configuration.
Icon | Function | Description |
---|---|---|
Save Widget | Saves changes to the widget. | |
Add Widget | Opens a popup dialog for adding a new widget. | |
Duplicate Widget | Duplicates the currently selected widget. A popup dialog will prompt for a unique ID that will be assigned to the new widget. | |
Remove Widget | Deletes the currently selected widget from your game project. This action cannot be undone. | |
Preview Background | Changes the background color of the Widget Editor's viewport (for previewing purposes). | |
Display Grid | Enables/disables display of the grid lines to aid in the placement of elements within the widget. | |
Display Element Type Icons | Enables/disables display of type icons for certain elements, for example a “chest” icon for item storage slots. This can help in quickly identifying different types of slots from each other. | |
Open Folder Location | Opens the “widgets” resource folder within your game project folder using the system's file explorer. |
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. | |
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. |
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. | |
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 mulitple crafting input slots to a widget, along with a button configured as a “Crafting” button, will allow the player to craft items together. 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, or craft items placed into crafting input slots. | |
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. |