Ever wanted an actual background?
This mod modifies the game to add a background GUI to most menus in the game.
The mod comes with an amazingly looking background made by Matthelzor!
Recommended UI mod
Since the mod changes the background, you may be interested in changing the menu's text color. HoloUI allows you to do so. You don't have to use the HUD part of the mod, you can easily turn it off. Get it here https://modworkshop.net/mod/12501
Making your own background
Making a simple background is easy:
- Navigate to the Assets directory that's located in the mod's folder.
- Create a new folder
- Place a png file named standard.png of the background you wish to add. Make sure it's 16:9!
Want to be a little more specific?
You can also create backgrounds for specific menus, simply create a file that is named as one of the menus below:
- standard - main menu / default fallback for all menus
- inventory - inventory screen
- blackmarket - blackmarket + some releated menus
- blackmarket_crafting - modify weapon GUI
- blackmarket_mask - masks preview
- blackmarket_item - other preview items
- blackmarket_customize - skin editor
- blackmarket_screenshot - screenshot on skin editor
- blackmarket_weapon_color
- blackmarket_armor
- crime_spree_lobby
- crew_management
- movie_theater
- blackmarket_all - shortcut to set a background to all blackmarket menus.
- lobby - lobby + some more menus
- safe - safe opening screen
- crimenet
- briefing - mission briefing before entering into blackscreen and into game
- blackscreen
- endscreen - end game screen(both win and
- loot - flip cards screen
- infamy_preview - Infamy menu
- character_customization
- lobby
- loading
Supported Extensions
- png - Recommended for static backgrounds
- movie/bik - Animated backgrounds
- texture/dds - Not recommended, but you can
- tga - Heavier than PNGs so I generally don't recommend
Have already a UI mod?
You can make a new folder named "menu_backgrounds" and put your background sets there! This is useful when you want to make a UI mod but not have to tell users to install the background separately.
You need a little more power?
You can create a config.json and there are 2 options there you can play with: overrides and fallback
Overrides
You can now add a single background for multiple unrelated menus without having to copy paste files.
{
"override": {
"loading": "blabla",
"safe": "blabla"
}
}
fallback
Allows you to set the default fallback background, the default is standard.
{
"fallback": "something"
}
You can also set it to false, to turn off fallback.
In the future I might expand on this system, if you want something implemented you can comment it and I might implement it (or make a pull request in the GitHub repo)
A word about effects
Effects are disabled in the main menu, this is simply done because they don't work well with the background. The background might seem simple, but the background is actually located in the world, so effects can ruin how it looks.
GitHub Repository
please help the game crash :
Application has crashed: C++ exception
mods/Menu Backgrounds/Hooks/MenuSceneManager.lua:71: attempt to index field '_background_ws' (a nil value)
SCRIPT STACK
original() lib/managers/menu/menuscenemanager.lua:770
update() @mods/base/req/core/Hooks.lua:288
original() lib/setups/setup.lua:887
update() @mods/base/req/core/Hooks.lua:288
update() lib/setups/menusetup.lua:358
update() @mods/base/lua/MenuSetup.lua:5
original() core/lib/setups/coresetup.lua:557
@mods/base/req/core/Hooks.lua:288
Callstack:
Current thread: Main
System information:
Application version : 1.122.102
CPU : Intel(R) Core(TM) i7-9700T CPU @ 2.00GHz (4 cores); SSE; SSE2; SSE3; SSSE3; SSE4.1; SSE4.2
DirectX : 12.0
GPU : Radeon (TM) 540X / aticfx32.dll[30.0.13023.4001]
Language : english
Memory : 8063MB 0KB
OS : 6.2.9200 () 0x300-0x1 (64 bits)
Physics : threaded
Renderer : DX9 threaded
Sound : Realtek Semiconductor Corp. (Speakers (Realtek(R) Audio))