# Rarity VFX

{% hint style="success" %}
**COPY/PASTE PARAMETERS**

New in GM 0.11! Right click on a behaviour or component to copy. Then open an object, add the same behaviour or component, and right click it to paste identical parameter settings.
{% endhint %}

{% hint style="info" %}
**GAME MAKER 0.9 ENHANCEMENT**

New preview button in Editor mode so there's no need to test in play mode as before. 
{% endhint %}

<figure><img src="https://4251931498-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MO_j99BJEXK4zHqxgqS%2F-MOp-7ir3XnEbY6dzW8x%2F-MOp-ll3ZIud-Hlw2sdk%2FRarity.gif?alt=media&#x26;token=64438c36-959e-476f-97a0-d481ee44cf64" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
[build-singleplayer-and-multiplayer-logic](https://docs.sandbox.game/en/creator/game-maker/docs/build-singleplayer-and-multiplayer-logic "mention") - about <mark style="color:green;">**\[SP]**</mark> or <mark style="color:yellow;">**\[MP]**</mark> behaviours or components
{% endhint %}

## ![](https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FIZrL0jI7GMHtryDoSupC%2Fimage.png?alt=media\&token=c825f9e9-d010-4bc9-baaa-344fb570fe74) Rarity VFX <mark style="color:yellow;">\[MP]</mark>

* Create a light halo the size of the object's collider base, which gradually weakens on the object's z-axis \
  (rotate the object and the aura will change direction).
* Rarity determines colour: Grey, White, Blue, Purple and Orange.
* Customise halo and sparkle

## Common Uses

* Highlighting an object to draw the player's attention to it
* Creating scenery effects\
  **Recommended:** [**Visual FX behaviour**](https://docs.sandbox.game/en/creator/game-maker/docs/components/display/visual-fx) includes many more options
* Bold lighting effects in a specific direction, such as a spotlight

## Communications

There are no communications for this component.

## Parameters

| Options                                                                                        | Details                                                              |
| ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/Qa5GvCMDp6VKrUSiGAfi/1.png) | **Rarity Color** - Which color is displayed (locked).                |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/67mW6leXloAF5qGde2b0/2.png) | **Halo Intensity** (slider) - How intense the halo glow will be.     |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/TxwtCYrgUoLpEd4ZKHJU/3.png) | **Halo Height** (slider) - How high the halo will be displayed.      |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/zTNonfFagKdrVzX1RxQ1/4.png) | **Sparkles Intensity** (slider) - How many sparkles are in the halo. |


---

# 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://docs.sandbox.game/en/creator/game-maker/docs/components/display/rarity-vfx.md?ask=<question>
```

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.