File information

Last updated

Original upload

Created by

Osiris

Uploaded by

osirisofinternet

Virus scan

Safe to use

About this mod

(Patch 8 Compatible) - The Armory is your one-stop shop for Vanity Outfit management. Define outfits in a custom, MCM-integrated IMGUI interface that automatically transmogs and dyes equipped items, and unmogs/undyes them when unequipped. Easily share presets with friends and via mods!

Requirements
Permissions and credits
Translations
  • Italian
Mirrors
Changelogs
Donations
Welcome to The Armory!

Github

Now Out Of Beta!

Credits for main image
Spoiler:  
Show




You can check the active roadmap at https://github.com/users/osirisOfGit/projects/2/views/1 - please check this before submitting feature requests/bug reports. Priorities are subject to change at any time (feel free to suggest changing the priority on items).


The Vanity

Featuring a completely custom MCM-integrated IMGUI interface, this section of the Armory allows you create Presets containing literally thousands of possible outfits that are automatically assigned to your party based on the configured criteria! 

Small (heavily compressed) Demo (some waiting was cut out - the transmog process will take a bit longer if you're doing your whole party at once with a lot of gear, since it's a lot of synchronous events that the game has to process. After the initial load it's much more optimized - the axe mog at the end is real time). A higher quality short tutorial can be found at https://imgur.com/4VkkMqU. I'll make a complete video once out of beta

Shoutout to Screen2Gif

Step By Step Instructions
Spoiler:  
Show

Shoutout to JasperTheFae for this!

  • Press Esc. while in a save
  • Click "Mod Configuration Menu" near the middle
  • New pop-out window Click "Armory" on the left column, it's the second option
  • Click on the "Vanity" section of the new drop down to the right
  • Click "Preset Manager" just below the vanity drop down
  • New pop-out window Click "Create a New Preset"
  • New pop-out window Enter whatever name you want the preset to be called (I recommend labeling them after playthrough character names/classes so you can switch between them more easily)
  • Click "Submit" at the bottom of the pop out
  • Click "Activate (Save After)" to the right of the drop down
  • Quicksave by hitting F5 or whatever your quicksave keybind is
  • Click "Select Character Criteria for Outfit" on the MCM (Mod Configuration Menu)


Current Feature list includes:
Presets are now shareable! Export your presets via the Preset Manager to send them to friends or package into mods!

  • Export Presets to a local file, which can be shared with and imported by friends or packaged with mods, which will be automatically read in and made available to users in their own section of the Preset Manager (which is as easy as this!)!
  • Equipped gear will be automatically transmogged and/or dyed, and unequipped gear will be reverted. (Unless the item is removed from inventory, such as dropped/thrown - not sure what the preferred behavior is around that yet)
  • IMGUI gear and dye browser, removing the need for vanity-exclusive mods to mess with Treasure Tables
  • Instant hover previews for gear and one-click previews for dyes
  • Favorite gear and dyes, making them easily accessible
  • Browse gear + dye using super powerful filters (there isn't a filter to determine if a piece of armor is dyeable, that was too complicated/problematic unfortunately)
  • Define vanity items per weapon slot (including off-hands) and weapon type, ensuring animations line up with your currently equipped weapon
  • Hide the visuals of equipped items (not weapons/shields)
  • Create and attach VFX statuses to equipment (i.e. set your weapons on fire and give your hat a golden shimmer, without any functional impact)
  • Spawns basic items for empty slots (except weapons) so you can get your full outfit right off the bat
  • Records mod dependencies (and allows users to add custom ones) and saves them to the configuration file, displaying them in the UI and alerting users when any are missing

Important Notes
  • Ensure you're running with DX11, NOT Vulkan - Vulkan users have experienced consistent crashes in inconsistent places
  • Save and reload after finalizing an outfit, so the Transmog process can fully complete (e.g. armor type won't reflect properly or weapons may have double the damage dice until a reload)
  • If anything unexpected happens when creating an outfit (like you receiving an item you shouldn't have), you can safely load a previous save (reactivating your preset if it wasn't active for that save) - the underlying config is updated on every change, so your work will persist across saves and campaigns.
  • When reporting bugs, please detail the order of operations to recreate (if you can make a gif/video of it, that would be most ideal, but not required.) If you can recreate it, turn the log level up to Trace in MCM, perform the steps, then give me the log file and your config.json from %localappdata%\Larian Studios\Baldur's Gate 3\Script Extender\Armory 
  • I'm 100% open to and very much want feedback on any aspect of this, especially accessibility + design aspects. 

(In)Compatibilities
  • If using Transmog Enhanced, un-transmog your equipped items before creating an outfit, otherwise Vanity will transmog the wrong item
  • EasyDye can be used in conjunction, just don't use the Dye aspects of Vanity
  • Manaflare - Magic Aura Weapons is incompatible - you can still use it, but transmogging your weapons while having one of theirs causes the game to freak out and either break the manaflare weapon or start spawning infinite copies of your weapons
  • REL - SE Plugin now has an optional download for compatibility with Armory - try it out, and huge shoutout to mjthefirst for their patience and cooperation with me on this!
  • Full Custom Companions causes weirdness with the Origin/Hireling criteria columns - it's been reported that the Custom option no longer exists, and you have to create an outfit for your Tav through other criteria. Tracker has been created to investigate and accomodate down the line


Credits

  • Norbyte for Script Extender - I genuinely can't overstate how well SE is made and how much heavy lifting it does for this mod (and all my other ones). It's a genuine pleasure to work with, and I can't appreciate it enough
  • ShinyHobo for https://github.com/ShinyHobo/BG3-Modders-Multitool - an indispensable tool i've been using since the start!
  • GhostBoats and khbsd for https://marketplace.visualstudio.com/items?itemName=ghostboats.bg3-mod-helper - another indispensable tool
  • @Volitio for MCM, and both they and @Aahz07 for their IMGUI mods - they were heavily referenced for this and my other projects, so I 100% could not have made this without their work
  • @Eralyne and @ImWayden for Transmog Enhanced - it was heavily referenced when making this Transmog implementation, and the process has given me new appreciation for how difficult the initial development must have been!
  • @Fararagi for the logging code + some misc utility stuff - they've been propping up all my mods since the start, so really appreciate it
  • DIQ server for their support (Crow especially for the algorithm help) and testing (Kuder especially, for this and my other mods), and of course DIQ creator @BaldursGoonsack for his continuous support and feeding me ideas I can really sink my teeth into

My Other Mods

Grit and Glory - Injuries Exhaustion and Madness - MCM
Sensible Ambushing - Stealth Combat Overhaul
Attunement (And Rarity Limits)
Automatic Inventory Manager (AIM)
Owlbear Cub Permanent Aggression Fix on Honor Ruleset
Experience Spider - Report Generator