◾Material Wallpapers

Solutions for missing wallpaper materials

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:

lua\arivia\sh\cfg\sh_cfg_bg.lua

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

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:

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

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

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.

▸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:

lua\arivia\sh\cfg\sh_cfg_bg.lua

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