# ArchiveXL: Tags ## Summary **Published:** ??? by [mana vortex](https://app.gitbook.com/u/NfZBoxGegfUqB33J9HXuCs6PVaC3 "mention")\ **Last documented update:** April 21 2025 by LadyLea This page will tell you about **tags** and how they can be used to influence item behaviour. It also teaches you how [#adding-custom-tags](#adding-custom-tags "mention") can help you conditionally un-hide items or add new features. ### Wait, this is not what I want! * Tags are used for calculating Garment Support score, see [garment-support-how-does-it-work](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/3d-modelling/garment-support-how-does-it-work "mention") * There is an own page for [influencing-other-items](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/items-equipment/influencing-other-items "mention") ## What do tags do? [Tags](https://github.com/psiberx/cp2077-archive-xl/wiki#visual-tags) are a way to tell Cyberpunk that an item has certain properties and should behave in a certain way. This makes the game apply properties to your items, which can then be utilized by the game and ArchiveXL. {% hint style="warning" %} To apply visual tags to an item you must add them to [**visualTags**](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators/modding-guides/items-equipment/influencing-other-items#visualtags-garmentsupport) property of your appearance definition or to [**visualTagsSchema**](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators/modding-guides/items-equipment/adding-new-items/archivexl-dynamic-variants#the-root_entity) of your root entity template. {% endhint %} {% hint style="danger" %} Tags are case-sensitive! {% endhint %} ### Base game tags | Tag | Effect | | --------------- | --------------------------------------------------------------------------- | | `hide_H1` | Hides an item in the `Head` slot. | | `hide_F1` | Hides an item in the `Eyes` slot. | | `hide_T1` | Hides an item in the `Chest` slot. | | `hide_T2` | Hides an item in the `Torso` slot. | | `hide_L1` | Hides an item in the `Legs` slot. | | `hide_S1` | Hides an item in the `Feet` slot. | | `hide_T1part` | Toggles the partial suffix (`&Full` →`&Part`) when applied to `Torso` item. | | `hide_Hair` | Hides hair. | | `hide_Genitals` | Hides genitals in uncensored mode and underwear in censored mode. | ### ArchiveXL tags {% hint style="info" %} * Check [#base-game-tags-and-archivexl-tags-visual-guides](#base-game-tags-and-archivexl-tags-visual-guides "mention") for a diagram * Check the [#foot-states](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/core-mods-explained/archivexl-suffixes-and-substitutions#foot-states "mention") section for more tags concerning [Toggleable Feet](https://www.nexusmods.com/cyberpunk2077/mods/7049) * Check [#footsteps-setting-footwear-sounds](#footsteps-setting-footwear-sounds "mention") for shoe sound tags * Check the [#root-entity-tags](#root-entity-tags "mention") section below for more tags {% endhint %} | Tag | Effect | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `hide_Head` | Hides head. | | `hide_Torso` | Hides the whole torso (0, 1, 2) | | `hide_LowerAbdomen` | Hides lower abdomen. (3) | | `hide_UpperAbdomen` | Hides upper abdomen. (2) | | `hide_CollarBone` | Hides collar bone area. (1) | | `hide_Arms` | Hides the whole arms, including hands. (There's [no easy way to partially hide arms](https://wiki.redmodding.org/cyberpunk-2077-modding/references-lists-and-overviews/cheat-sheet-body#arms), you would have to [create custom tags](#adding-custom-tags)) | | `hide_Thighs` | Hides thighs. (4) | | `hide_Calves` | Hides calves. (5) | | `hide_Ankles` | Hides ankles. (6) | | `hide_Feet` | Hides feet. (7) | | `hide_Legs` | Hides the entire legs (including feet, 4, 5, 6, 7) | | `HighHeels` | Turns the current (shoe) item into high heels. (Item's yaml `$base` must be a foot item) | | `FlatShoes` | Turns the current (shoe) item into flat shoes. (Item's yaml `$base` must be a foot item) | | `AppearanceParts` | Goes into the .app file. Enables [partsValues](https://github.com/CDPR-Modding-Documentation/Cyberpunk-Modding-Docs/blob/main/for-mod-creators-theory/files-and-what-they-do/file-formats/appearance-.app-files#partsvalues) for non-player-equipment | ### Base Game Tags and ArchiveXL Tags - Visual Guides

