ParticleGrenades icon

ParticleGrenades -----

Custom, Configurable, Craftable Grenades With Realistic Physics and Particles!



Notice
ParticleGrenades REQUIRES ParticleProjectileApi:

Optional
WorldGuard for region protection flags

Flags:
block-break
damage-animals
pvp
potion-splash
Description
Particle Grenades is a plugin designed to allow servers to craft custom grenades that explode with custom particles projectiles that apply effects to entities. These grenades are highly configurable via a configuration file. This config file allows the editor to set almost everything about the grenade. Once a player crafts a custom particle grenade, all they need to do to launch it is to drop it whilst sneaking, as long as they have the correct permission node. This will in turn fire the dropped grenade in the direction the player was looking and will proceed to explode after its timer has expired. There can be multiple grenades with multiple effects in the config as well, thus allowing a whole host of fun and exciting options!

Features
  • Have multiple grenades
  • Different particles (Some can be colored)!
    (0.3.4 adds the ability for grenades to have multiple particles)
  • Different sounds for explosions
  • Each grenade requires a permission node
    particlegrenade.use.<node> (Look at configuration below for help)
  • Multiple effects
  • Colored smoke trails
  • Give command
    (Requires permission node)
  • Grenades push entities when exploding
  • Custom crafting recipes
  • Custom display name and lore for grenades
  • Color code support for display names and lore
  • Optional and highly configurable block damage
  • Crafted grenades can be placed as custom tnt blocks! (Since 0.3.4+)
  • Grenades can be used with dispensers! (Since 0.3.4+)
  • Highly configurable
  • WorldGuard Support!
Commands
  • /pgreload
    Reloads the config.yml to update changes and change recipes on the fly
    Requires the permission particlegrenades.reload
  • /pglist
    Lists availble grenades to that player if they can use commands to give
    Requires the permission particlegrenades.list
  • /pggive <grenade> [amount]
    Allows players with proper permissions to give specified amount of grenade to themselves
    Requires the permission particlegrenades.give.<internal name>
    (Internal name is found in config)
  • /pgspawn <grenade> <x> <y> <z>
    Spawns the specified grenade at the chosen coordinates
Configuration

Version 0.3.3 and earlier:
Code (Text):

