(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!
Mod Principale da scaricare prima della mod di traduzione in italiano
Permissions and credits
Credits and distribution permission
Other user's assetsAll the assets in this file belong to the author, or are from free-to-use modder's resources
Upload permissionYou can upload this file to other sites but you must credit me as the creator of the file
Modification permissionYou are allowed to modify my files and release bug fixes or improve on the features so long as you credit me as the original creator
Conversion permissionYou can convert this file to work with other games as long as you credit me as the creator of the file
Asset use permissionYou are allowed to use the assets in this file without permission as long as you credit me
Asset use permission in mods/files that are being soldYou are not allowed to use assets from this file in any mods/files that are being sold, for money, on Steam Workshop or other platforms
Asset use permission in mods/files that earn donation pointsYou are allowed to earn Donation Points for your mods if they use my assets
Author notes
This author has not provided any additional notes regarding file permissions
File credits
https://icons8.com/ for the star icon
Donation Points system
Please log in to find out whether this mod is receiving Donation Points
Changes effect manager to account for MEI and Effect Resources with the new indexing approach
Version 1.1.1
Adds missing Armor Type locas
Adds TRUE_INVISIBILITY pre-packaged effect
Version 1.1.0
Filters Effects to only show ones that are used in the relevant fields on existing statuses - this filters out spell effects, but should make it a lot easier to find effects that will actually work. Let me know if you find this too restricting
Changes the pre-packaged effect behavior to only load in when the "Restore Pre-Packaged Effects" button is clicked in the Effects slot context menu - this allows you to delete the prepackaged effects if you don't want them
Adds missing StatusEffect loca
Adds "Mug" as a prepackaged effect (works surprisingly well on weapons)
Version 1.0.1
Adds full Localization support (let me know if i missed anything!)
Fixes dependency validation collapsible headers being coupled to outfit headers in the preset manager
Version 1.0.0
Reworks Pickers to have a super sick Filter section
Enables cross-slot transmogging
SE 23 (Patch 8) only - fancifies the equipment picker so it automagically determines the (roughly) correct amount of entries per row to maximize real estate usage
Changes itemPreview to transmog equipment (not weapons, those are still just equipped to the char)
Only blocks transmogs for polymorphed characters on level load
Fixes transmog error handling causing errors that can't be handled
Version 0.9.0
Adds Mod Compatibility Report
Updates Indexing approach to account for templates that share the same stats
Updates Indexing to use OriginalModId
Updates Previewing Functionality to unequip items before destroying them, which should fix sticky statuses
Version 0.8.1
Fix runtime error when hiding the appearance of a slot
Version 0.8.0
Adds more safeguards when determining party criteria, to account for things like summons
Changes the template used for hiding visuals from a Pike to a gold ring (the pike was unintentional) - you won't see a random pike anymore, but you will see a gold ring on the ground in the level up screen
Enhance dependency recording to prioritize originalModId if available - should be more accurate
Adds robust dependency checks, preventing any fatal errors when items in a preset are not in the game, and alerting the player of this on startup for active presets and in the Preset Manager
Adds ability to add custom dependencies to a preset, specifying which resource UUIDs are packaged with them
Completely overhauls the Preset Manager, moving create preset button to menu bar and adding the ability to swap between outfit views
Adds ability to back up presets in the save files, restoring them on load if the preset is missing from the local config
Adds ability to export presets to a local file, which can be manually shared with and imported by users or packaged with mods to be automatically read and made available to users
Version 0.7.1
Changes shapeshifting logic to only execute on characters that are affected by a polymorph status that is not also a disguise status (so pretty much just wildshape)
Version 0.7.0
Fixes item previewing spawning and keeping items inappropriately
Fixes dual wielding transmogs
Fixes one/two-hand items being moved into the offhand when some transmogs are applied
Fixes BodyType criteria math (if you have an outfit using this, then you'll probably need to copy your outfit to the correct bodyType)
Skips transmogging on characters that are shapeshifted (e.g. wildshape)
Adds Status Effects present on items to their tooltips (limited - doesn't work for items that use nested statuses for this right now)
Adds ability to duplicate presets
Adds setting to disable the spawning of placeholder items
Enhance error logging for items that spawn in without an associated stat
Version 0.6.1
Fixed Preset Manager forms
Version 0.6.0
Adds a new context menu to item and dye slots when clicking on them (use the new settings button at the top of the page to require holding Left Shift)
Removes reset button, moves option to context menu for better granularity
Adds a per-character passive toggle to automatically swap between armor and camp clothes when entering/exiting combat
Adds ability to hide non-weapon equipment visuals via context menu
Adds ability to create and add VFX-only statuses to equipment - comes with a few pre-packaged (these will reappear on reload if deleted - will optimize in the future)
Massively improves performance on the initial index (when launching an equipment/dye picker)
Fixes dyes using DyeRare and DyeVeryRare object categories not showing up
Version 0.5.0
Overhauls item indexing for searches - now equipment/dyes with the same names will show up
Defers item indexing initialization until an equipment/dye picker is opened for the first time - this will cause slight, one-time lag depending on the number of items in your game
Adds warning logs when processing stats that have invalid rootTemplates during item indexing
Adds safeguards + logs against transmogging equipped unique items(like The Blood Of Lathander), which can't be reliably recreated and are therefore incompatible with current transmog implementation
Adds workaround and warning log when transmogging items whose rootTemplate don't point at the stat that points to the same rootTemplate
Add ability to edit existing preset info
Version 0.4.0
Clean up preset manager functionality - add a deactivate button, close window when activating a preset, focus newly created preset
Fixes duplicate gear being spawned when swapping presets
Changes "Help" to "Instructions" and clarifies that presets manage the whole party, and you can only have on active at a time
Fixes NSFW flag displaying the opposite value
Version 0.3.0
Adds ability to delete outfits from the preset manager and Character Criteria Combination viewer
Adds ability to clone an existing outfit within the same preset into the one actively being configured (completely overwriting it)
Version 0.2.0
Enables camp clothing <==> armor transmogging (body to body, boots to boots), seamlessly integrated with the preview
Fixes dye preview not reverting the dye on items after completing the preview without choosing a dye
Adds minor text informing users the colors in the dye picker are not editable
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
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
@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