Particle spirals round props - LodeItems

particles: draws a spiral of particles round a prop, like a magic lamp or a shrine. It turns, can bob up and down, and can change with the piece’s state. Every key is optional.

items/props/magic_lamp.yml

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 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.

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