Equipment-EX v1.1.16

EQUIPMENT-EX

— Adds a new transmog system with 30+ clothing slots
— Adds a brand-new UI accessible from Hub menu and V's apartments
— Allows you to manage an unlimited amount of outfits with your names
— Converts your existing wardrobe sets to a new system at a first launch
— Works with vanilla and custom items

COMPATIBILITY

✓ Cyberpunk 2077 1.62

INSTALLATION

1. Install requirements
— RED4ext 1.11.1+
— Codeware 1.1.1+
— ArchiveXL 1.4.2+
— TweakXL 1.1.3+
— redscript 0.5.10+
— (Optional) Mod Settings 0.0.13+
2. Download the latest release
3. Extract the archive into the Cyberpunk 2077 installation directory

You should have <Cyberpunk 2077>/archive/pc/mod/EquipmentEx.archive and <Cyberpunk 2077>/r6/scripts/EquipmentEx

HOW TO USE

— The outfit manager is accessible through the new "Wardrobe" button in the Inventory menu or from wardrobe call in V's apartments
— On the right side of the screen, you will see all compatible gear grouped by slots
— Clicking on any item will activate outfit mode, which applies the visuals of the selected items to your character over equipped gear
— On the left side of the screen, you will see a list of your outfits
— The "Save outfit" button becomes available when outfit mode is active
— To equip a previously saved outfit, just click on the name in the list
— To delete an outfit, hover over the outfit and press the hotkey from the hint
— To disable the outfit mode, you can select "No outfit" or unequip the outfit from the Inventory menu
— In photo mode, you will find the option to change outfits on the fly in the pose section

MOD SETTINGS

— Item Source
"Inventory + Stash" will only use the current items in your inventory and stashes
"Wardrobe Store" will use every item you have ever obtained in the game (including dropped and disassembled items)

DOCUMENTATION

Show/hide text

Compatible items

Any item can support one base slot and one outfit slot at the same time, making the item compatible with both the game equipment system and the outfit system.

The outfit slot must be added to the placementSlots property after the base slot:

Items.MyNecklace:
  $base: Items.GenericHeadClothing
  placementSlots: 
    - !append OutfitSlots.NecklaceShort

Which is equivalent to:

Items.MyNecklace:
  $base: Items.GenericHeadClothing
  placementSlots: 
    - AttachmentSlots.Head
    - OutfitSlots.NecklaceShort

If user doesn't have Equipment-EX installed, the item will still work with the base slot.

Outfit slots

Slot name	Purpose
`OutfitSlots.Head`	Hats, Hijabs, Helmets
`OutfitSlots.Balaclava`	Balaclavas
`OutfitSlots.Mask`	Face Masks
`OutfitSlots.Glasses`	Glasses, Visors
`OutfitSlots.Wreath`	Wreaths
`OutfitSlots.EarLeft`	Earrings
`OutfitSlots.EarRight`	Earrings
`OutfitSlots.Neckwear`	Scarves, Collars
`OutfitSlots.NecklaceTight`	Chokers
`OutfitSlots.NecklaceShort`	Short Necklaces
`OutfitSlots.NecklaceLong`	Long Necklaces
`OutfitSlots.TorsoUnder`	Bras, Tight Long-sleeves
`OutfitSlots.TorsoInner`	Tops, T-Shirts, Tight Shirts, Tight Dresses
`OutfitSlots.TorsoMiddle`	Waistcoats, Blazers, Loose Shirts, Loose Dresses
`OutfitSlots.TorsoOuter`	Jackets, Coats
`OutfitSlots.TorsoAux`	Vests, Harnesses, Puffers
`OutfitSlots.Back`	Backpacks, Swords
`OutfitSlots.ShoulderLeft`
`OutfitSlots.ShoulderRight`
`OutfitSlots.WristLeft`	Watches, Bands
`OutfitSlots.WristRight`	Watches, Bands
`OutfitSlots.HandLeft`	Gloves
`OutfitSlots.HandRight`	Gloves
`OutfitSlots.FingersLeft`	Rings
`OutfitSlots.FingersRight`	Rings
`OutfitSlots.FingernailsLeft`	Nails
`OutfitSlots.FingernailsRight`	Nails
`OutfitSlots.Waist`	Belts
`OutfitSlots.LegsInner`	Tights, Leggings
`OutfitSlots.LegsMiddle`	Tight Pants, Tight Shorts
`OutfitSlots.LegsOuter`	Loose Pants, Loose Shorts, Skirts
`OutfitSlots.ThighLeft`
`OutfitSlots.ThighRight`
`OutfitSlots.AnkleLeft`
`OutfitSlots.AnkleRight`
`OutfitSlots.Feet`	Footwear
`OutfitSlots.ToesLeft`	Accessories
`OutfitSlots.ToesRight`	Accessories
`OutfitSlots.ToenailsLeft`	Nails
`OutfitSlots.ToenailsRight`	Nails
`OutfitSlots.BodyUnder`	Netrunning Suits
`OutfitSlots.BodyInner`
`OutfitSlots.BodyMiddle`	Jumpsuits, Tracksuits
`OutfitSlots.BodyOuter`
`OutfitSlots.HandPropLeft`	Props for photo mode
`OutfitSlots.HandPropRight`	Props for photo mode

