Skip to main content

ClaimParticles

Welcome to the ClaimParticles documentation!

ClaimParticles is a lightweight, highly performant Paper/Spigot plugin addon for GriefPrevention that renders claim borders using customizable particle effects.

Paper 1.21.x Ready

ClaimParticles is built against the Paper API 1.21 and is fully forward-compatible across all 1.21 sub-versions (1.21, 1.21.1, 1.21.4, 1.21.11+).


Key Features

  • Visual Claim Borders: Highlights GriefPrevention land claims with smooth, continuous particle boundaries.
  • 10 Curated Particle Options: Safe, selected particle types out of the box (FLAME, HEART, HAPPY_VILLAGER, ANGRY_VILLAGER, NOTE, ENCHANT, PORTAL, ITEM_SLIME, ITEM_SNOWBALL, CLOUD).
  • Static Display (No Blinking): Configured to refresh at 5 ticks (4 times/sec), eliminating the annoying blinking effect found in standard particle tasks.
  • Dual Y Height Modes:
    • PLAYER Mode: Particles follow the player's vertical height dynamically.
    • CUSTOM_RANGE Mode: Renders 3D boundary boxes with horizontal rings and vertical corner pillars across customizable Y ranges.
  • LuckPerms Integration: Support for gating individual particles behind permissions (claimparticles.particle.<type>).
  • Admin Tools & Hot Reloading: Reload configuration files on the fly (/claimparticles reload) or remotely toggle particles for online players (/claimparticles admin toggle <player>).
  • High Performance & Unicast: Particles are spawned strictly to the target player, sending 0 extra network packets to other players.

Quick Navigation