Fill Action

The fill action lets you fill a cuboid region with a set of blocks. Here is an example that will set under the player's feet in a 100-block radius all the ground to a mix of gold blocks, netherrack, and cobblestone:

# This is placed inside an event just like any other action is
fill 1:
    # * Will happen on the target which in this case is the origin player of the disaster
    target: 'player'
    # Partition lets you divide the fill operation to be finished in X amount of server ticks, use for large fills to not freeze the server (default: 0)
    partition: 10
    # If fill solids is set to true then only solid blocks will be replaced
    fillSolids: true
    # * Coordinates for first position (bottom corner) of the cuboid region, remember the '~' means relative to the targets coordinates so this will happen X-50 Y-20 Z-50 relative to the targets coordinates
    firstPoint:
        x: ~-50
        y: ~-20
        z: ~-50
    # * Coordinates for second position (top corner) of the cuboid region
    secondPoint:
        x: ~50
        y: ~0
        z: ~50
    # List of materials you want to be used to fill in region, will select a random assortment from list for each block (default: AIR) this will make the entire cuboid region a random assortment of the following blocks
    # Names of materials are the in-game names
    materials:
    - gold_block
    - netherrack
    - cobblestone
    # You can use either a whitelist or blacklist to decide what gets filled, the users blacklisted blocks will not be removed regardless
    # In this example we use a whitelist, what this means is inside our cuboid region only the following blocks will be replaced by our assortment of blocks
    whitelist:
    - grass
    - dirt
    - stone

Now that you have seen an example of a whitelist fill here is an example of a blacklist fill instead. This will fill a 10-block radius area into air under every players foot in the world ignoring any bedrock or obsidian blocks:

fill 2:
    # Target set to all players in the world
    target: 'all'
    firstPoint:
        x: ~-10
        y: ~-5
        z: ~-10
    secondPoint:
        x: ~10
        y: ~0
        z: ~10
    # The blacklist works the reverse of the whitelist, so this will set every block that isn't obsidian or bedrock into our assortment of blocks which in this case is the default 'AIR'
    blacklist:
    - bedrock
    - obsidian