# Randomized Nested Groups

A complex RNG, containing multiple nested RNGs, realtime randomization

## What are RNGs * Randomized Nested Groups (RNGs) are a special type of group, which allow for it's content to be randomized * They can be used just like normal groups, just that you get options allowing for control over when and how it's content are being spawned * As the name says, they can be nested, allowing to create complex, reusable and randomized prefabs ## Why use them * RNGs can make adding details to a build **significantly** faster, especially for things like clutter and trash * While being randomized, they allow for rather fine control, such that the result still looks coherent * RNGs can be easily shared, so if you make a nice selection of them, feel free to share them with others on e.g. Nexus * RNGs can just like normal groups be saved as prefab, [categorized, tagged and shared](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/world-editing/ui-tabs-explained/tab-favorites-and-prefabs#creating-favorites-prefabs) ## Creating a RNG * To create a new base RNG, simply click the "Dice" icon next to the `Add Group` button, then create the group

Enable the randomization using the dice button, then hit `Add Group` as usual

* Now simply start by adding some elements to the RNG, e.g. some soda cans * As you add new elements to the RNG (This can be single elements, but also groups or other RNGs), you will notice some of them being hidden due to the randomization

### RNG Settings * To change the behavior of the RNG, select it, then expand the `Group Randmoization` header

RNG settings, either default per element spawning, or fixed amount spawning

* Here you can also change the seed, or randomize it, this will re-randomize the RNG (Including the seeds of all contained RNGs) {% hint style="success" %} If you don't like how the RNG looks, simply randomize its seed using the button to its right {% endhint %} #### Randomization Modes * There are two randomization modes: * Default: * Here, each contained element is spawned or not based on its own probability * Fixed: * Here, a fixed amount of the contained elements is spawned * You can either define a percentage (E.g. 75%), or a total amount (E.g. 2 elements should spawn) * In this mode, the individual probabilities of the contained elements are used to determine which are more likely to spawn ### RNG Child Settings * Any element contained inside an RNG has its own settings * Change them under the `Entry Randomization` header

Individual elements settings, such as probability, randomized rotation and appearance

* The `Spawning Probability` has a different effect based on the [randomization mode of the parent RNG](#randomization-mode) * Additionally, you can randomize the rotation of one axis * For entities and meshes, you can also randomize the used appearance {% hint style="success" %} A RNG which is part of another RNG will have both the `Group Randomization` and the `Entry Randomization` headers This is what makes RNGs very powerful, being able to nest RNGs inside RNGs {% endhint %} ## Example * In this example we will create an RNG which consists of a vending machine, with some trash ### Base RNG * Lets start by making a new RNG * The main use of this "Root" RNG is so that we can quickly re-seed all the contained RNGs * Since the root RNG does not need randomization, we will set it to fixed mode, and `100%`

Our root RNG, so that we can easily refresh the seed of all contained RNGs at once

### Vending Machine * Lets add the vending machine `base\gameplay\devices\vending_machines\vending_machine_1.ent` to it, spawned as Entity * Since it has loads of appearances, also enable randomization of apps

Add the vending machine, and enable randomized appearances

### Soda Single RNG * Lets also make a simple RNG for soda cans, which we will re-use * Make a new RNG, and put all the soda can meshes (Spawned as mesh) which you can find inside, all placed in the same position * Additionally also enable rotation randomization for each soda can mesh * Now, set the soda RNGs mode to fixed, and the total amount to `1` * Now we have a RNG which spawns exactly one random soda can

Randomized single soda can mesh, using fixed mode

### Soda Multiple RNG * Lets take out single soda RNG and put three copies of it into yet another RNG * I will leave this new "multi" RNGs settings at default, so each single soda RNG has a chance of 50% of spawning * This leaves us with a group of 3 randomized soda cans * Now lets take this RNG, and put some copies into our root RNG, placed around the vending machine

Three of our single can RNGs placed into another RNG, left with default randomization rule

### Cardboard RNG * Lets make another RNG for some cardboards, we will add 3 cardboard meshes to it, and set each one to randomize its yaw rotation * The RNG will be set to fixed mode, and configured to spawn 2 of our 3 cardboard meshes

RNG spawning two out of three cardboard meshes with randomized rotation

### Decals RNG * Similar to the cardboard RNG, we will make another RNG containing some dirt and vomit decals * Once again, each decal is set to randomize its yaw rotation * We will configure the RNG to spawn 75% of the decals

### Final result * After adding some more RNGs for trashbags and a trashcan you get a final RNG that you can make a [favorite](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/world-editing/ui-tabs-explained/tab-favorites-and-prefabs#creating-favorites-prefabs), to re-use it elsewhere * Drop the attached JSON file into `Cyberpunk 2077\bin\x64\plugins\cyber_engine_tweaks\mods\entSpawner\data\favorite` if you just want the finished prefab {% file src="" %} --- # 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/modding-guides/world-editing/object-spawner/features-and-guides/randomized-nested-groups.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.