# List of all ingredients (Materials), effects, particles, and sounds can be found in the auto-generated materials.txt, effects.txt, particles.txt, and sounds.txt
# All times are in ticks (20 ticks = 1 second)
# Colorable particle types: REDSTONE, SPELL_MOB, and SPELL_MOB_AMBIENT
# Internal name of grenade and permission ('particlegrenades.use.default' and 'particlegrenades.give.default')
default:
  # Name that will be displayed on the crafted item
  name: '&4&lGrenade'
  # Each line will be a line of lore on the item
  description:
  - '&6A throwable explosive'
  - '&6Warning: &cContains Explosives!'
 
  # How far the grenade is thrown
  distance: 1.5
 
  # Sound of explosion
  sound:
    # Type of sound
    type: ENTITY_GENERIC_EXPLODE
 
    # Volume of the sound
    volume: 4.0
 
    # Pitch of the sound
    pitch: 0.8
  # Settings for particles
  particles:
    # Explosion particles
    explosion:
 
      # List of materials affected by the explosion
      # A question mark '?' can be used as a wildcard
      # Using 'RED?' will include 'REDSTONE' but not 'POWERED_RAILS'
      # Using '?RED' will not include 'REDSTONE' or 'POWERED_RAILS'
      # Using '?RED?' will include everything with 'RED' in its name
      # Using '?' will include all blocks
      blocks:
 
        # When a particle hits a block...
        on_hit:
 
          # Break it naturally IE item drops if applicable
          break:
          - ?_LEAVES
          - ?STONE?
          - DIORITE
          - ANDESITE
          - GRANITE
          - DIRT
          - GRASS_BLOCK
          - ?LOG
 
          # Destroy it by completely removing it
          destroy:
          - ?GLASS
 
        # When a particle passes through a block...
        on_penetrate:
 
          # Break it naturally IE item drops if applicable
          break:
          - ?LEAVES
          - ?GRASS
 
          # Destroy it by completely removing it
          destroy:
          - ?GLASS?
 
          # Do nothing but still go through the block
          ignore:
          - WATER
 
      # Number of actual projectiles generated (Higher numbers requires more server resources)
      fragments: 256
      # How much damage a particle deals to an entity (1.0 = half heart, can be 0)
      damage: 1.0
 
      # Velocity of the explosion particles (In meters per second, 1 block = 3 meters)
      velocity: 512.0
 
      # Time the particle has to exist (seconds) before disappearing
      lifespan: 0.125
      # Force multiplier of the explosion
      force: 1.0
 
      # Size of the hitbox for particles
      hitbox: 0.2
 
      # Explosion particle type
      particle: LAVA
 
      # Explosion color (If applicable)
      color:
        from:
          # Amount of red (0 - 255)
          red: 127
          # Amount of green (0 - 255)
          green: 127
          # Amount of blue (0 - 255)
          blue: 0
        to:
          # Amount of red (0 - 255)
          red: 127
          # Amount of green (0 - 255)
          green: 127
          # Amount of blue (0 - 255)
          blue: 127
    # Smoke trail particles
    smoke:
 
      # Is smoke enabled?
      enabled: true
      # Smoke color
      color:
        # Amount of red (0 - 255)
        red: 127
 
        # Amount of green (0 - 255)
        green: 127
 
        # Amount of blue (0 - 255)
        blue: 127
  # Ticks before the grenade explodes
  fuse: 100
  # Time before player is able to throw another of this grenade
  cooldown: 60
  # Potion effects to apply to entities hit by particles
  effects:
   # Potion effect
    WEAKNESS:
      # Multiplier
      amplifier: 1
      # Duration in ticks
      duration: 60
  # Recipe for the grenade
  recipe:
    # Amount of grenades the recipe gives
    amount: 1
    # Ingredients needed, the first ingredient listed will be 'a' the second 'b', third 'c', and so on (Max of nine ingredients)
    ingredients:
    - IRON_INGOT
    - GUNPOWDER
    - AIR
    # Crafting grid using above ingredients letters (Each line may contain up to three different letters and there may only be one to three lines)
    grid:
    - cac
    - aba
    - cac
 
Version 0.3.4+
Code (Text):

# List of all ingredients (Materials), effects, particles, and sounds can be found in the auto-generated materials.txt, effects.txt, particles.txt, and sounds.txt
# All times are in ticks (20 ticks = 1 second)
# Colorable particle types: REDSTONE, SPELL_MOB, and SPELL_MOB_AMBIENT

