Compatibility
Minecraft: Java Edition
1.21.x
Platforms
Tags
Creators
Details
Licensed MIT
Published 4 days ago
Updated 3 weeks ago

ClaimParticles
ClaimParticles is a lightweight and highly customizable GriefPrevention addon for Paper-based Minecraft servers that lets players visualize their claims using smooth particle borders.
🟆 Features
- Visual Claim Borders — Display GriefPrevention claim boundaries using smooth, static particle effects.
- 10 Built-in Particle Effects — Choose from Flame, Heart, Happy Villager, Angry Villager, Note, Enchantment Table, Portal, Slime, Snowball, and Cloud.
- Highly Customizable — Configure particle spacing, update interval, default particles, height modes, Y ranges, and more.
-
Flexible Height Modes
PLAYER— Particles follow the player's vertical position.CUSTOM_RANGE— Display full 3D claim boundaries across a configurable Y range.
- LuckPerms Integration — Control access to individual particle types using permissions.
- Simple Commands — Toggle particles and change particle types directly in-game.
- Tab Completion — Quickly select particles and players with command autocomplete.
- Admin Controls — Reload the configuration and remotely toggle particles for online players.
- Lightweight — Designed to provide clean claim visualization without unnecessary features or dependencies.
⚠ Requirements
- Minecraft: 1.21.x
- Server: Paper, Spigot, or Purpur
- Java: 21+
- Required Plugin: GriefPrevention
⟳ Installation
- Install GriefPrevention on your server.
- Download the latest version of ClaimParticles.
- Place
ClaimParticles.jarinto your server'splugins/folder. - Start or restart your server.
- Customize
plugins/ClaimParticles/config.ymlif desired. - Use
/claimparticles reloadafter changing the configuration.
🗐 Commands
| Command | Permission | Description |
|---|---|---|
/claimparticles [toggle] |
None | Toggle claim particle visibility for yourself. |
/claimparticles type <particle> |
None | Change your active particle effect. |
/claimparticles reload |
claimparticles.admin.reload |
Reload the plugin configuration. |
/claimparticles admin toggle <player> |
claimparticles.admin.toggle |
Toggle particles for another online player. |
ⓘ Permissions
| Permission | Default | Description |
|---|---|---|
claimparticles.admin.reload |
OP | Allows reloading the plugin configuration. |
claimparticles.admin.toggle |
OP | Allows toggling particles for other players. |
claimparticles.particle.all |
Everyone | Grants access to all particle types. |
claimparticles.particle.<name> |
OP | Grants access to a specific particle type. |
⚙ Configuration
ClaimParticles provides extensive configuration options through
config.yml, including particle spacing, update frequency,
height modes, custom Y ranges, and per-particle permissions.
Example
default-enabled: true
default-particle: FLAME
particle-spacing: 0.5
update-interval: 5
y-mode: PLAYER
player-y-offset: 1.0
custom-y-min: 60.0
custom-y-max: 100.0
custom-y-step: 2.0
require-permissions-per-particle: false


