Theme conventions¶

All built-in themes follow a few simple conventions: themes prefixed with [W] are designed for world maps, while the ones starting with [WD] are meant for mixed world & dungeon maps. Unprefixed themes are best suited for regular dungeons.

The differences between them basically come down to the selection of floor colours: world map themes feature colours suited to represent different types of terrain, while in regular themes they are just different accent colours. Colours are generally consistent across themes belonging to the same type, e.g. in regular dungeon themes colour #2 is always a reddish colour, #3 a bright red/orange, #4 a yellowish one, and so on. This makes it a bit easier to switch themes in the middle of a mapping session. A few themes even include variations that don’t conform to these conventions (e.g. Darkest Heart Alt).

Theme editor¶

While it is certainly possible to edit or create theme files only with a text editor, Gridmonger features a fully-fledged theme editor that makes theme management a breeze.

You can toggle the theme editor side panel with the F12 key in Edit Mode. Note that it is not possible to toggle the editor while a dialog is open, or in any other modes (e.g. Select Mode or Paste Preview Mode). You can, however, enter any of these modes while the theme editor is already open, which makes editing aspects of the themes related to these modes a lot easier.

The theme editor in action

At the top, there is a drop-down indicating the current theme. You can change this any time, except when a dialog is open. Naturally, if you try to switch to a different theme and the current one has unsaved changes, the program will display a warning dialog.

To the right of the drop-down are two state indicators:

• U – User theme

• O – Overridden built-in theme

Below the drop-down are four action buttons — let’s look at what these do first, which will also clarify the purpose of the indicators:

Save

Saves any changes you’ve made to the current theme.

Built-in themes can never be changed, so if this is a built-in theme (U and O are inactive), a new user theme will be created with the same name, and therefore the U indicator will become active. This user theme overrides (or shadows) the built-in theme, making the built-in theme unavailable, therefore the O indicator will also become active.

Overriding a built-in theme is useful when you only want to make a few tweaks to it; your map files will still reference the name of the built-in theme, but the program will use the overridden user theme instead.

Copy

Creates a copy of an existing theme under a different name.

This is the action to use if you don’t want to override a built-in theme (e.g. you want to create a new tweaked version under a different name), or if you want to design your own theme: just pick a theme you want to use as your starting point and hit Copy.

You’ll be asked for a new theme name, and you’ll get a warning if the name you’ve chosen would override (shadow) that of an existing built-in theme, or would overwrite another user theme. Naturally, you can make copies of both built-in and user themes.

Rename

Renames a user theme.

Similarly to Copy, you’ll be asked for a new name, and you’ll get warnings about any possible naming conflicts. This button is disabled for built-in themes.

Delete

Deletes a user theme.

You can only delete user themes; for built-in themes, this button is disabled.

The rest of the editor should be pretty straightforward. The best way to get familiar with theming is to experiment! There are, however, a few things that are bit harder to figure out, so let’s say a few words about them:

• Hold Ctrl while clicking on the little triangle before a section’s name to open all its child sections as well.

• Hold Shift for finer adjustments when changing value sliders by click-dragging, and Shift+Alt for super-fine adjustments.

• When adjusting a value slider by click-dragging, you can right-click before releasing the left mouse button to cancel the change.

• To copy a colour, hover over the source colour widget, press Ctrl+C, then hover over the destination and press Ctrl+V.

• To use a background image, first copy the image to the User Themes/Images folder, then enter the filename (without the path part) in the Window / Background Image text field, and press the Reload button.

• To display the splash image for theming purposes, tick the Show Splash checkbox under User Interface / Splash Image, then untick it when you’re done.