# Internal name of grenade and permission ('particlegrenades.use.default' and 'particlegrenades.give.default')
default:

  # Name that will be displayed on the crafted item
  name: '&4&lGrenade'

  # Each line will be a line of lore on the item
  description:
    - '&6A throwable explosive'
    - '&6Warning: &cContains Explosives!'

  # How far the grenade is thrown
  distance: 1.5

  behavior:

    # Ticks before the grenade explodes
    fuse: 100

    # Should the grenade explode when a player/mob gets to close?
    proximity: false

    # If so how close do they need to be?
    radius: 2.0

    # Should it explode upon hitting something?
    impact: false


  # Time before player is able to throw another of this grenade (In ticks)
  cooldown: 60

  # Sound of explosion
  # Format <sound>:<volume>:<pitch>
  sound: entity.generic.explode:10.0:0.5

  # Potion effects to apply to entities hit by particles
  #List of effects with format of <effect>:<amplifier>:<duration in ticks>
  effects:
    - weakness:1:60
    - slowness:1:60

  # Settings for particles
  particles:

    # Explosion particles
    explosion:

      # List of materials affected by the explosion
      # A question mark '?' can be used as a wildcard
      # Using 'RED?' will include 'REDSTONE' but not 'POWERED_RAILS'
      # Using '?RED' will not include 'REDSTONE' or 'POWERED_RAILS'
      # Using '?RED?' will include everything with 'RED' in its name
      # Using '?' will include all blocks
      # Other available placeholders include:
      # 'burnable' (Includes all blocks that can burn away
      # 'flammable' (Includes all blocks that can catch fire)
      # 'logs', 'leaves' , 'planks' (Are self-explanatory as they include every type they describe)
      # a hyphen ('-') can be used to negate a certain block/placeholder such as '-logs' will not include any logs
      # Adding %<#> to the end of a query can add a chance for that material to be effected such as 'stone%10' will add
      #   a 10 percent chance for stone to be effected
      blocks:

        # When a particle hits a block...
        on_hit:

          # Break it naturally IE item drops if applicable
          break:
            - leaves
            - ?stone?
            - diorite
            - andesite
            - granite
            - dirt
            - grass_block
            - logs

          # Converts from one set of blocks to another at random
          # '?,-logs:air%10' will convert all blocks except logs to air with a 10 percent chance of becoming air
          convert:
            - grass_block:dirt
            - dirt:gravel
            - gravel:sand
            - sand:air%50

          # Destroy it by completely removing it
          destroy:
            - ?glass%90

          # Throw the block
          throw:
            - sand

        # When a particle passes through a block...
        on_penetrate:

          # Break it naturally IE item drops if applicable
          break:
            - leaves
            - ?grass

          # Convert randomly to one of the following blocks
          convert: []

          # Destroy it by completely removing it
          destroy:
            - ?glass?

          # Do nothing but still go through the block (Can still be thrown)
          ignore:
            - water

      # Number of actual projectiles generated (Higher numbers requires more server resources)
      # (Going higher than 10000 can potentially cause severe server lag)
      fragments: 512

      # How much damage a particle deals to an entity (1.0 = half heart, can be 0)
      damage: 1.0

      # Velocity of the explosion particles (In meters per second, 1 block = 3 meters)
      velocity: 2048.0

      # Time the particle has to exist (seconds) before disappearing
      lifespan: 0.5

      # Force multiplier of the explosion (Knockback effect upon hitting an entity)
      force: 1.0

      # Size of the hitbox for particles
      hitbox: 0.2

      # Explosion particle type
      # Can use percentages
      particles:
        - lava%50
        - flame

      # Explosion color as a hexadecimal value (If applicable to any particles)
      color:
        from: 7f7f00
        to: 7f7f7f

    # Smoke trail particles
    smoke:

      # Is smoke enabled?
      enabled: true

      # Smoke color
      color: 7f7f7f

  # Recipe for the grenade
  recipe:

    # Amount of grenades the recipe gives
    amount: 1

    # Ingredients needed, the first ingredient listed will be 'a' the second 'b', third 'c', and so on (Max of nine ingredients)
    # the first item on the list is represented be the letter a, b for second and so forth. An empty space can be the letter after the last item
    ingredients:
      - iron_ingot
      - gunpowder

    # Crafting grid using above ingredients letters (Each line may contain up to three different letters and there may only be one to three lines)
    grid:
      - cac
      - aba
      - cac

 

ParticleGrenades in Action




Affiliates
Thinking about getting a dedicated server? Try Kinetic hosting!
Save 15% on your first month by using code 'UberDiscount' at checkout!
Click the image or link below to get started now!

Terms:
  1. You do NOT have permission to decompile this plugin
  2. You do NOT have permission to redistribute this plugin
  3. You do NOT have permission to re-upload this plugin
  4. You do NOT have permission to leave a bad review because of a bug or missing feature
  5. You do NOT have permission to chargeback, If you really need a refund, please message me why and I will refund you accordingly!
  6. You DO have permission to leave a honest review
  7. You DO have permission to contact me with any questions, concerns, or suggestions.
Resource Information
Author:
----------
Total Downloads: 23
First Release: Nov 28, 2017
Last Update: Oct 13, 2024
Category: ---------------
All-Time Rating:
3 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings