> For the complete documentation index, see [llms.txt](https://wiki.redmodding.org/cyberpunk-2077-modding/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/world-editing/infinite-randomizer-framework/variant-pool.md).

# Variant Pool

Variant Pools contain the replacement resource paths, appearances and weights and target one category each.\
Variant Pools carry a `.json` extension and are located in \``bin\x64\plugins\cyber_engine_tweaks\mods\InfiniteRandomizerFramework\data\variantPools`.\
Each Variant Pool can only contain one resource type which must match the resource type of the category it's targeting.

The Root Object has the following properties:

| Property | Explanation                                                       | Required                               |
| -------- | ----------------------------------------------------------------- | -------------------------------------- |
| name     | Unique Identifying Name                                           | Yes                                    |
| enabled  | Current State                                                     | Yes                                    |
| category | Target Category Name                                              | Yes                                    |
| variants | List Of Resources That Will Be Replacing Elements In The Category | Yes, Must Contain At Least One Variant |

Each variant in the variants list has the following structure:

| Property     | Explanation                                                        | Required                  |
| ------------ | ------------------------------------------------------------------ | ------------------------- |
| resourcePath | Resource Path Of The Resource                                      | Yes                       |
| weight       | Relative Bias Towards This Entry. This Value Must Be Non Negative. | No, Defaults To 1         |
| appearance   | Resources Appearance                                               | No, Defaults to "default" |

{% hint style="warning" %}
Appearances are ignored for `worldTerrainMeshNode` and `worldStaticDecalNode`.
{% endhint %}

The weight is not a fixed percentage but rather a relative bias that depends on the amount of entries and their weights.\
For example a variant with a weight of 2 will be picked twice as often as a variant with a weight of 1, while two variants with an equal weight will be equally likely to be picked.\
Do keep in mind that Cyberpunk uses a lot of instanced nodes for meshes leading to some resources being replaced together as they are part of the same node. This is not something that can easily be changed.

An example Variant Pool:

```json
{
    "name": "Vanilla-MagazinesOpen",
    "enabled": true,
    "category": "MagazinesOpen",
    "variants": [
        {
            "resourcePath": "base\\environment\\decoration\\misc\\paper\\magazine\\magazine_k_open.mesh",
            "appearance": "default",
            "weight": 1
        },
        {
            "resourcePath": "base\\environment\\decoration\\misc\\paper\\magazine\\magazine_l_open.mesh",
            "appearance": "default",
            "weight": 1
        },
        {
            "resourcePath": "base\\environment\\decoration\\misc\\paper\\magazine\\magazine_m_open.mesh",
            "appearance": "default",
            "weight": 1
        },
        {
            "resourcePath": "base\\environment\\decoration\\misc\\paper\\magazine\\magazine_n_open.mesh",
            "appearance": "default",
            "weight": 1
        }
    ]
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/world-editing/infinite-randomizer-framework/variant-pool.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.