HomeJavaModsParticle Text
Particle Text
Minimum Java Version: Java 25


PARTICLE TEXT

Particle Text creates persistent, customizable text displays using native Minecraft particles.

Build welcoming signs, server information displays, animated-looking decorations, live PlaceholderAPI boards, and eye-catching labels without relying on armor stands or entity-based holograms. Every renderer can have its own text, particle, scale, font, position, enabled state, inverted style, and three-axis rotation.


[​IMG] [​IMG] [​IMG] [​IMG]

[​IMG]

✨ FEATURES ✨
  • Persistent Particle Text: Create displays that are saved automatically and restored when the server starts.
  • Deep Renderer Customization: Give every display its own text, particle, scale, font family, font style, font size, enabled state, and inverted mode.
  • Three-Axis Rotation: Rotate text independently on the X, Y, and Z axes for walls, floors, angled signs, and creative builds.
  • Interactive Management Menu: Browse all renderers through an in-game paginated GUI, teleport with left-click, and toggle rendering with right-click.
  • Precise Relative Positioning: Nudge a renderer forward, backward, left, right, up, or down relative to your viewing direction with configurable movement amounts.
  • PlaceholderAPI Integration: Put live placeholders directly inside renderer text and expose ParticleText's own renderer placeholders to other plugins.
  • Performance-Aware Rendering: Cached point clouds, viewer-distance filtering, pixel sampling, configurable refresh intervals, and per-renderer point caps keep work bounded.
  • Player-Specific Visibility: Particles are sent only to players inside the configured view distance instead of being rendered globally.
  • MiniMessage Configuration: Customize plugin messages and menu text with Adventure MiniMessage, gradients, decorations, and hex colors.
  • Human-Readable Storage: Renderer text, style, transform, state, and location are stored in an editable renderers.yml file.
  • Reload Without Restarting: Refresh settings, messages, renderer data, PlaceholderAPI text, menu values, and the render task with /pt reload.
  • World Plugin Compatibility: Soft integration is declared for popular world managers and WorldGuard so renderers can coexist with common server setups.

[​IMG]

[​IMG]

INSTALLATION & QUICK START

Particle Text is designed to be configured directly in-game. Install the plugin, create a renderer at your position, then customize it without restarting the server.

Real in-game particle text rendered using native Minecraft particles:

[​IMG]

Spoiler: Click to view Step-by-Step Guide

Step 1: Install Particle Text
Download the latest release, place particle-text-2.0.0.jar in your server's plugins directory, and start a Minecraft 26.2 server with Java 25.

Optional dependency: Install PlaceholderAPI if you want dynamic renderer text or ParticleText placeholders.

Step 2: Create Your First Renderer
Stand where the text should appear and create a renderer with a unique ID.
Code (Text):
/pt create welcome Welcome to the server!
The renderer is created at your current location using the defaults from config.yml.

Step 3: Open the Renderer Menu
Open the paginated management menu.
Code (Text):
/pt menu
  • Left-click: Teleport to a renderer.
  • Right-click: Enable or disable a renderer.
  • Item lore: Review text, particle, scale, font, inverted state, and status.

Step 4: Customize the Display
Change the text, scale, font, and particle at any time.
Code (Text):

/pt text welcome Welcome, %player_name%!
/pt setsize welcome 0.30
/pt font welcome SansSerif BOLD 24
/pt particle welcome END_ROD
 
Step 5: Position and Rotate
Move the renderer to your location, nudge it relative to the direction you are facing, or rotate it around any axis.
Code (Text):

/pt tphere welcome
/pt move welcome right 0.25
/pt move welcome up 0.10
/pt rotate welcome y 25
/pt rotate welcome z -10
 
Step 6: Add Dynamic Text (Optional)
With PlaceholderAPI installed, renderer text can contain placeholders from installed expansions.
Code (Text):
/pt text welcome Welcome, %player_name%! Online: %server_online%
Dynamic text is refreshed at the configured interval, and its point cloud is rebuilt only when the resolved value changes.


[​IMG]

RENDERER MANAGEMENT

  • Create at Your Position: New renderers inherit cached defaults and use the player's current world and coordinates.
  • Edit Live: Change text, particle, scale, font, rotation, and state while the server is running.
  • Move or Visit: Teleport to a renderer, move it to your location, or nudge it in six directions with precise movement amounts.
  • Toggle Instantly: Disable temporary displays without deleting their saved configuration.
  • Reload Safely: Re-read files and rebuild the render task without a full server restart.
  • Keep Data Portable: Back up or edit renderers.yml using a normal text editor.

[​IMG]

COMMANDS & PERMISSIONS

All commands can be used through /pt or /particletext. The particletext.admin permission grants access to every administrative command.

