List Box

The List Box object provides a scrollable list of text-based items directly inside your Custom Launcher. It is the perfect interface element for presenting choices to the user, whether they are selecting a game server, picking a save profile, choosing an installed modification, or viewing a changelog.

Because the List Box can dynamically load and save data from local text files, it is incredibly versatile. When paired with events, a simple list of options becomes an interactive hub for your Custom Game Launcher logic.

List Box Overview

A List Box acts as a container for multiple selectable rows. Users can click to select an item, or double-click to instantly trigger a confirmation event. The visual styling of the list is fully customizable, from the background and border to the font weight and hover colors of individual items.

Typical Uses

• ❖ Presenting a directory of community servers
• ❖ Displaying a list of installed game mods
• ❖ Creating a player profile selection screen
• ❖ Showing recent patch notes or news headlines
• ❖ Building an in-launcher inventory selector

Default Settings

When dropped onto your page, the List Box applies a clean, dark-themed styling configuration by default.

Properties

The visual editor allows you to shape the data and the appearance of the List Box.

Content

• List Items: Enter your default items here, with one item per line. You can also populate items dynamically using variables like {{name}}.

Colors and Borders

• Text and Background Colors: Set the foundational colors to match your launcher.
• Item Hover Color: Define the background color shown when a user moves their mouse over a specific list item.
• Border Color, Width, and Radius: Control the stroke thickness and corner roundness framing your List Box.

Typography

• Font Family and Size: Choose a font that fits your aesthetic, and set the text size in pixels.
• Font Weight and Style: Adjust thickness from thin to black, and toggle Italic or Underline.
• Text Align: Set the horizontal alignment (Left, Center, or Right) for all items.

List Box Events

To make the List Box truly interactive, you can wire logic into its two dedicated events.

onSelectionChange

This event fires the moment a user clicks on an item to select it. This is ideal for updating side-panels with context—for example, updating a Text Label with the description of a selected mod, or showing the ping of a selected server.

onItemDoubleClick

This event fires when a user double-clicks an item. This is widely recognized as a "Confirm" action. You can use this to instantly launch the game, join the selected server, or apply a chosen configuration profile.

All Possible Actions for the List Box

Your launcher logic can actively manipulate the contents of a List Box using several specific actions.

You can also use general object actions like Show Objects, Hide Objects, Move Object, and Resize Object to dynamically alter the list based on user interactions.

Building Logic with the List Box

The true power of the List Box lies in reading and writing data on the fly. Let's look at how you can utilize these functions.

Custom CSS Example

Because the List Box is available in the Developer Edition, you can write Custom CSS to style the scrollbars or fine-tune the internal padding and transitions.

 /* Developer Edition Custom CSS Example for List Box */
 /* No manual object scoping needed */
 /* Add inner padding and a soft glow to the main box */
 padding: 8px !important;
 box-shadow: inset 0 0 15px rgba(59,130,246,0.15) !important;
 /* Style the scrollbar */
 &::-webkit-scrollbar {
 width: 8px !important;
 }
 &::-webkit-scrollbar-track {
 background: #1f2937 !important;
 border-radius: 4px !important;
 }
 &::-webkit-scrollbar-thumb {
 background: #3b82f6 !important;
 border-radius: 4px !important;
 }
 &::-webkit-scrollbar-thumb:hover {
 background: #60a5fa !important;
 }
 

Summary

The List Box object is a cornerstone for organizing and displaying data collections inside a Custom Game Launcher. By utilizing its ability to read from files and react to selection events, you can transform static lists into robust loadout managers, profile selectors, or quick-connect server browsers.