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:
PLAYERMode: Particles follow the player's vertical height dynamically.CUSTOM_RANGEMode: 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
- ➤ Installation & Requirements ➜ Prerequisites and step-by-step setup guide.
- ➤ Configuration Guide ➜ Detailed breakdown of
config.ymland Y-height modes. - ➤ Commands & Permissions ➜ Complete reference table for commands and LuckPerms nodes.
- ➤ FAQ & Troubleshooting ➜ Performance tips and common questions.