!Banner

---

---

🟆 Features

• Interactive GUI Menu — Open a chest inventory with /claimparticles or /claimparts to browse particle styles or toggle borders on and off.
• Customizable GUI Items — Configure the exact Minecraft item, slot, display name, and lore that represents each particle in config.yml.
• Visual Claim Borders — Displays continuous, smooth particle outlines along claim boundaries so players clearly see their protected territory.
• Zero Flickering — Refreshes at an optimized 5-tick interval (4 times/sec) for a static border look rather than blinking.
• 10 Built-in Particle Options — Choose from Flame, Heart, Happy Villager, Angry Villager, Music Note, Enchantment, Nether Portal, Slime, Snowball, and Cloud.
• Broad Version Support (1.19.x to 26.2+) — Built using standard Bukkit/Spigot APIs with dynamic cross-version particle resolution.
• Flexible Height Modes
  • PLAYER — Borders dynamically follow the player's vertical elevation.
  • CUSTOM_RANGE — Renders a full 3D boundary cage across a custom Y level range.
• LuckPerms Integration — Gate specific particle effects behind permission nodes (e.g., for VIPs and donors).
• Unicast Packet Delivery — Spawns particles strictly for the player standing inside the claim, generating zero extra packets for other players.
• Admin Controls — Reload the configuration on the fly and remotely toggle particles for online players.

⚠ Requirements

• Minecraft: 1.19.x – 1.21.x+ (up to 26.2)
• Server Software: Bukkit, Spigot, Paper, or Purpur
• Java: 17 or higher
• Required Plugin: GriefPrevention

⟳ Installation

1. Ensure GriefPrevention is installed on your server.
2. Download the latest release of ClaimParticles.
3. Place ClaimParticles-1.0.0.jar into your server's plugins/ folder.
4. Start or restart your server.
5. Customize plugins/ClaimParticles/config.yml if desired.
6. Run /claimparticles reload to apply any configuration changes.

🗐 Commands

Command	Alias	Permission	Description
/claimparticles	/claimparts	None	Opens the interactive particle selection and toggle GUI.
/claimparticles toggle	/claimparts toggle	None	Quickly toggle claim border particles on or off.
/claimparticles type <particle>	/claimparts type <particle>	None / Perm	Switch particle type directly via command.
/claimparticles reload	/claimparts reload	claimparticles.admin.reload	Reload configuration, GUI items, and active tasks.
/claimparticles admin toggle <player>	/claimparts admin toggle <player>	claimparticles.admin.toggle	Toggle particle visibility 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 choices when per-particle perms are active.
claimparticles.particle.<name>	OP	Grants access to a specific particle type (e.g. claimparticles.particle.heart).

⚙ Configuration

ClaimParticles provides extensive customization in config.yml, including GUI item assignments, particle spacing, update intervals, height display modes, and per-particle permissions.

Example config.yml Snippet

default-enabled: true
default-particle: FLAME

particle-spacing: 0.5
update-interval: 5

y-mode: PLAYER
player-y-offset: 1.0

require-permissions-per-particle: false

# Interactive GUI Customization
gui:
  title: "&8Claim Particles"
  size: 27
  particles:
    flame:
      particle: FLAME
      material: BLAZE_POWDER
      slot: 10
      name: "&6&lFlame"
    heart:
      particle: HEART
      material: POPPY
      slot: 11
      name: "&c&lHeart"

~~~~