Visual Guide - Tags - Male Body - By LadyLea

Visual Guide - Tags - Female Body - By LadyLea

Visual Guide - Tags - Default Arms - By LadyLea

Visual Guide - Tags - Head - By LadyLea

{% hint style="warning" %} Tags to partially hide default arms and cyberarms are not available, however, you can make use of [Chunkmasks](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators/files-and-what-they-do/3d-objects-.mesh-files/submeshes-materials-and-chunks#chunkmasks-partially-hiding-meshes) with the aid of this [component list for Arms and Cyberarms](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators/references-lists-and-overviews/cheat-sheet-arms) OR you can create your own [Custom Tags](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators/core-mods-explained/archivexl/archivexl-tags#adding-custom-tags). {% endhint %} ## Root entity tags There are a few tags that can be added to the root entity **or** in the .app file. Here's a list: #### EmptyAppearance {% hint style="warning" %} This only works for legacy ArchiveXL projects.\ If you're using [archivexl-dynamic-variants](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/items-equipment/adding-new-items/archivexl-dynamic-variants "mention"), please use [conditional appearances](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/items-equipment/adding-new-items/archivexl-dynamic-variants#conditional-switching-picking-appearances-by-name) in your .app file. {% endhint %} This will hide an item under certain conditions. Add the following tag to the root entity: **`EmptyAppearance:FPP`** You have the following other options to achieve the same end:
Root entity appearance
(without dynamic variants)		name: my_appearance&FPP.app path: base\characters\appearances\player\items\empty_appearance.app
default
.app conditional appearance: change default appearance namename: my_appearance&camera=tppArchiveXL will automatically add empty appearances for anything you have not defined
.app conditional appearance: add empty appearance yourselfname: my_appearance&camera=fppno partsValues, no components.
Do not do this - use the line above this one instead!
**`force_Hair`** A tag that forces hair to show up while wearing a head item. By default, head items turn hair invisible. By adding this tag to the root entity, you can override this process. **`force_FlatFeet`** A tag that forces female V's feet to be flat. Only works with a foot item as `$base` in the `.yaml`: use this if you're making flat shoes and don't want female V's feet to look as if she was wearing heels. {% hint style="warning" %} This tag will turn feet invisible for mascV unless the user has switch feet installed. You want to apply this to a conditional appearance in the .app file (`&gender=m`) {% endhint %} ### Footsteps: Setting footwear sounds If you don't want your new boots to sound as if V was barefoot, add one of the following tags to the [https://github.com/CDPR-Modding-Documentation/Cyberpunk-Modding-Docs/blob/main/for-mod-creators-theory/files-and-what-they-do/file-formats/entity-.ent-files#root-entity](https://github.com/CDPR-Modding-Documentation/Cyberpunk-Modding-Docs/blob/main/for-mod-creators-theory/files-and-what-they-do/file-formats/entity-.ent-files#root-entity "mention"): ``` Boots Heels Sneakers Stilettos Metal_feet ``` ## Adding Custom tags Custom tags let you set [component chunk masks](https://wiki.redmodding.org/cyberpunk-2077-modding/files-and-what-they-do/components#chunkmask) from the .xl file without the need of touching either .app or .ent file. {% hint style="danger" %} For this, it is mandatory that you have unique component names. If you include your modder name, it's unlikely that anyone will overwrite them by accident. {% endhint %} ### **Why would I need this?** [partsOverrides](https://github.com/CDPR-Modding-Documentation/Cyberpunk-Modding-Docs/blob/main/for-mod-creators-theory/files-and-what-they-do/file-formats/appearance-.app-files#partsoverrides) **exists!** 1. PartsOverrides can't un-hide components for you. It can only hide them. If you want to load a different mesh (for example, a de-formed hakama when wearing a kimono or haori), then you're flat out of luck. 2. By being clever about your submeshes, you can offer different versions of your mesh (cropped! No arms! No legs), and users only need to install an .xl file! No need to have different meshes or even different .archive files. Not convinced? Pity, but if you find a new use case for those things, do [edit it in](https://app.gitbook.com/invite/-MP5ijqI11FeeX7c8-N8/H70HZBOeUulIpkQnBLK7)! ### **Example** #### Registering the tag Add custom tags **in your `.xl` file** (not in your `.yaml`!) ``` overrides: tags: my_custom_unhiding_tag: my_hidden_component_name: {show: [0, 1, 2, 3]} my_HideSeamfix: t0_000_pma_base__full_seamfix: {hide: [0, 1, 2, 3]} ``` #### Connecting the tag with the item Simply add the tag to your appearance's tags array near the bottom of the individual entries.

An example where to add your custom tag

## Conditional component (un)loading With ArchiveXL tags, you can conditionally switch out components — even those of other mods and garments. For example, you can load a narrower/compressed version of a garment when it's worn under a jacket:

hakama (monk_skirt) - shrinks under kimono/haori

To achieve this, we have two components in the mesh\_entity:
The second component is **turned off** via [chunkmask](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/files-and-what-they-do/file-formats/3d-objects-.mesh-files/submeshes-materials-and-chunks), the first one is displayed by default. The trigger item (the kimono/haori on the left) uses the `manavortex_kimono` tag. This is the .xl file: ```yaml overrides: tags: manavortex_kimono: l1_manavortex_hakama_under_kimono: {show: [0, 1, 2, 3]} ``` The original mesh is hidden via [`partsOverride`](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/items-equipment/influencing-other-items#partsoverrides-changing-other-meshes) in the kimono's .app (I could also have used a second tag to hide the `l1_manavortex_hakama` component via .xl file):
### Tags and Boobies Naturally, this mechanism was immediately turned towards the things that really matter (boobs). Hyst's Body Mods ([EVB](https://www.nexusmods.com/cyberpunk2077/mods/11489), [EBB-EBBRB](https://www.nexusmods.com/cyberpunk2077/mods/4654), [EBBP-EBBPRB](https://www.nexusmods.com/cyberpunk2077/mods/9083) and [ANGEL](https://www.nexusmods.com/cyberpunk2077/mods/14896)) make use of the mechanism to switch between the squish and natural (EBBN) chest states. By adding the corresponding tag, your garment can determine which boob state should be displayed. {% hint style="info" %} First things first, make use of [VTK - Resources for Refits](https://www.nexusmods.com/cyberpunk2077/mods/17544) as this page contains the **Shapes Add-ons** resources to refit your garment. Once the ideal shape is chosen, it is time to build up your AXL project (further details on how to make AXL clothes can be found [here ](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/items-equipment/adding-new-items)and [here](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/items-equipment/adding-new-items/archivexl-dynamic-variants)) {% endhint %} To make use of custom tags, ***one*** of the Visual Tags below must be included within your .app file information list: #### natural chest state (no bra) * `hyst_boobs_natural` - To be used for \[EBB-EBBRB], \[EBBP-EBBPRB], \[ANGEL] * `hyst_evb_boobs_natural` - To be used for \[EVB] #### squished chest shape (tight garment) * `hyst_boobs_squish`- To be used for \[EBB-EBBRB], \[EBBP-EBBPRB], \[ANGEL]

Special thanks to Meluminary for giving permission to make use of her CROPPED SPAGHETTI UNITARD .app file as an example and visual guide

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/core-mods-explained/archivexl/archivexl-tags.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.