> For the complete documentation index, see [llms.txt](https://junkeh.gitbook.io/eb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://junkeh.gitbook.io/eb/features/preview-system.md).

# Preview System

The preview system in EasyBrushes uses display entities to show real-time block previews before placement.

{% hint style="warning" %}
This feature will change slightly between updates
{% endhint %}

### Configuration

#### Basic Settings

```yaml
  glow:
    # Size of Display Entity HIDDEN (0.99), SHOWN (1.01)
    size: "HIDDEN"
    # How often to update glow effect (in ticks)
    update_rate: 1
    # BLOCK (block display), ITEM (item display), or CMD (custom model data)
    display_type: "BLOCK"
    # FIXED (normal display) or CMD (custom model data)
    block_data: "FIXED"
    custom:
      material: "DIAMOND"
      model_data: 1000
```

CMD uses the Custom material for the preview option.\
FIXED uses whatever the brush is using.

#### Display Position

change the preview position using decimal values:

```yaml
brush:
  glow:
    display_shift:
      x: 0.0  # Positive = right, negative = left
      y: 0.0  # Positive = up, negative = down
      z: 0.0  # Positive = forward, negative = backward
```

{% hint style="success" %}
For the most accurate block display without Z fighting please use -0.005xyz
{% endhint %}

### Per-Player Settings

Players can toggle previews using:

```
/eb glow on
/eb glow off
```

### <mark style="color:red;">Performance Settings ##EXPERIMENTAL##</mark>

```yaml
performance:
  max_preview_blocks: 1000
  async_preview: true
  preview_throttle: 50
```

{% hint style="danger" %}
PLEASE DO NOT CHANGE THIS IF YOU DO NOT KNOW WHAT YOU ARE DOING. THIS FEATURE IS REALLY EXPERMINENTAL.
{% endhint %}