Spoiler: Renderer Management Commands
Create, Find, Move & Delete Renderers

  • /pt create <id> <text>
    Permission: particletext.command.create
    Create a renderer at your current location using the cached defaults.​
  • /pt delete <id>
    Permission: particletext.command.delete
    Permanently delete a renderer and its stored data.​
  • /pt list
    Permission: particletext.command.list
    Display every configured renderer ID.​
  • /pt menu
    Permission: particletext.command.menu
    Open the interactive paginated renderer menu.​
  • /pt teleport <id>
    Permission: particletext.command.teleport
    Teleport yourself to the selected renderer.​
  • /pt tphere <id>
    Permission: particletext.command.teleport
    Move the selected renderer to your current location.​

Spoiler: Renderer Editing Commands
Text, Appearance & Transform
These commands require particletext.command.edit.

  • /pt move <id> <forward|backward|left|right|up|down> [amount]
    Move a renderer relative to your viewing direction. The default movement amount is 0.25 blocks.​
  • /pt text <id> <text>
    Change the text displayed by a renderer.​
  • /pt setsize <id> <scale>
    Set a scale greater than 0 and at most 10.​
  • /pt font <id> <name> <style> <size>
    Choose a Java font family, PLAIN/BOLD/ITALIC/BOLD_ITALIC style, and a size from 4 to 128.​
  • /pt particle <id> <particle>
    Change to a supported data-free Bukkit particle.​
  • /pt enabled <id> <true|false>
    Enable or disable particle rendering without deleting the renderer.​
  • /pt inverted <id> <true|false>
    Switch between glyph pixels and an inverted rectangular text effect.​
  • /pt rotate <id> <x|y|z> <angle>
    Set the renderer's rotation around one axis.​

Spoiler: Utility Commands & Remaining Permissions
Administration & Information

  • /pt reload
    Permission: particletext.command.reload
    Reload settings, messages, renderer data, PlaceholderAPI text, menu values, and the render task.​
  • /pt help
    Permission: particletext.command.help
    Display the configured command help menu.​
  • /pt version
    Permission: particletext.command.version
    Display the installed ParticleText version. This permission is available to everyone by default.​
  • Tab completion
    Permission: particletext.command.tabcomplete
    Receive standard ParticleText command suggestions.​

[​IMG]

PLACEHOLDERAPI

PlaceholderAPI is optional. When installed, Particle Text can resolve placeholders inside renderer text and provides its own particletext expansion for other plugins.

Spoiler: Global & Nearest Renderer Placeholders
Code (Text):

%particletext_total%              - Total number of renderers
%particletext_enabled%            - Number of enabled renderers
%particletext_disabled%           - Number of disabled renderers
%particletext_nearest_id%         - ID of the nearest renderer
%particletext_nearest_text%       - Text of the nearest renderer
%particletext_nearest_distance%   - Distance to the nearest renderer
 

Spoiler: Renderer-Specific Placeholders
Replace <id> with a renderer ID.

Code (Text):

%particletext_renderer:<id>:text%       - Stored renderer text
%particletext_renderer:<id>:particle%   - Configured particle name
%particletext_renderer:<id>:scale%      - Configured text scale
%particletext_renderer:<id>:enabled%    - Enabled state
%particletext_renderer:<id>:inverted%   - Inverted state
%particletext_renderer:<id>:world%      - Stored world name
 
Examples
Code (Text):

%particletext_renderer:welcome:text%
%particletext_renderer:welcome:particle%
%particletext_renderer:welcome:enabled%
 

[​IMG]

PERFORMANCE & CONFIGURATION

Particle Text keeps renderer work predictable through cached data and configurable limits.

  • render-interval-ticks: Controls how often particle passes run.
  • view-distance: Skips players outside the visibility radius before particles are sent.
  • pixel-step: Samples every nth rasterized pixel to reduce particle density.
  • max-points-per-renderer: Caps the cached particle points generated for one renderer.
  • max-text-length: Limits command input and resolved PlaceholderAPI output.
  • force-particles: Controls whether client particle preferences are bypassed.
  • placeholder-refresh-ticks: Sets how often dynamic text is resolved again.
  • Single shared scheduler: Coordinates all active renderers instead of creating an independent task for each display.

[​IMG]

bStats METRICS

This plugin collects anonymous usage statistics through bStats.

This data, such as player count, server version, and Java version, helps us understand how the plugin is being used and make better development decisions. No private information is collected.


[​IMG]


[​IMG]

Enjoying the plugin?

Particle Text is free and open source. If it helps you build a more memorable server, please consider leaving a 5-star review, reporting issues, or contributing on GitHub!

Thank you to everyone using and supporting Particle Text! ❤️

Copyright 2026 © Berke Akçen

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Particle Text is a free Minecraft Java mod. Compatible with Minecraft 26.2. Downloaded 2,822 times (via Spigot). Download it and open it directly in the game.

Explore more