About this mod
Easily dye equipment visuals with an SE-powered in-game UI (opens with the 'F' key by default). Quickly preview any game dye on your equipment with a couple clicks, and freely customize those colors.
- Requirements
- Permissions and credits
- Changelogs
- Donations
- Convenient dye-preview tab: Scroll through all in-game dyes, included modded ones, and apply them to your equipped items.
- Color Harmony tab: Generate new color palettes quickly and easily with reactive color pickers. Current harmonies include: Monochromatic, Analogous, Complementary, Split-Complementary, Triadic-mixing, and Golden Ratio.
- User presets: Create your own color presets and save them locally. Especially useful for dye makers since the json format should be easy to plug into a dye mod to share your presets with others.
- Simple Interface: Easily drag/drop colors, along with color picker previews for precise customization
- Dockable dye window: Quickly pop up the dye menu with the 'F' key (configurable in Settings menu) -> Change your colors on the fly -> Save All -> Everyone else sees your fresh new look.
Known issues
- Important: The Paperdoll in the Inventory screen doesn't update color changes according to the Live Preview, only when you finalize changes. It's a separate entity from your real character, and I haven't carried over the changes yet. It's on the to-do list.
Roadmap
- Add import process from FocusDyes: Allow importing dyes previously crafted in FocusDyes
- Toggleable autosave colors: When switching items/characters, allow for automatically saving/discarding changes automatically
- Transmog compatibility: Transmog Enhanced seems to work fine on things I've tried so far, but other transmog solutions may not behave weirdly.
- Dyeing non-equipment visuals: Technically there's
nothingseveral weird things stopping me from exposing the rest of your character visuals for EasyDyeing, so theoretically you could probably change colors on even more things... but I'll have to look into it more, and it's definitely on the roadmap. - Exposing other non-color parameters: There are some other things I may decide to make available that aren't colors. There are gloss/metallic/glow settings I may add, along with some scalar parameters visual nerds might have fun with 👍
Multiplayer:
- Works in multiplayer; as always make sure everyone has the exact same mods, mod versions, and load order.
Requires:
- Script Extender (v20+) - What makes everything possible, especially the shiny new IMGUI UI in-game
- AahzLib (v1.1+) - My code library, sits there doing nothing until I use it. Harmless and easily removable with this mod later if needed. I separated it out because I’ll be reusing it for several future mods.
- Mod Configuration Menu (v1.18+) - A central place to manage mods in-game? Why wouldn’t you have it
Installation:
- Install using BG3MM (BG3 Mod Manager), with MCM higher in your load order (IMPORTANT). example order:
- Mod Configuration Menu
- AahzLib
- EasyDye
Uninstallation:
- Probably safe to disable/uninstall at any point, although you WILL LOSE YOUR COLORS and you'll likely want to use Mod Uninstaller to uninstall things.
Special thanks to
- Norbyte, a god among puny humans, for adding so many new features so rapidly, while still somehow being accessible on Discord for questions. He had SE completely patch 7 ready, added all the features we asked for, and is now demanding we give him more things to add to SE. Please send help.
- Focus, the creator of FocusDyes and FocusCore, both large portions of what makes all of this EasyDye stuff work. His code is undoubtedly the cleanest in this mess I've come up with to get everything working.
- Volitio, for continuing to release a staggering amount of quality mods we can all look to for examples
- Fararagi, for keeping Sensha in line
- Muffin, Satan, Skiz, HippoOo, Simo and the rest of the BG3 Modding Community Discord for being great to bounce code off of