Settings screen¶
One panel, centred on screen: a header with a search box and Edit HUD, a scrolling list of modules, and a footer line that explains whatever is under the mouse.
Open it with Right Shift in a world, or with the Xol button on the title screen or pause menu.
The module list¶
Each row shows the module's name, a one-line description, and a switch on the right.
- Click the switch to turn the module on or off.
- Click anywhere else on the row to expand it. An expanded module shows its settings, a line starting "Multiplayer:" with the module's multiplayer note, and two actions.
- Only one module is expanded at a time. A freshly opened module is scrolled into view.
- A setting whose value differs from its default is drawn in the brighter text colour; defaults are muted.
General is always first and has no switch. See General settings.
| Action | Effect |
|---|---|
| Reset settings | Returns every setting of that module to its default. |
| Reset position | HUD modules only. Returns the module to its default anchor, offset and 100% scale in the active layout. |
Search¶
The search box has focus when the screen opens, and typing anywhere goes into it. Placeholder: "Search modules and settings". It holds up to 32 characters.
- Matching ignores upper and lower case. Every word you type must appear somewhere in the text being searched.
- A module matches on its name, identifier and description.
- A setting matches on its label, identifier and description. When a setting matches, its module is listed with just the matching settings shown beneath it, without expanding the rest.
- If nothing matches: "Nothing matches "…"".
- Esc clears the search first. A second Esc closes the screen.
For example, shadow lists every module that has a Text shadow setting, and zoom key goes straight to the Zoom key.
Controls by setting type¶
| Type | Control | Notes |
|---|---|---|
| On or off | A switch | |
| Whole number, decimal number | A slider with the value and unit to its left | Click or drag. The value is clamped to the setting's range, and a decimal snaps to the setting's step. |
| Choice | The current option between < and > | The arrows step back and forward. A left click on the value steps forward, a right click steps back. |
| Colour | A colour square with the hex value to its left | Click to open a row of twelve swatches and a hex field. Type RRGGBB or AARRGGBB; the field turns red while the text is not valid. Enter leaves the field. Picking a swatch keeps the current transparency. |
| Key | A button with the key name, or "None" | Click it, and it reads "Press a key...". Press the key. Esc clears the binding. Middle and side mouse buttons can be captured too. |
Colours are stored as eight hex digits, alpha first: FFFFFFFF is opaque white, 80FFFFFF is half-transparent white.
Scrolling and the footer¶
The mouse wheel and the Up and Down keys scroll the list. A thin bar at the right edge shows the position.
The footer shows the description of the row or setting under the mouse. After an action it shows the result instead, in the accent colour ("Exported to xol/xol-settings.json", "Layout renamed"). With nothing to say it reads "Rebind this screen under Options > Controls > Xol".
General settings¶
| Setting | Type | Default | Description |
|---|---|---|---|
| Animations | On or off | On | Short fades in Xol screens and the keystrokes display. Turn off for no motion at all. |
General also carries two rows that are not ordinary settings:
| Row | What it does | Page |
|---|---|---|
| HUD layout | Switch between layouts; New, Duplicate, Rename, Delete | Layouts, export and import |
| Settings file | Export and Import | Layouts, export and import |
General cannot be switched off and touches nothing in the game. Multiplayer note: "Interface preferences only. Sends nothing."
Settings every HUD module has¶
Ten of the thirteen modules are movable HUD elements (all except Zoom, Custom crosshair and Chat appearance). Each of them has these three settings in addition to its own:
| Setting | Type | Default | Description |
|---|---|---|---|
| Background | On or off | On | Draw a translucent box behind the element. |
| Text shadow | On or off | On | Draw text with the vanilla drop shadow. |
| Text color | Colour | #FFFFFFFF |
Color of the element's text. |
Position and scale are not settings. They belong to the active layout and are changed in the HUD editor.
When settings are saved¶
When a Xol screen closes, and when you move between the settings screen and the HUD editor. Saving never interrupts the game: if the file cannot be written, the client carries on with the settings in memory. The file format is on Settings files.