> For the complete documentation index, see [llms.txt](https://arivia.rlib.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://arivia.rlib.io/v2.x/faq/material-wallpapers.md).

# Material Wallpapers

This addon comes with the ability to use materials for the entire wallpaper of the interface.

## ▸Enabling Material Wallpapers

* Open **`lua\arivia\sh\cfg\sh_cfg_bg.lua`**
* Edit the following settings:

{% tabs %}
{% tab title="lua\arivia\sh\cfg\sh\_cfg\_bg.lua" %}

```lua
cfg.bg.material.enabled     = true
cfg.bg.material.list        =
{
    'path/to/material_1.png',
    'path/to/material_2.png',
}
```

{% endtab %}
{% endtabs %}

The **path/to/material** will need to be edited to reflect the correct path to the materials you wish to use. Multiple materials are able to be set; which makes the interface select one at random. However, you may remove **line 5** in the example above and only have one material set.

You will need to ensure that your materials are available for the server and for each connecting player. This requires you to upload your materials to a **Steam Workshop collection**. This guide does not cover the process, however, tutorials are available online.

In order to create and upload a Steam Workshop collection; you will need to use a program such as **GMPU** (**Garry's Mod Publishing Utility**) which can be [**downloaded here**](https://github.com/alatnet/gmpu):

All materials MUST be added to a root folder labeled **materials:**

![](/files/-MUC4wQzW8-UqQQRPtC0)

After placing your images; return to **`lua\arivia\sh\cfg\sh_cfg_bg.lua`** and change the paths to reflect your steam workshop collection.

```lua
cfg.bg.material.enabled     = true
cfg.bg.material.list        =
{
    'background_1.png',
}
```

Since we put the image directly in the materials folder; no folder paths need specified. You also do not need to include **materials/** in the config path since it will search in that folder automatically.

Once the config is modified and you have uploaded your workshop collection; add the workshop to your server's collection and restart the server. After it has finished booting; connect.

####

## ▸Missing Materials

The main reason for materials not appearing as your wallpaper for this addon is due to one of the following:

**`[1]`** You have not created a workshop collection correctly, which includes putting the image(s) in a root **materials** folder.

**`[2]`** The workshop collection has not be added to the server's collection. This should be done the same way that you add all other content for your server or when subscribing to collections that you are adding to your server.

**`[3]`** A bad path has been given in the config file. Ensure that you spell the image name correctly, and include the extension on the end (.png, .jpg, etc). Properly write the path including subfolders if you have placed the images within a subfolder under the materials folder.

**`[4]`** The new workshop collection privacy / visibility settings are set to Hidden; and need changed to **Public** Every time a new workshop collection is created; GMPU automatically sets the collection to be hidden. You must find the workshop collection on steam's website, and select **Public**.

![](/files/-MUC7I-LiG7rg_ggdhSb)

####

## ▸Notes

**`[1]`** If you decide to use materials for your wallpaper; it is HIGHLY recommended that you disable **static** and **live** wallpapers; otherwise both will show and potentially cause performance issues. You can disable them by opening **lua\arivia\sh\cfg\sh\_cfg\_bg.lua** and changing the following settings:

{% tabs %}
{% tab title="lua\arivia\sh\cfg\sh\_cfg\_bg.lua" %}

```lua
cfg.bg.static.enabled           = false
cfg.bg.live.enabled             = false
```

{% endtab %}
{% endtabs %}