Added 540 new armor pieces using existing meshes from NPC-only style data (some parts are already used in playable items, many aren't):
- 263 tops
- 142 pants
- 81 helms
- 52 mantles
- 2 backpacks (equippable as mantles, both increase weight limit by 20)
For reference, there's 309 unique equippable items in the base game, so this makes it a grand total of 849 items. The new items are distributed to Philbert, Ibrahim, and all the wandering merchant shops.
Requires Content Editor with items and shops enabled, as these are added as non-replacer items to several shops.
== Installation ==
Install using Fluffy mod manager or manually extract the reframework and natives files in the matching folder structure.
== Detailed description ==
All the added items are taken from the basegame NPC files, just made equippable by the player. These items did not ship with actual names, I have gone through all of them and given them icons, names, descriptions and stats that I thought made sense. The stats are semi-randomized and roughly balanced to base game standards according to appearance. Many of the more generic items also have no descriptions.
Most of the common items have been distributed to wandering merchant shops and a couple of rare ones to Philbert, so you would need to explore a bit to find everything. For the important NPC outfits, their items can be found either by killing them or by maxing out their affinity; if the NPC's affinity is already maxed, the items will be given the next time their affinity is increased. If you already have several maxed ones, you'll probably get a lot of items soon after loading in. Untouchable NPCs like Pathfinder or Darragh's gear can be acquired in Ibrahim's shop in Unmoored World.
Some of the items only have meshes for one gender - for these, I've just duplicated the data for the other gender, so there will be some amounts of clipping (generally, for M->F, breasts won't be quite there and for F->M, the tops tend to be borderline unusable). Setting up a mask for the M->F cases was easy enough with just one shared mask texture to hide the breasts so I've gone ahead and done that, the male variants however are too varied and not worth it for me personally. I have not and probably will not do any changes of the actual meshes used by these items.
The mod also ships with a bunch of the Lua tooling I used to make this mod, can be adapted if needed for other people as well as in general for custom item management. The item tools are disabled by default to make the temptation of skipping the immersive item acquisition features just a tad bit more inconvenient, install the additional optional Item Tools file if you don't care about that or want to modify anything. Bear in mind it's not fully optimized for user friendliness and might need some lua editing to adjust some things, as it was intended as more of a dev tool than anything, just thought it might also be useful to someone else. I might integrate some of the features into content editor itself if there's demand.
Full item list and acquisition methods: https://docs.google.com/spreadsheets/d/17QEo1wHi8VW6M5vyr3foh91ke49MaKh3YeurzW0KACs
You can cross-reference the icons grid from the mod images, the numbering goes in sequence, left to right, top to bottom, so first row would be IDs 1-10, then 11-20, etc. You can use content editor's NPC editor or the NPC Finder mod to warp to them if you can't find them.
All important NPC outfits can be acquired by either killing them or maxing out their affinity, with additional options for some. Affinity for some NPCs is locked behind quest completion, so keep that in mind. I haven't tested all of them yet so there's a chance that some of them are currently unobtainable aside from adding them through the dev tools, please let me know if you think you find such a case. There's also an optional file that immediately unlocks all of them in Ibrahim's shop without needing to do anything extra.
Important NPC item spoilers:
Spoiler:
Show
- Wilhelmina - Ibrahim's shop after completing "Every Rose Has Its Thorn"
- Allard - Ibrahim's shop after completing "Every Rose Has Its Thorn"
- Sara - Ibrahim's shop after completing "A New Godsway"
- Brokkr - Ibrahim's shop after completing "A New Godsway"
- Disa - Ibrahim's shop fter completing "The Regentkin's Resolve"
- Sven - Ibrahim's shop fter completing "The Regentkin's Resolve"
- Nadinia - Ibrahim's shop after completing "Shadowed Prayers"
- Menella - Ibrahim's shop after completing "Shadowed Prayers"
- Tantra - Ibrahim's shop after completing "Shadowed Prayers"
In Ibrahim's shop after completing "Dreams Apart" (UW):
- Ambrosius
- Pathfinder
- Darragh
- Rothais
- Phaesus
- Dragonforged
- Rivage Elder
- Raghnall
No special conditions aside from kill/affinity:
- Ulrika
- Beren
- Sigurd
- Eino
- Eini
- Myrddin
- Cliodhna
- Lamond
- Lennart
- Srail
- Luz
- Ursula
- Raghnall
- Sebastian / Daphne
- Hugo
- Lanzo
- Glyndwr
- Doireann
- Taliesin
- Brant
- Trysha
== Mod image depicted items ==
Ball Dress, Concierge Jacket, Courtly Breeches (Green), Purple Kneesocks
Sven's Crown, Dragon-Scarred Armor, Purple Kneesocks
Grandmaster's Hood, Chamberlain's Opulent Robe, Summer Skirt, Sash
Magick Archer's Tiara, Blue Sunbright Top, Leg Bandages, Wanderer's Cloak
Summer Veil, Summer Top, Purple Panties
== Pawn sharing ==
Pawns equipped with these items should by default still be accessible online, but any custom items will be unequipped.
To make these outfits properly shareable online, both parties need to have the Pawn Share Setting mod installed. If only the player wearing these armors uses Pawn Share Setting, pawn should still be visible by pawn ID search, but won't be able to be summoned.
Alternatively, you can use that mod's online set feature to upload your pawn with normal basegame items instead which will make the pawn behave
as usual for non-modded players.
== Workflow ==
An outline of the workflow I used to build this, for anyone insane enough to attempt large item lists like this, or if the devs add new content and I'm not feeling motivated to repeat any of this. Some familiarity with code helps.
Spoiler:
Show
1. collect a list of all styles that should be added - content editor>data dumps>dump enums>find all the TopsStyleNo, PantsStyleNo, HelmStyleNo, MantleStyleNo ... in this case I took all the enums that didn't have item names, removed all the rest
2.1. prepare a base item for every equip category that will be added in - content editor>create an entry>copy the single entity json from the data bundle into a separate file
2.2. duplicate that json and replace the Name with the style number for the corresponding style
2.3. generate IDs for the new entities via `for i = 54123, 54222 do print(i) end` and copy it over as well
2.4. vscode's multiline edit makes these steps easier by making every item JSON one per line, could also be fully scripted instead
3.1. lua - modify the npc_outfits lua file: define the itemIdRanges with all the new items, set the bundle name and tex file variables
3.2. ingame UI - use the give items buttons (need to repeat multiple times cause there's an inventory item count limit)
4.1. go through all the items one by one and decide on a name for them in content editor
4.2. any items that are invisible are probably missing the style settings for the current gender - open the linked style in a new window and clone to other gender, see if any meshes have a matching gender mesh
4.3. see if there's any clipping with any of the meshes, prepare a furmask texture and pfb for those
5. run "Autoassign icons"; this will automatically set the icon file and rects
6.1. ingame - use the tools to give yourself all the items (need to repeat multiple times cause there's an item count limit)
6.2. go through all the items one by one and screenshot them for icons (Icon Helper mod and ShareX), paste into an image editor and put it into the icons grid
7. convert the image to .dds (BC7, color + alpha), then into .tex; keep in mind that Photoshop's default alpha transparency handling is bad, extract transparency to a dedicated alpha channel before converting to .dds
8. recheck all the items for both genders
9. recheck with beastren characters
10. final quality check pass for names and descriptions
11. ingame tools - decide on an item category for each of the items and reroll their stats until they seem fine enough
== Known issues ==
The sheer amount of data being added in here means it takes about a second to import everything (on my machine at least), so startup and script reset are slowed down by that much. I'll look into ways to mitigate this as part of Content Editor in the coming days.
Some of the armor pieces have very obvious clipping, especially those with no both-gender versions, the only workaround for that is to add separate meshes for the other gender or add specific mask textures to hide the character's body.
== Comments ==
This was tedious work, but I think it was worth it because there's some nice pieces hidden in there, as well as getting at least a glimpse of the better customization that we were promised.
If you agree, consider donating to support my efforts: https://ko-fi.com/shadowcookie.