> For the complete documentation index, see [llms.txt](https://jeratools.gitbook.io/gridbuilder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jeratools.gitbook.io/gridbuilder/documentation/proximity/proximity-groups-and-effectors.md).

# Proximity Groups and Effectors

### Hirachy

```mermaid
graph TD
    %% Top Layer
    Top[Grid]

    %% Middle Layer
    Mid1[Proximity Group]
    Mid2[Proximity Group]

    %% Top to Middle Connections
    Top --> Mid1
    Top --> Mid2

    %% Lowest Layer - Connected to Middle Node 1
    Low1A[Effector]
    Low1B[Effector]
    Mid1 --> Low1A
    Mid1 --> Low1B

    %% Lowest Layer - Connected to Middle Node 2
    Low2A[Effector]
    Low2B[Effector]
    Mid2 --> Low2A
    Mid2 --> Low2B
```

### Proximity Groups

Proximity Groups contain all the information about attached effectors, custom properties and which grid it is applied to. Each grid can have as many different proximity groups as you like and need.

A proximity group will generate the "Proximity 1" pseudo effect, which inherits the settings for effectors and which parameters are influenced.

***

### Effectors

Effectors are the actual driver of proximity. This is what all proximity effects are calculated with. The chosen effects are driven by the effectors position.

You can have as many effectors within a proximity group as you like and need. Generate multiple effectors to create different effects and results. \
If you use multiple effectors, the assets will always follow or react the closest effector!

***

**Important notice:** We made the decision to visualize the effector with a simple circle shape to avoid multiple layers and shape layers within the composition.\
Though not visible, **the Effector is a sphere in calculation.** The radius that you set within the proximity pseudo effect is not 2D, it is 3D.