Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
![]()
Particle Text
Give your world something to say.
Custom fonts · Particle styles · Live server text Welcome players, mark an entrance, and make your server information part of the scenery.
A welcome sign above your spawn. A label beside a portal. A message that changes with your server. Particle Text turns ordinary text into persistent particle displays that fit the places players visit.
Create a renderer where you stand, choose its font and particle, and adjust the result in game. Saved text, position and presentation remain available after a restart.

Your words. Your server's character.
Choose the typography. Use the font families available to your server's Java environment. Choose PLAIN, BOLD, ITALIC or BOLD_ITALIC, then set the font size independently from particle spacing. Quote a font name when it contains spaces; /pt fonts lists the families your server can use.
Pick the particles. Select a supported particle that does not require extra data, such as FLAME or END_ROD. Tune spacing, pixel sampling and point limits to balance the look and workload. Inverted mode draws the background pixels around your text.
/pt create welcome Welcome to the server
/pt font welcome "SansSerif" BOLD 24
/pt particle welcome END_ROD
/pt setsize welcome 0.20
The font command controls the rasterized letters. The scale controls the distance between particle points. Change either without recreating the renderer.

A sign belongs where players will see it.
Create text at your current location and facing. Shift it forward, backward, left, right, up or down relative to your view. Set rotation around the X, Y and Z axes to match an entrance, wall or floating display.
/pt move welcome up 1
/pt rotate welcome y 45
/pt tphere welcome
/pt teleport welcome takes you back to its saved location. An unloaded world receives a clear error instead of moving the saved renderer elsewhere.

Find it. Inspect it. Make it yours.
Browse saved renderers with /pt list, hover for details and click through to a management card. /pt info welcome shows the text, particle, font, spacing, rotation, location and current state. Chat actions let you teleport, start editing, enable or disable, and prepare a delete command.
Prefer an inventory? /pt menu opens a paginated renderer browser. Left-click to teleport and right-click to toggle the selected renderer. Each action checks its own permission.
/pt text welcome Welcome back to the server
/pt enabled welcome false
/pt enabled welcome true
Commands report a clear error when the renderer already has the requested setting or state. Asking to disable an already disabled display does not announce another successful change or rewrite its saved record.
Command and permission reference
Run /pt help for paginated, permission-aware command help. /particletext is an alias of /pt. Renderer IDs use lowercase letters, digits, underscores and hyphens, with a maximum of 32 characters.
Permissions follow particletext.command.<action>. Editing settings use particletext.command.edit, both teleport actions use particletext.command.teleport, and particletext.admin grants the administrative commands. Operators receive administrative access by default. Version is available to everyone by default.

A display that follows your server.
Install PlaceholderAPI to resolve supported placeholders inside renderer text. Particle Text periodically refreshes the resolved content, rebuilding its cached points only when the text changes. Text is shared across viewers and uses a global placeholder context.
The built-in Particle Text expansion also makes renderer information available to other PlaceholderAPI-compatible plugins. It registers automatically when PlaceholderAPI is installed; no eCloud download is needed.
- %particletext_total%: number of saved renderers.
- %particletext_enabled% and %particletext_disabled%: counts by current state.
- %particletext_nearest_id%: nearest renderer in the supplied player's world.
- %particletext_renderer:welcome:text%: saved text for the renderer named welcome.
- %particletext_renderer:welcome:enabled%: that renderer's enabled state.
Explore the placeholder reference

The presentation and its budget are yours.
Tune the workload. Set the rendering interval, viewing distance, per-renderer point cap and shared particle packet budget. Fair scheduling rotates through renderers and points so a tight budget does not repeatedly skip the same displays.
Keep the settings editable. Creation defaults, inventory materials, sounds, pagination and movement amounts live in YAML. MiniMessage templates control chat text, hover descriptions, buttons, errors, menu names and lore.
Reload with validation. Run /pt reload after changing files. Settings, messages and renderer records are validated before replacing active state. Invalid values reject the reload and keep the running configuration. Renderer edits use atomic file replacement before publishing their runtime state.
Back up renderers.yml when moving your server. Saved renderer-specific fonts and transforms remain independent from the defaults used for new displays.

Start with a welcome. See where it belongs.
Compatible with Paper and its forks for Minecraft 1.21.11 and later, running on Java 25 or newer. Folia is not supported. PlaceholderAPI is optional, and font rendering uses your Java runtime's desktop module.
Download particle-text-2.0.2.jar, place it in your server's plugins folder and restart. Default configuration and an empty renderer file are installed automatically.
/pt create welcome Welcome to the server
/pt move welcome up 1
/pt info welcome

bStats Metrics
Particle Text uses bStats for anonymous aggregate usage statistics. Server owners can control bStats through its own configuration.
Make your next welcome part of the world.
Free and open source under GPL v3. Created by Despical.


