config.yml
config.yml controls global behavior. Run /pt reload after editing it.
Performance
Section titled “Performance”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| Option | Description |
|---|---|
max-particles-per-tick | Shared particle budget per server tick; renderers take turns when it is exhausted. |
render-interval-ticks | Delay between shared render passes. |
initial-delay-ticks | Startup or reload delay before the first pass. |
view-distance | Maximum visibility radius in blocks. |
pixel-step | Samples every nth raster pixel. |
max-points-per-renderer | Maximum cached particle points for one renderer. |
max-text-length | Maximum accepted command text and resolved placeholder output. |
force-particles | Forces visibility regardless of the viewer’s particle preference. |
placeholder-refresh-ticks | Interval for resolving dynamic PlaceholderAPI text. |
Renderer Defaults
Section titled “Renderer Defaults”defaults: particle: FLAME scale: 0.20 inverted: false enabled: true font: name: SansSerif style: PLAIN size: 16These 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.bassMenu 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.
Update Checks
Section titled “Update Checks”updates-enabled: trueWhen enabled, Particle Text checks for newer releases during startup.
Commands and Chat
Section titled “Commands and Chat”commands: default-move-amount: 0.25chat: page-size: 8default-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.