> ## Documentation Index
> Fetch the complete documentation index at: https://items.lodemc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Particle spirals round props

> Draw spirals of particles round a prop: strands, points, radius, height, spin and a travelling wave, with colours per strand and different particles per state.

`particles:` draws a spiral of particles round a [prop](https://items.lodemc.net/furniture.md), like a magic lamp or a shrine. It turns, can bob up and down, and can change with the piece's [state](https://items.lodemc.net/props/doors-and-states.md#states). Every key is optional.

```yaml items/props/magic_lamp.yml theme={null}
magic_lamp:
  type: prop
  model: magic_lamp.json
  particles:
    particle: dust
    color: ["#6EDCFF", "#C8F4FF"]   # one per strand, repeating
    strands: 2
    points: 10
    radius: 0.7
    height: 1.2
    spin: 3s
```

The Lodestone Lamp that comes with Lode Items (`items/props/lodestone/`) has a two-strand spiral while it's on.

## Options

| Key | Default | Does |
| - | - | - |
| `particle` | `dust` | Any particle that takes no extra data, or one that takes a colour (`dust`, `entity_effect`). |
| `color` | white | Colours, one per strand, repeating. Only for particles that take a colour. |
| `size` | `1` | The size of `dust` particles, up to 4. |
| `strands` | `2` | How many spirals, spaced evenly round. 1 to 16. |
| `points` | `10` | Particles along each strand. 1 to 128. |
| `radius` | `0.6` | Blocks from the middle. |
| `height` | `1` | From the bottom of the spiral to its top, in blocks. |
| `at` | `0,0,0` | Where its bottom middle is, from the piece's floor point. |
| `turns` | `1` | How many times each strand goes round from bottom to top. |
| `spin` | `3s` | How long one full turn of the whole spiral takes. `-3s` turns the other way, `0` stands still. |
| `wave` | `0` | How far the points bob up and down, in blocks. |
| `wave-time` | `2s` | How long one bob takes. |
| `waves` | `1` | How many crests run along each strand, travelling up it. |
| `every` | `2t` | Time between draws. |

* Give a list to draw several spirals at once.
* A spiral can have at most 256 particles (`strands` times `points`).
* Only players within 32 blocks see them.

## Per state

Each [state](https://items.lodemc.net/props/doors-and-states.md#states) can have its own `particles`, so a lamp can sparkle only while it's on. A state without `particles` uses the piece's own, and `particles: none` turns them off in that state.

```yaml theme={null}
lantern:
  type: prop
  model: lantern_off.json
  states:
    on:
      model: lantern_on.json
      light: 12
      particles:
        particle: flame
        strands: 1
        points: 6
        radius: 0.2
        height: 0.4
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.