Skip to content

Latest commit

 

History

History
170 lines (143 loc) · 9.61 KB

README.md

File metadata and controls

170 lines (143 loc) · 9.61 KB

Equipment-EX

  • Adds a new transmog system with 50+ 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

Getting Started

Requirements

Installation

  1. Install requirements
  2. Download the latest release archive
  3. Extract the archive into the Cyberpunk 2077 installation directory

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

Documentation

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.Eyes Lenses, Visors
OutfitSlots.EyeLeft Lenses, Visors
OutfitSlots.EyeRight Lenses, 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.ElbowLeft
OutfitSlots.ElbowRight
OutfitSlots.WristLeft Watches, Bands
OutfitSlots.WristRight Watches, Bands
OutfitSlots.Hands Gloves
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.KneeLeft
OutfitSlots.KneeRight
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

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: