Skip to content

config.yml

config.yml controls global behavior. Run /pt reload after editing it.


performance:
max-particles-per-tick: 15000
render-interval-ticks: 2
initial-delay-ticks: 20
view-distance: 32.0
pixel-step: 1
max-points-per-renderer: 1500
max-text-length: 128
force-particles: false
placeholder-refresh-ticks: 100
OptionDescription
max-particles-per-tickShared particle budget per server tick; renderers take turns when it is exhausted.
render-interval-ticksDelay between shared render passes.
initial-delay-ticksStartup or reload delay before the first pass.
view-distanceMaximum visibility radius in blocks.
pixel-stepSamples every nth raster pixel.
max-points-per-rendererMaximum cached particle points for one renderer.
max-text-lengthMaximum accepted command text and resolved placeholder output.
force-particlesForces visibility regardless of the viewer’s particle preference.
placeholder-refresh-ticksInterval for resolving dynamic PlaceholderAPI text.

defaults:
particle: FLAME
scale: 0.20
inverted: false
enabled: true
font:
name: SansSerif
style: PLAIN
size: 16

These values are copied when /pt create makes a new renderer. Existing renderers retain the individual values saved in renderers.yml.

SansSerif is Java’s portable logical fallback. Valid styles are PLAIN, BOLD, ITALIC, and BOLD_ITALIC.


menu:
sound-volume: 1.0
sound-pitch: 1.0
title: '<gradient:#00E5FF:#7C4DFF><bold>Particle Text</bold></gradient> <#37474F>»'
rows: 6
enabled-material: LIME_DYE
disabled-material: GRAY_DYE
previous-page-material: ARROW
next-page-material: ARROW
empty-material: BARRIER
decoration-blocks:
material: GRAY_STAINED_GLASS_PANE
sounds:
open: ui.button.click
page-change: ui.button.click
teleport: entity.enderman.teleport
enabled: block.note_block.pling
disabled: block.note_block.bass

Menu height accepts 3 through 6 rows. Sound volume accepts 0 through 2; pitch accepts 0.5 through 2. Invalid or air materials, unknown sound keys, and out-of-range settings reject the reload and preserve the active configuration.


updates-enabled: true

When enabled, Particle Text checks for newer releases during startup.


commands:
default-move-amount: 0.25
chat:
page-size: 8

default-move-amount supplies the distance for /pt move when no amount is given; accepted values are 0.01 through 100. page-size controls rows in both /pt list [page] and /pt help [page]; accepted values are 1 through 30.