Reference
Theme colours
The Tailor's swatch book, bound in nine groups. Each page of it dresses one kind of surface.
What it is
The theme is a list of settings. Each one paints one part of one kind of surface: a panel's background, a button's text, a tab's colour when selected. The table below sorts them into nine groups. The Look & feel panel in Edit Mode edits 19 of the colours. The full theme editor reaches the rest.
Settings
Vespera sets none of these: its theme is empty, so the game draws the built-in look. The editor default is the value the full theme editor fills in before you change anything. A game with no theme at all draws the game's built-in look, which matches it except in three places: the panel border is a thin line in the theme's secondary colour, the icon outline is a paler yellow (#FFED9B), and the screen dimmer does not show at all, so a panel opens over a fully visible scene. Where a setting is in Look & feel, the table gives its label there.
| Group | Setting | Where | Editor default |
|---|---|---|---|
| Panels | Panel background | Look & feel | #172D31 |
| Panels | Panel text | Look & feel | #FFFFFF |
| Panels | Panel border | Full editor | solid 1px #B0741A |
| Cards | Card background | Look & feel | #084E5A, partly see-through |
| Cards | Card text | Look & feel | #FFFFFF |
| Cards | Card border | Full editor | solid 0.5px #0A6E80, partly see-through |
| Popups | Popup background | Look & feel | very dark teal, hex 112023 |
| Popups | Popup text | Look & feel | #FFFFFF |
| Popups | Popup border | Full editor | solid 0.5px #0A6E80, partly see-through |
| Menus | Menu background | Look & feel | near-black teal, hex 021619, almost solid |
| Menus | Menu text | Look & feel | #FFFFFF |
| Menus | Menu border | Full editor | solid 1px #F5F591 |
| Buttons | Button background | Look & feel | #084E5A |
| Buttons | Button text | Look & feel | #FFFFFF |
| Buttons | Button hover background | Full editor | #065B6A |
| Buttons | Button border | Full editor | solid 2px #C75000 |
| Buttons | Icon button background | Look & feel | #C75000 |
| Buttons | Icon button symbol | Look & feel | #FFFFFF |
| Tabs | Tab background | Look & feel | dark grey, hex 373737 |
| Tabs | Tab text | Look & feel | #FFFFFF |
| Tabs | Selected tab | Look & feel | grey, hex 494949 |
| Screen labels | Label background | Look & feel | #0A383B, mostly solid |
| Screen labels | Label text | Look & feel | #FFFFFF |
| Screen labels | Label border | Full editor | solid 0.5px in the theme's secondary colour |
| Screen labels | Icon outline | Look & feel | #F5F591 |
| Screen labels | Icon outline thickness | Full editor | 0px |
| Screen labels | Shadow under icons | Full editor | black, about 65 percent |
| Shape and screen | Corner rounding | Full editor | 20px |
| Shape and screen | Screen dimmer | Look & feel | #000000CC |
| Hover effects | Scene hover and HUD hover | Full editor | off |
| Hover effects | HUD hover colour | Full editor | not set |
Setting it up
- Open the game menu and choose Edit this Game. Pick HUD.
- In Add to the screen, use the palette button titled Look & feel. On the Colours tab, pick a swatch for any setting marked in the table as Look & feel. The game changes at once.
- For everything else, use the link Open the full theme editor at the bottom of the panel. The full editor lists each setting under its technical name. A border has a text box for its style and width, and a Color control for its colour.
- Choose Save Variables to keep your changes, or Discard Changes to drop them. The sections Scene Hover Effect and HUD Hover Effect have their own save button.
In Vespera
In Vespera: Parchment and ink, tried and put back Play it
Vespera once tried these as a parchment-and-ink theme:
- Backgrounds: panel #F3E9D2, card #FBF4E2, popup #F7EDD5, menu #EFE2C4, tab #E4D3AE, label #F3E9D2.
- Text and outline: ink #2B1E12.
- Buttons: gold #E8B923 for the button and the selected tab, brown #6B4A2B for the round icon buttons.
- Borders: solid 1px #8B6B47 on panels, cards and popups.
- Screen dimmer: #2B1E12CC.
Vespera now sets none of them. The menus read less clearly, so it went back to the engine's own look.
Good to know
- The screen dimmer keeps its see-through part. Pick a new colour in Look & feel and the amount stays as it was.
- Saving in the full editor writes every setting it lists. That includes ones you did not touch.
- Check contrast. Text must still read against its background.
Under the hood
- A game's theme is laid over the engine's built-in one. A setting you leave out keeps the built-in value.
- The built-in values are the ones listed here as the editor default. They are a dark teal look, not a neutral one.
- A border setting is a style, a width and a colour, for example a solid line one pixel wide. Keep all three, or the border is dropped.
- A hover effect has two parts, a size change and a coloured outline, and the two work independently. Both are off until you set them. The scene hover effect acts on components drawn in a scene. The HUD hover effect acts on HUD buttons, counters, labels and bars. It does not touch the hit area, and it does not act on open panels.
- The corner rounding is used by panels, buttons, cards, menus and popups alike, so changing it touches most of the screen.