> 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/mechanics.md).

# Mechanics

This guide explains all the mechanics and click actions available in EasyBrushes.

### Click Actions

Click actions define how a brush responds to different types of clicks. Each brush can have different actions for different click types.

#### Available Click Types

| Click Type          | Description         | Example Usage          |
| ------------------- | ------------------- | ---------------------- |
| `left_click`        | Normal left click   | Single block placement |
| `right_click`       | Normal right click  | Rectangular selection  |
| `shift_left_click`  | Shift + left click  | Elliptical selection   |
| `shift_right_click` | Shift + right click | Execute commands       |

Use these to define what the [Action ](/eb/features/mechanics/action-types.md)is.

### Command System

#### Command Types

**Console Commands**

* Format: `[console] command here`
* Runs with console permissions
* Supports placeholders
* Can affect any player
* Full permission access

```yaml
mechanics:
  commands:
    - '[console] give %player% diamond'
    - '[console] effect give %player% speed 30 2'
```

**Message Commands**

* Format: `[message] message here <delay=ticks>`
* Sends messages to player
* Supports color codes
* Optional delay in ticks
* Perfect for feedback

```yaml
mechanics:
  commands:
    - '[message] &aBlock placed! <delay=20>'
    - '[message] &eReady for next action!'
```

#### Selection Properties

**Size Limits**

```yaml
brush:
  max_blocks_per_action: 1000  # Maximum blocks per selection
```

**Preview System**

```yaml
brush:
  glow:
    size: "SHOWN"  # Preview size
    update_rate: 1  # Update frequency
```

### Block Placement Rules

#### Placement Sides

Controls which faces blocks can be plainted on:

```yaml
placeable_sides: ALL  # ALL, WALL, FLOOR, CEILING
```

* **ALL**: Any face
* **WALL**: Only vertical faces (N,S,E,W)
* **FLOOR**: Only upward faces
* **CEILING**: Only downward faces

#### Placement Targets

Define which blocks can be painted on:

```yaml
placeable_on: ALL  # ALL or SPECIFIC
placeable_blocks:
  stone:
    material: STONE
    permission: all
```

#### Placeable Blocks

Define which blocks can be used as "paint":

```yaml
available_blocks:
  stone:
    material: STONE
    permission: all
```

### Complete Example

Here's a complete example showing all mechanics:

```yaml
brushes:
  advanced_brush:
    itemname: '&6&lAdvanced Brush'
    material: BLAZE_ROD
    mechanics:
      click_actions:
        left_click: SINGLE
        right_click: RECTANGULAR
        shift_left_click: ELLIPSE
        shift_right_click: CONSOLE
      commands:
        - '[console] effect give %player% speed 10 2'
        - '[message] &aActivated! <delay=20>'
        - '[message] &eSpeed boost applied! <delay=40>'
    placeable_on: ALL
    placeable_sides: ALL
    glow: true
    durability_use: 1
    particle: true
```

### Technical Details

#### Performance Impact

* Selection size affects performance
* Preview updates use resources
* Command execution has delay
* Particle effects cost CPU
* Display entities use memory

#### Best Practices

1. Limit selection sizes
2. Use appropriate modes
3. Optimize command usage
4. Balance visual effects
5. Consider server load