When proposing a new slot, please follow these recommendations:

The purpose of the slot must be clear and distinguishable from other slots
The slot must represent an area or layer for only one item equipped at a time
The slot must be named after a body part if possible, or equipment category otherwise

Auto conversions

If you don't specify any outfit slot for your item, then the slot will be automatically assigned according to this table:

Base record	Assigned slot
`Items.GenericHeadClothing`	`OutfitSlots.Head`
`Items.Glasses`	`OutfitSlots.Glasses`
`Items.Visor`	`OutfitSlots.Glasses`
`Items.GenericFaceClothing`	`OutfitSlots.Mask`
`Items.GenericInnerChestClothing`	`OutfitSlots.TorsoInner`
`Items.GenericOuterChestClothing`	`OutfitSlots.TorsoOuter`
`Items.GenericLegClothing`	`OutfitSlots.LegsMiddle`
`Items.Skirt`	`OutfitSlots.LegsOuter`
`Items.GenericFootClothing`	`OutfitSlots.Feet`
`Items.Outfit`	`OutfitSlots.BodyMiddle`

Appearance suffixes

The mod adds a new appearance suffix that represents the state of the legs of female characters. It can be used to properly render tights depending on whether the character is wearing shoes.

To activate a new suffix, you must add it to appearanceSuffixes as usual:

Items.MyTights:
  $base: Items.GenericLegClothing
  appearanceSuffixes: 
    - !append itemsFactoryAppearanceSuffix.LegsState

Character	Footwear	Suffix
Female	Unequipped	`&Flat`
Female	Equipped without tags	`&Lifted`
Female	Equipped with `HighHeels` tag	`&HighHeels`
Female	Equipped with `FlatShoes` tag	`&FlatShoes`
Male	Unequipped	(empty)
Male	Equipped	(empty)

Translations

If you want to translate this mod into your language, get translation template JSON support/localization/lang.json.json, translate all femaleVariant values, and send it to us. Please try to make a translation as close to the English version as possible. Your translation will be added to the mod, and you will be credited on the mod page.

Available translations:

English (en-us)
Arabic (ar-ar) by @MONSTERaider
Brazilian (pt-br) by @Jaqueta
Czech (cz-cz) by @starfis
French (fr-fr) by @TFE71
German (de-de) by @Vorgash
Russian (ru-ru) by @Locked15
Simplified Chinese (zh-cn) by @Zo70
Spanish (es-es) by @Anrui

Console commands

Command	Description
`EquipmentEx.Activate()`	Activates outfit mode and clones current equipment
`EquipmentEx.Reactivate()`	Reactivates outfit mode with a last used outfit
`EquipmentEx.Deactivate()`	Deactivates outfit mode
`EquipmentEx.EquipItem(itemID)`	Equips an item by provided item id Usage: `EquipmentEx.EquipItem("Items.SomeItemId")`
`EquipmentEx.EquipItem(itemID, slotID)`	Equips an item into selected slot by provided item and slot ids Usage: `EquipmentEx.EquipItem("Items.SomeItemId", "OutfitSlots.Head")`
`EquipmentEx.UnequipItem(itemID)`	Unequips an item by provided item id Usage: `EquipmentEx.UnequipItem("Items.SomeItemId")`
`EquipmentEx.UnequipSlot(slotID)`	Unequips an item from selected slot by provided item and slot ids Usage: `EquipmentEx.UnequipSlot("Items.SomeItemId", "OutfitSlots.Head")`
`EquipmentEx.UnequipAll()`	Unequips all items
`EquipmentEx.PrintItems()`	Prints all equipped item names for the active outfit
`EquipmentEx.ExportItems()`	Prints a set of console commands which you can use any time later to recreate your current outfit
`EquipmentEx.LoadOutfit(name)`	Loads an outfit by provided name Usage: `EquipmentEx.LoadOutfit("My fancy outfit")`
`EquipmentEx.SaveOutfit(name)`	Creates new outfit with provided name Usage: `EquipmentEx.SaveOutfit("My fancy outfit")`
`EquipmentEx.CopyOutfit(name, from)`	Creates an outfit copy by provided base and new outfit names Usage: `EquipmentEx.CopyOutfit("My new outfit", "My old outfit")`
`EquipmentEx.DeleteOutfit(name)`	Deletes an outfit by provided name Usage: `EquipmentEx.DeleteOutfit("My fancy outfit")`
`EquipmentEx.DeleteAllOutfits()`	Deletes all created outfits
`EquipmentEx.PrintOutfits()`	Prints all created outfit names

COMMUNITY

Feel free to contact us on Discord if you need help with mod compatibility or have any other questions.
We prefer public discussions so that everyone can use shared knowledge.

Download (69KB) Source