ExplosionsTrimGrass

Explosions Trim Grass

Explosions, including creepers, will turn grass blocks into dirt, instead of breaking the blocks. Highly configurable!

Quick links:

• Star this repository on GitHub
• Support available on Discord

Consider donating:

• Bitcoin: 1H2ZvuceFzFzpaJxzfp7sjLBUuXNtG1YAz
• PayPal: https://paypal.me/justeli/5
• Stripe (Card, etc.): https://donate.stripe.com/fZe8y1bxr8EV7cYdQQ

Description

With this plugin, when a creeper explodes above grass blocks, it will not break the blocks, but instead turn grass blocks into dirt and coarse dirt. It will also break snow, flowers and crops. This is all configurable, however.

The graphics explain it all!

Configuration

The config is highly configurable, too!

# Disable entities that aren't mobs--like item frames and armor stands--to take damage from
#  explosions. So, disable damage done by explosions to those.
disable-damage-to-non-mobs: true

# Should trimming happen for any type of explosions, or just creepers?
only-enable-for-creepers: false

# Set values down here to what you want the global default to be for the section
#  'transform-blocks'. You can change the value per block, but these will be the
#  default, and can be overridden by adding it to the block section you don't
#  want the default value to apply for.
default-values:
  # Enable block modifications by explosions under this Y-level only.
  maximum-y-level: 512
  # Disable explosion block modification in GriefPrevention claims. Note that, down the
  #  config, it will be overridden for some blocks where it is set to 'true'.
  disable-in-claims: false
  # Disable block transformations by explosions in WorldGuard regions.
  #  Admin claims of GriefPrevention also count as regions.
  disable-in-regions: true

# Blocks that should be affected (transformed) by explosions are defined down here.
#  For example:
#  - 'stone':          is a block, so this is triggered when a stone block explodes
#  - 'etg:trimmable':  is not a block, so its block-list is defined down the config
# All allowed materials: https://jd.papermc.io/paper/org/bukkit/Material.html
#  If an invalid Material is used, its block-list must be defined at 'definitions'.
transform-blocks:
  # Not a Material (etg:trimmable), so its blocks are defined at 'definitions' down
  #  the config. In this case, it's: GRASS_BLOCK and MYCELIUM. What to do with these
  #  blocks when a creeper explosion effects these blocks?
  'etg:trimmable':
    # Convert the affected blocks (in this case GRASS_BLOCK and MYCELIUM) into ...
    conversion:
      # The affected block by the explosion will be converted to ...
      'coarse_dirt': 0.08   # 8% coarse dirt (can use a hoe in-game to make it dirt!)
      'dirt': 0.92          # and 92% dirt
  # This is a Material (STONE), so it is not defined down the config.
  'stone':
    # This value was already defined at 'default-values', and default set to 'false', but we
    #  want to override it for this block and only have it under sea-level for STONE.
    maximum-y-level: 64
    conversion:
      'infested_cobblestone': 0.01
      'cobblestone': 0.99
  'snow':
    conversion:
      # All snow layers will be broken (particle effects play) and set to AIR.
      'air': 1.00
  'etg:grasses':
    conversion:
      'air': 1.00
  'etg:leaves':
    # Override this value from its default (false), and set it to not break leaves by
    #  explosions in GriefPrevention claims.
    disable-in-claims: true
    conversion:
      'air': 1.00
  'etg:flowers':
    disable-in-claims: true
    conversion:
      'air': 1.00
  'etg:glass_panes':
    disable-in-claims: true
    conversion:
      # The exploded block will be converted to 20% air and 80% stay intact.
      'air': 0.20

# The definitions for non-existing lists of blocks, used above here.
definitions:
  'etg:trimmable':
    - grass_block
    - podzol
    - mycelium
  'etg:leaves':
    - oak_leaves
    - spruce_leaves
    - birch_leaves
    - jungle_leaves
    # etc.

It has been around on my server since 2015. If you want to check it out, check out my survival server on the address: survival.rocks!

Support

Leave any suggestions in the Discord server. Errors and issues can be reported on GitHub or in the Discord server.