> 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/pinnaprison/tools-and-items/drills.md).

# Drills

A drill is placed in a mine and bores **straight down** through layers of blocks until it hits the mine floor (or a stop block). Configured in `drills.yml`.

```yaml
enabled: true
not-in-mine-message: '&cYou can only use drills inside a mine!'

drills:
  common:
    name: 'Common Drill'
    mine-radius: 2
    seconds-per-layer: 1.0
    max-layers: 0
    drill-block: HOPPER
    stop-when-touching: BEDROCK
    affect-block-currencies: false
    affect-autosell: true
    affect-tokengreed: false
    place-message: '&b&lDRILL &7activated! It will mine straight down.'
    finish-message: '&b&lDRILL &7finished! Mined &b{blocks} &7blocks over &b{layers} &7layers.'
    commands-on-place: []
    commands-on-finish: []
    item:
      material: HOPPER
      name: '&a&lCommon Drill'
      glow: true
      lore:
        - '&7Use this drill in your mine to bore down to bedrock.'
        - '&a[ʀɪɢʜᴛ ᴄʟɪᴄᴋ ᴛᴏ ᴜѕᴇ]'
```

## Global

| Key                   | Description                         |
| --------------------- | ----------------------------------- |
| `enabled`             | Master toggle for the drill system. |
| `not-in-mine-message` | Sent when used outside a mine.      |

## Per-drill (`drills.<id>`)

| Key                       | Description                                                                                        |
| ------------------------- | -------------------------------------------------------------------------------------------------- |
| `name`                    | Display name.                                                                                      |
| `mine-radius`             | Horizontal radius of each cleared layer.                                                           |
| `seconds-per-layer`       | Delay between layers (lower = faster).                                                             |
| `max-layers`              | Max layers to drill. `0` = drill until it reaches the mine floor.                                  |
| `drill-block`             | The visual drill head (shown to watchers only).                                                    |
| `stop-when-touching`      | The drill stops if it touches this material (e.g. `BEDROCK`).                                      |
| `affect-block-currencies` | Broken blocks pay block currencies (rankup/pickaxe XP).                                            |
| `affect-autosell`         | Broken blocks go to the backpack / autosell.                                                       |
| `affect-tokengreed`       | Broken blocks also pay the Token Greed enchant.                                                    |
| `place-message`           | Chat message when the drill starts.                                                                |
| `finish-message`          | Chat message when it finishes (`{blocks}`, `{layers}`).                                            |
| `commands-on-place`       | [Action lines](/p/pinnaprison/customization/item-format.md#actions) run on placement (`{player}`). |
| `commands-on-finish`      | Action lines run on finish (`{player}`, `{blocks}`, `{layers}`).                                   |
| `item`                    | The drill item (`material`, `name`, `glow`, `lore`).                                               |

## Usage

* **Right-click** a drill item inside your mine → starts drilling down the column you're aiming at.
* Admins: **`/drill give <player> <drill-id> [amount]`** (alias `/drills`).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://edseries-plugins.gitbook.io/p/pinnaprison/tools-and-items/drills.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.