Default Renderers

Renderers dictate exactly how the calculated mathematical coordinates are displayed to the player in the world. Below are the built-in renderers available within the Renderers class.

Standard Renderer

Class: Renderers.Standard

Uses Bukkit's standard Particle API to spawn traditional particles.

Parameter	Information
`particle`	The Bukkit `Particle` type to spawn.
`count`	The number of individual particles to spawn per calculated point.
`speed`	The dispersion speed or extra data value of the particle.
`data`	Optional extra data required by specific particles (e.g., `BlockData` for block crack particles).

Dust Renderer

Class: Renderers.DustRenderer

A specialized renderer explicitly designed for Particle.DUST. It automatically extracts dynamic RGB color information generated by the ColorProvider and applies it to the dust particles.

Parameter	Information
`size`	The size scale of the dust particles (typically between `0.1` and `4.0`).

Item Display Renderer

Class: Renderers.ItemDisplayRenderer

A high-performance renderer that manages a dynamic pool of ItemDisplay entities instead of emitting ephemeral particles. Perfect for generating complex 3D structures using custom resource pack models.

Parameter	Information
`item`	The `ItemStack` (potentially holding custom model data) to display at every point.
`scale`	The uniform float scale applied to the item models.
`billboard`	The Bukkit `Display.Billboard` mode dictating how the individual items face the camera.

05 June 2026