Skip to content

Getting Started

This guide covers the requirements, installation process, generated files, and first command for Particle Text.


  • Java Version: Java 25 or newer.
  • Server Software: Paper 1.21.11 or newer.
  • PlaceholderAPI Optional: Resolves placeholders inside renderer text and enables the %particletext_*% expansion.
  • Permissions Plugin Optional: Use a plugin such as LuckPerms to grant administrative commands to non-operators.

  1. Download particle-text-2.0.2.jar from Hub, SpigotMC, BuiltByBit or Modrinth.
  2. Place the JAR in your server’s plugins/ directory.
  3. Install PlaceholderAPI if you want dynamic renderer text or Particle Text placeholders.
  4. Restart the server. Avoid /reload, because a full restart safely initializes the renderer task and integrations.
  5. Run /pt version to confirm that Particle Text is enabled.

The first startup creates /plugins/ParticleText/ with these files:

FilePurpose
config.ymlPerformance limits, renderer defaults, menu appearance, sounds, and update checks.
messages.ymlMiniMessage-compatible command responses, chat panels, and inventory text.
renderers.ymlPersistent text, particle, font, transform, state, and location data for every renderer.

Stand where the text should appear, then run:

Terminal window
/pt create welcome Welcome to the server!

The ID must contain 1 to 32 lowercase letters, numbers, underscores, or hyphens. Continue with the Creating Renderers guide to move and style it.