> For the complete documentation index, see [llms.txt](https://hudhive.rlib.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hudhive.rlib.io/configuration/themes.md).

# Themes

Managing themes and adjusting settings

## <mark style="color:red;">▸ Location</mark>

You can access the theme files for this addon by going to

```
lua\modules\hudhive\themes\
```

## <mark style="color:red;">▸ Modifying Colors</mark> <a href="#modifying-colors" id="modifying-colors"></a>

Colors and various other settings are stored in <mark style="color:red;">**convars**</mark> when the player connects to the server.

If you wish to modify a theme and change the colors; you will need to open one of the theme files by going to the [<mark style="color:orange;">**location**</mark> ](#location)provided above.

Find the name of the setting you wish to modify, an example is provided below:

{% code title="lua\modules\hudhive\themes\cl\_frost.lua" lineNumbers="true" %}

```lua
{
    sort            = 450,
    b_visible       = true,
    id              = 'hudhive_rp_clr_utime_val_txt',
    name            = 'Utime label Color',
    desc            = 'Color for utime value text',
    class           = 'hexa',
    values          = { hex = 'FFFFFF', alpha = 255 },
},
```

{% endcode %}

The above example is what defines the text color for **utime**.&#x20;

You can change the color by modifying the hex value specified as \
&#x20;                     `{ hex = 'FFFFFF', alpha = 255 }`

Once you make your desired change, you will need to connect to your server as a player. The old color should still be cached as a convar and the change will not appear until you open your player console *( by pressing <mark style="color:orange;">**\~**</mark> )* and type the command:

```
hudhive.debug.th.reset
```

Once entering the above command, all old convars will be overwritten with the values stored in the theme file, and the new change should appear on your hud.

{% hint style="warning" %}
To apply color changes, or edit values for a theme; you <mark style="color:red;">**MUST**</mark> enter the command above in your console. Simply changing from one theme to another will not force the new changes to take affect.
{% endhint %}

## <mark style="color:red;">▸ Changing Themes</mark>

Players are given the ability to change themes on-the-fly. You can do this one of three ways:

1. Clicking the <img src="https://2289536656-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZp3jUdXDibQiEae44O8V%2Fuploads%2F52YSDdbKueAII9Et7oJC%2Fico_settings.png?alt=media&amp;token=e2f10d4d-fccd-40a6-b2ff-5c2e3fe9b2b3" alt="" data-size="line"> located on the hud itself.
2. Open player chat and type the command <mark style="color:orange;">`!themes`</mark>
3. Open the player console [*( press <mark style="color:red;">`~`</mark> )*](#user-content-fn-1)[^1] and type <mark style="color:orange;">`hud.themes`</mark>

## <mark style="color:red;">▸ Default Theme</mark>

The Frost theme is the default theme.

You can modify which theme is the default for new players.

Open <mark style="color:orange;">`lua\modules\hudhive\cfg\sh_2_themes.lua`</mark> and modify the setting:

{% code title="lua\modules\hudhive\cfg\sh\_2\_themes.lua" overflow="wrap" %}

```lua
cfg.themes.default          = 'frost'
```

{% endcode %}

You must choose a valid theme name to become the default. If you do not put in a valid name, the default theme will not change.

{% hint style="info" %}
Changing the default theme will only take affect on NEW players who have not yet connected to your server.

All existing players will continue to use the theme they had prior to the change.
{% endhint %}

## <mark style="color:red;">▸ Forcing Theme</mark>

You can also force which theme is used by all players.

Open <mark style="color:orange;">`lua\modules\hudhive\cfg\sh_2_themes.lua`</mark> and modify the setting:

{% code title="lua\modules\hudhive\cfg\sh\_2\_themes.lua" overflow="wrap" %}

```lua
cfg.themes.force_theme      = true
```

{% endcode %}

By setting the value above to <mark style="color:orange;">`true`</mark>; all players connecting to the server will be forced to use the default theme.

[^1]: If the player console does not open by pressing \~  then check your gmod settings and keybinds.