Emblemtest

Plugin that allows for comprehensive re-theming of the main menu and loading screen.

This is a configuration heavy mod, please read the config file thoroughly!

Features

• Customize replacement logo and loading images
• Optional random selection
• Change main menu colors
• Backgrounds can be PNG image or MP4 video
• Text formatting on loading screen
• Hide or change border corner colors
• Version number formatting
• Comes packaged with example images
• More features to come

Useage for modpack curators

• Add this plugin as a dependancy to your manifest.json
• Create a BepInEx folder in your modpack zip file
• Add custom images to your pack like this: BepInEx/plugins/Emblem/Header123.png
• Add a config file the same way at: BepInEx/config/DarkBrewery.Emblem.cfg
• The config paths should look like: plugins/Author-ModName/Emblem/Header123.png
• More detailed instructions can be found in the Emblem Defaults folder

Image formats

• Only png is supported
• Color space should be set to sRGB to ensure color accuracy

Video formats

• Emblem can use both H.264 and H.265 encoded mp4 files for backgrounds
• Audio codec should be AAC
• Videos must be referenced by their filename myclip.mp4

Bugs / Suggestions

• Visit the release page on the official modding discord

If you have enjoyed this mod, please give it a thumbs up!

1.2.1

• Added new path conversion mechanism to help with confusing instructions!
• We now search for the plugins/*/Emblem/ folder that contains your files
• Custom Themes or ModPacks all need a 'BepInEx/plugins/Emblem' folder
• Configs use something like Myfolder/BackgroudFlyingDolphins.png and it will work
• Instructions and readme have been updated
• Moved instructions to plugin root for acessability
• Apologies for the convoluted treasure hunting
• Backwards compatible
• Updated config path defaults

1.2.0

Asset location changes

• Profile codes were attempting to move images and videos which exceeded the 20mb limit
• Emblem won't use the BepinEx/config folder anymore for media
• Image & video paths must now be relative to BepInEx/plugins
• Please PLEASE read new instructions at Darkbrewery-Emblem/Defaults/EmblemInstructions.md
• After following directions, if you still need assistance, check into the discord channel

Config updates

• Reorganized config options for my sanity, sorry folks but you will have to rebuild your cfg's
• Header logo has some new default settings
• Removed canvas recoloring config
• Removed loading text wrap config
• All config descriptions are less verbose

New config features

• Added transparency option for loading images
• Added scale option for loading images
• Added option to use different png's & mp4's as loading screen background
• Added option so mp4's can be picked randomly if listed paths are separated by |
• Added option so main and Loading logo paths can be left blank to use no image at all
• Added main & loading background color options instead of global canvas color
• Added experimental vignette to blend background images with background colors
• Added padding config for borders

Fixes

• Fixed loading images not respecting vertical y-offset config
• Fixed loading screen being zoomed slightly closer than main menu
• Fixed stretch loading image not properly overriding scale and offset
• Reset rectransform on more objects for overall layout consistency

Code changes

• Major code refactoring
• Moved background management to its own class
• Expanded the color parser helper to accept RGB and RGBA
• Some method names are now less verbose
• Changed up some default backgrounds
• Lots of small things I forgot to add to the changelog
• Configurator has been cleaned for readability
• Update Readme

1.1.6

• Fixed ultrawide backgrounds being squished
• Fixed mp4s not using master audio volume settings
• Adjusted png texture conversion
• Cleaned up some global constants
• Removed some default images and compressed logo
• Light code refactoring

1.1.5

• Fixed mp4 videos restarting when opening submenus
• Fixed the vanilla sticky menu item highlighting bug
• Enabled audio track playback from mp4's
• Backgrounds now persist within menus
• Added background layers for readability
• Renamed some new Emblem gameobjects

1.1.4

• Configs configs configs
• Added version number formatting, 4 new configs!
• Replaced center loadingtext config with a Y-offset config
• Edited some config texts
• Updated readme

1.1.3

• Fixed video pausing when entering menus
• Fixed borders hiding behind video layer
• Fixed menu colors not applying transparency alpha
• Added logs to moodsetter
• Simplified new GameObject names
• Cleaned up global constants, more specific

1.1.2

• Hotfix for videos blocking view of the loading screen

1.1.1

• Added option to use mp4 for video background instead of png
• Fixed flicker of menu colors on first load

1.1.0

• Diving into menu recoloring
• Added config options to change menu colors
• Sortof fixed glitchy menus by disabling animations and replacing with triggers
• Added delay helper for lethalconfig compatability
• Updated config tooltips

1.0.9

• Added config option to change the border coloring
• Refactored the border methods, both screens have the same placement now
• Logwarden has stopped all the loggers from arguing
• Moved pathfinder probe to it's own home, centralizing the helper
• Cleaned up some code and logs

1.0.8

• Replaced header and loading image centering with % Y offset
• Reset container elements to fix vanilla borked object spacing
• Fixed broken stretch loading image feature
• Adusted menu borders
• Improved UI element searching
• Updated readme

1.0.7

• Added ability to use multiple loading text messages and have 1 randomly chosen
• Added config entry for canvas recoloring on/off to keep this as modular as possible
• Refactored scenemanagement, imagereplacement, loadingtext, simplified code
• Created some helpers, reduced duplication
• Prefixes on logs to help diagnose future issues
• Removed unused baseclass, organized namespace
• Updated readme

1.0.6

• Preparing for more plugin complexity..
• Update log entries to be more clear, removed rendundant ones
• Reorganized code and cleaned up unecessary comments
• Refactored to use constants from Emblem namespace within classes
• Added a ColorParser class for improved code consistency

1.0.5

• Set custom background default to true so users see it working right away
• Added option to change color of canvas behind the background

1.0.4

• Updated docs
• Reworded config options for useability
• Image path configs are now relative to BepInEx folder
• Updated default paths
• Compressed included sample images
• Updated prefix method to fallback on any random png if the prefix isn't present at all before throwing an error
• Paths in logs now properly show BepInEx as path root

1.0.3

• Re-organized paths again, lets see how this goes
• Added prefix support
• Updated docs

1.0.2

• Since thunderstore is squishing folder paths, we will point to .pngs directly for now, updated defaults

1.0.1

• Fixed default paths
• Added a couple more generic background images

1.0.0

• Initial Release