psiberx / cp2077-equipment-ex

Cyberpunk 2077 mod that adds powerful transmog system with 30+ clothing slots and outfit manager
MIT License
33 stars 9 forks source link

Equipment-EX

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

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:

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: