All Wikis
DownloadDonate

Block Damage

Block Damage is used for Explosion and in WeaponMechanicsCosmetics.

Advanced Block Damage tutorial
    Block_Damage:
      Drop_Broken_Block_Chance: <Chance>
      Damage_Per_Hit: <Integer>
      Default_Block_Durability: <Integer>
      Default_Mode: <CANCEL/BREAK/CRACK>
      Default_Mask: <Material>
      Blocks:
        - <Material*> <CANCEL/BREAK/CRACK*> <ShotsToBreakBlock> <Mask>

Drop_Broken_Block_Change

The chance to drop the broken block as an item for players to pick up. Defaults to 0%.

Damage_Per_Hit

The amount of damage points to deal to the block. Defaults to 1.

Default_Block_Durability

Defines how many hits it takes to break blocks. This can be overridden per block in Blocks.

Default_Mode

Defines how the block should show damage:

  • CANCEL -> Don't apply any damage to the block.

  • CRACK -> Show block crack animation, but do not break the blocks.

  • BREAK -> Show block crack animation, and break block when fully damaged.

This can be overridden per block in Blocks.

Default_Mask

This can be overridden per block in Blocks.

If you want to replace blocks with data (for example, stairs), go into:

server -> plugins -> WeaponMechanics -> config.yml

And set:

Explosions:
  Attempt_Copy_Data: true  # set this to true

Blocks

Defines the list of block overrides.

Format is:

<block to break> <CANCEL/CRACK/BREAK> <shots to break> <mask>

Examples:

  • BEDROCK CANCEL -> Prevents bedrock from being broken.

  • DIRT BREAK -> Destroys dirt in 1 shot.

  • OBSIDIAN CRACK 5 -> Shows the crack animation for obsidian, but doesn't break.

  • GRAY_STAINED_GLASS BREAK 1 DIRT -> Destroys gray glass in 1 shot and replaces it with dirt.

  • $glass BREAK 2 breaks all glass block types in 2 shots.

Example

This is a standard example that the average server should use. This example will break all blocks (except for non-breakable blocks):

    Block_Damage:
      Spawn_Falling_Block_Chance: 0.55  # Used for Explosions
      Default_Mode: BREAK
      Blocks:
        - "BEDROCK cancel"
        - "$WATER cancel"  # stationary_water and moving_water for 1.12 support
        - "OBSIDIAN cancel"
        - "$LAVA cancel"  # stationary_lava and moving_lava for 1.12 support

Last updated