ParticleGrenades REQUIRES<\/strong> ParticleProjectileApi:<\/p>\n https:\/\/modrinth.com\/plugin\/particleprojectileapi<\/p>\n WorldGuard<\/strong> for region protection flags<\/p>\n Flags:<\/p>\n 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<\/p>\n “` # Ticks before the grenade explodes # Should the grenade explode when a player\/mob gets to close? # If so how close do they need to be? # Should it explode upon hitting something? # Explosion particles # List of materials affected by the explosion # When a particle hits a block… # Break it naturally IE item drops if applicable # Converts from one set of blocks to another at random # Destroy it by completely removing it # Throw the block # When a particle passes through a block… # Break it naturally IE item drops if applicable # Convert randomly to one of the following blocks # Destroy it by completely removing it # Do nothing but still go through the block (Can still be thrown) # Number of actual projectiles generated (Higher numbers requires more server resources) # How much damage a particle deals to an entity (1.0 = half heart, can be 0) # Velocity of the explosion particles (In meters per second, 1 block = 3 meters) # Time the particle has to exist (seconds) before disappearing # Force multiplier of the explosion (Knockback effect upon hitting an entity) # Size of the hitbox for particles # Explosion particle type # Explosion color as a hexadecimal value (If applicable to any particles) # Smoke trail particles # Is smoke enabled? # Smoke color # Amount of grenades the recipe gives # Ingredients needed, the first ingredient listed will be ‘a’ the second ‘b’, third ‘c’, and so on (Max of nine ingredients) # Crafting grid using above ingredients letters (Each line may contain up to three different letters and there may only be one to three lines) <\/p>\n
\nOptional<\/h3>\n
\n
\nDescription<\/h1>\n
Features<\/h2>\n
\n
\n (0.3.4 adds the ability for grenades to have multiple particles)<\/li>\n
\n particlegrenade.use.<node> (Look at configuration below for help)<\/li>\n
\n (Requires permission node)<\/li>\nCommands<\/h2>\n
\n
\n Reloads the config.yml to update changes and change recipes on the fly
\n Requires the permission particlegrenades.reload<\/i><\/li>\n
\n Lists availble grenades to that player if they can use commands to give
\n Requires the permission particlegrenades.list<\/i><\/li>\n
\n Allows players with proper permissions to give specified amount of grenade to themselves
\n Requires the permission particlegrenades.give.<internal name>
\n (Internal name is found in config)<\/i><\/li>\n
\n Spawns the specified grenade at the chosen coordinates<\/i><\/li>\n<\/ul>\nConfiguration<\/h2>\n
default.yml<\/h3>\n
\nname: ‘&4&lGrenade’
\ndescription:
\n– ‘&6A throwable explosive’
\n– ‘&6Warning: &cContains Explosives!’
\ndistance: 1.5
\nbehavior:<\/p>\n
\n fuse: 100<\/p>\n
\n proximity: false<\/p>\n
\n radius: 2.0<\/p>\n
\n impact: false
\ncooldown: 60
\nsound: entity.generic.explode:10.0:0.5
\neffects:
\n– weakness:1:60
\n– slowness:1:60
\nparticles:<\/p>\n
\n explosion:<\/p>\n
\n # A question mark ‘?’ can be used as a wildcard
\n # Using ‘RED?’ will include ‘REDSTONE’ but not ‘POWERED_RAILS’
\n # Using ‘?RED’ will not include ‘REDSTONE’ or ‘POWERED_RAILS’
\n # Using ‘?RED?’ will include everything with ‘RED’ in its name
\n # Using ‘?’ will include all blocks
\n # Other available placeholders include:
\n # ‘burnable’ (Includes all blocks that can burn away
\n # ‘flammable’ (Includes all blocks that can catch fire)
\n # ‘logs’, ‘leaves’ , ‘planks’ (Are self-explanatory as they include every type they describe)
\n # a hyphen (‘-‘) can be used to negate a certain block\/placeholder such as ‘-logs’ will not include any logs
\n # Adding %<#> to the end of a query can add a chance for that material to be affected such as ‘stone%10’ will add
\n # a 10 percent chance for stone to be affected
\n blocks:<\/p>\n
\n on_hit:<\/p>\n
\n break:
\n – leaves
\n – ?stone?
\n – diorite
\n – andesite
\n – granite
\n – dirt
\n – grass_block
\n – logs<\/p>\n
\n # ‘?,-logs:air%10’ will convert all blocks except logs to air with a 10 percent chance of becoming air
\n convert:
\n – grass_block:dirt
\n – dirt:gravel
\n – gravel:sand
\n – sand:air%50<\/p>\n
\n destroy:
\n – ?glass%90<\/p>\n
\n throw:
\n – sand<\/p>\n
\n on_penetrate:<\/p>\n
\n break:
\n – leaves
\n – ?grass<\/p>\n
\n convert: []<\/p>\n
\n destroy:
\n – ?glass?<\/p>\n
\n ignore:
\n – water<\/p>\n
\n # (Going higher than 10000 can potentially cause severe server lag)
\n fragments: 512<\/p>\n
\n damage: 1.0<\/p>\n
\n velocity: 2048.0<\/p>\n
\n lifespan: 0.5<\/p>\n
\n force: 1.0<\/p>\n
\n hitbox: 0.2<\/p>\n
\n # Can use percentages
\n particles:
\n – lava%50
\n – flame<\/p>\n
\n color:
\n from: 7f7f00
\n to: 7f7f7f<\/p>\n
\n smoke:<\/p>\n
\n enabled: true<\/p>\n
\n color: 7f7f7f
\nrecipe:<\/p>\n
\n amount: 1<\/p>\n
\n # 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
\n # To specify a specific character to represent the ingredient use
\n ingredients:
\n – a:iron_ingot
\n – b:gunpowder<\/p>\n
\n grid:
\n – ‘ a ‘
\n – ‘aba’
\n – ‘ a ‘
\n“`<\/p>\nParticleGrenades in Action<\/h3>\n