> For the complete documentation index, see [llms.txt](https://cgtoolbox.gitbook.io/cgtoolbox-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cgtoolbox.gitbook.io/cgtoolbox-docs/pcg-random-assemblies/random-assembly-widget.md).

# Random assembly widget

***

An Utility widget is available to gather more informations on variants, it's accessible using the ![](https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2FJoAMyY30BQTnaGCmb7P4%2Fimage.png?alt=media\&token=c83def2e-145b-4456-badb-7582101102de) button on a [BP Random Assembly](/cgtoolbox-docs/pcg-random-assemblies/bp-random-assembly.md) actor:

<figure><img src="https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2FXReyIKA2Q9JweMVIYdKI%2Fimage.png?alt=media&amp;token=a1c8606f-99ee-4e1a-a71b-d0e9d242b96c" alt=""><figcaption></figcaption></figure>

***

If no [random assembly definition](/cgtoolbox-docs/pcg-random-assemblies/random-assembly-definition.md) is found on the actor, the widget will display an error message and a button to create a new one:

<figure><img src="https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2FovMDqRdcaAm6iWpXH7py%2Fimage.png?alt=media&amp;token=8e703400-17e9-4ef3-acd9-71c69986a68c" alt=""><figcaption><p>No Random Assembly Definition set up.</p></figcaption></figure>

<figure><img src="https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2Fmf4k6ckX19w1vOtPKlrD%2Fimage.png?alt=media&amp;token=4e5aab99-5aa3-4fb2-9a8b-525c6a2481cd" alt=""><figcaption></figcaption></figure>

If a random assembly definition if found but with no [PCG Data Asset](/cgtoolbox-docs/pcg-random-assemblies/pcg-data-asset.md) set up, a warning will be displayed:

<figure><img src="https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2FRWQaYjYiO6VC4koBxkm9%2Fimage.png?alt=media&amp;token=0cac1c2f-4b56-4a17-b7cf-a37aa5488251" alt=""><figcaption></figcaption></figure>

***

The widget show all the variants applied to the current random assembly with some details:

<figure><img src="https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2FGv2R5LaiaQKRnNp6hzcr%2Fimage.png?alt=media&amp;token=d9ce33ae-f99a-4674-b365-75106efa9065" alt=""><figcaption></figcaption></figure>

***

#### <mark style="color:purple;">Button shortcuts:</mark>

You can create a new variant with the ![](https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2F6nsSbUYKKEmo5xxo3xAQ%2Fimage.png?alt=media\&token=4679e5b7-f41f-4427-80fe-b7c5e0ddfaf7) button. A popup will be displayed with the tags available:

<figure><img src="https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2FkAlHBPoDGh7VZshPgdHR%2Fimage.png?alt=media&amp;token=ae55f6d1-ae38-426d-9075-19bf32ca8c71" alt=""><figcaption></figcaption></figure>

If no tags are available, an error message will be displayed for few seconds: <img src="https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2Fz2hflLykQv1Sw7ytkRRj%2Fimage.png?alt=media&amp;token=961ed871-a8e3-4230-a194-3399de47bafe" alt="" data-size="original">

***

You have a shortcut available with this button: ![](https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2FVqQFDki1AIM7HsnIHYLs%2Fimage.png?alt=media\&token=5807c436-83f4-4c24-9711-24a032f9f092) to go to the Level Instance asset used by the random assembly.

Beside, If you change the content of the linked level instance (Editing / Adding / Removing actors, change tags, ...), you will need to update the PCG Data Asset accordingly, this can be done with this button: ![](https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2F3RGLULmujiVK8Jy3x3GS%2Fimage.png?alt=media\&token=711e9ff2-4575-4a50-8ed9-6967ff4e0496)

***

#### <mark style="color:purple;">Debug view:</mark>

The "Show tags" checkbox display object's bounds (with the debug color) and display also the actor tags used by the variants:

<figure><img src="https://3339851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuEJQQamuWymLVauXWDL%2Fuploads%2FynoI9jF7BTgdiXlVk834%2Fimage.png?alt=media&amp;token=df8f3082-588e-405a-a25f-3a6409fc659c" alt=""><figcaption></figcaption></figure>

***
