> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/features/drills.md).

# Drills

Drills (`drills.yml`) are placeable items that **mine straight down**, layer by layer, until they hit a stop material (e.g. bedrock). Each layer is a square column around the placement point.

```yaml
CommonDrill:
  worlds-blocked:
    - "spawn"
  drill-stop-when-touching: BEDROCK
  mine-radius: 2
  seconds-per-layer: 1
  affect-autosell: true
  commands-on-place:
    - "edp msg %player% drill placed"
  commands-on-finish:
    - "edp msg %player% drill mined %blocks% blocks. And also mined %layers% layers"
  item:
    name: '&a&lCommon Drill'
    material: HOPPER
    glowing: true
    lore:
      - "&7Place this &a&lCommon"
      - "&7drill onto your mine"
      - "&7to mine straight to bedrock"
      - ""
      - "&7&o(( Right click to use ))"
```

How drills work? You just need to create a drill with a mine-radius. Then when you place it it will mine right straight to the bottom in that radius until it touches the block at drill-stop-when-touching. The option seconds-per-layer means that how many seconds will it take to mine 1 layer.

## Options

| Key                        | Type     | Description                                                                                 |
| -------------------------- | -------- | ------------------------------------------------------------------------------------------- |
| `worlds-blocked`           | list     | Worlds where placing is denied (`DRILL_CANT_PLACE` message).                                |
| `drill-stop-when-touching` | material | The drill stops when it reaches this material.                                              |
| `mine-radius`              | number   | Horizontal radius of the mined column.                                                      |
| `seconds-per-layer`        | number   | Delay between layers.                                                                       |
| `affect-autosell`          | boolean  | Sell mined blocks through [autosell](/p/features/autosell.md).                              |
| `commands-on-place`        | list     | Commands run when placed.                                                                   |
| `commands-on-finish`       | list     | Commands run when the drill finishes. `%blocks%` = blocks mined, `%layers%` = layers mined. |
| `item`                     | section  | Standard [item format](/p/utils/items.md). Tagged with NBT `edprison_drill`.                |

Placement is validated against the WorldGuard `edp-enchants` flag, so drills only work inside your flagged mines. One drill item is consumed per placement.

## Command

| Command                                 | Permission              | Description                     |
| --------------------------------------- | ----------------------- | ------------------------------- |
| `/drill give <player> <drill> [amount]` | `edprison.drills.admin` | Gives drills. Alias: `/drills`. |