ActionParticles

ActionParticles is a lightweight and highly customizable plugin for Minecraft servers that adds visual particle effects for various player actions.

Features:

• Spawns particles on player join, quit, death, and teleport
• Fully configurable via configuration file
• Support for multiple particle types per event
• Configurable delay before particle spawn
• Random particle selection from configured list
• Asynchronous particle spawning for better performance
• Permission-based bypass system for each event
• Tab completion for all commands
• Reload configuration without server restart
• Test command to preview particles for any event

Commands:

• /actionparticles reload or /aparticles reload - Reload configuration
• /actionparticles test <event> or /aparticles test <event> - Test particles for a specific event
• /actionparticles help or /aparticles help - Show help menu

Events:

• join - Triggers when player joins the server
• quit - Triggers when player leaves the server
• death - Triggers when player dies
• teleport - Triggers when player teleports

Permissions:

• actionparticles.use - Allows using commands
• actionparticles.reload - Allows reloading configuration
• actionparticles.test - Allows testing particles
• actionparticles.bypass - Bypass all particle effects
• actionparticles.bypass.join - Bypass join particles
• actionparticles.bypass.quit - Bypass quit particles
• actionparticles.bypass.death - Bypass death particles
• actionparticles.bypass.teleport - Bypass teleport particles

Configuration: All settings are managed in the config.yml file. Each event (join, quit, death, teleport) can be independently configured with:

• enabled - Enable/disable particle spawning for this event
• delay - Delay in ticks before spawning (-1 for instant)
• particles - List of particle types with customizable count, speed, offset, and position

particles:
  on-join:
    enabled: true
    delay: -1  # Delay in ticks (-1 for instant)
    particles:
      - type: "FIREWORKS_SPARK"
        count: 100
        speed: 0.1
        offset:
          x: 0.1
          y: 0.5
          z: 0.1
        position:
          x: 0.0
          y: 1.0
          z: 0.0

  on-quit:
    enabled: true
    delay: -1
    particles:
      - type: "ASH"
        count: 150
        speed: 1.0
        offset:
          x: 0.1
          y: 0.5
          z: 0.1
        position:
          x: 0.0
          y: 1.0
          z: 0.0
      - type: "SMOKE"
        count: 100
        speed: 0.1
        offset:
          x: 0.2
          y: 0.6
          z: 0.2
        position:
          x: 0.0
          y: 1.2
          z: 0.0

  on-death:
    enabled: true
    delay: -1
    particles:
      - type: "SMOKE"
        count: 150
        speed: 0.1
        offset:
          x: 0.1
          y: 0.5
          z: 0.1
        position:
          x: 0.0
          y: 1.0
          z: 0.0

  on-teleport:
    enabled: true
    delay: -1
    particles:
      - type: "ENCHANT"
        count: 100
        speed: 0.5
        offset:
          x: 0.1
          y: 0.5
          z: 0.1
        position:
          x: 0.0
          y: 1.0
          z: 0.0
      - type: "PORTAL"
        count: 200
        speed: 0.3
        offset:
          x: 0.1
          y: 0.5
          z: 0.1
        position:
          x: 0.0
          y: 1.0
          z: 0.0

Supported Versions: 1.16+