> 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/edmortars/mortars/mortar-types.md).

# Mortar Types & Placement

A mortar type is one file in `plugins/EdMortars/mortars/`. The file name is its id (`default.yml` = `default`). Copy the file to make another type: each type is unlocked and upgraded on its own, so a mine type can even hold two different mortars.

## How a mortar behaves

* **One per mine.** Every loaded mine whose type lists a `type: mortar` placeable gets its own mortar.
* **Owned by the mine owner.** Its state (locked / unlocked, upgrades, cooldown) is the owner's. Everyone viewing the mine sees it and its shots, but only the owner can click it (others get `not-your-mortar`).
* **Locked:** clicking it opens the unlock menu. **Unlocked:** clicking it opens the upgrades menu, and every block the owner mines rolls the fire chance.
* `/mortar [type]` opens the same menu from anywhere while the mine is loaded.

## Top-level options

| Key                                    | Meaning                                                                                                 |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `display-name`                         | Name used in menus, holograms and messages (`{mortar}`)                                                 |
| `click`                                | Which click opens the menus: `right`, `left` or `both`                                                  |
| `models`                               | The look, see [Looks & Custom Models](/p/edmortars/mortars/looks.md)                                    |
| `menus.unlock` / `menus.upgrades`      | PinnaPrison GUI ids it opens (default `mortar-unlock` / `mortar-upgrades`)                              |
| `hologram`                             | Text above the mortar, see [Hologram](/p/edmortars/mortars/hologram.md)                                 |
| `unlock`                               | Requirements and unlock actions, see [Unlocking](/p/edmortars/mortars/unlocking.md)                     |
| `trigger`                              | `afk-block` (AFK block breaks roll too), `only-in-own-mine` (only while the owner stands in their mine) |
| `fire`, `shell`, `target`, `explosion` | The shot, see [Shots & Rewards](/p/edmortars/mortars/shots-rewards.md)                                  |
| `upgrades`                             | See [Upgrades](/p/edmortars/mortars/upgrades.md)                                                        |

## Placing it in a mine

```yaml
# plugins/PinnaPrison/privatemines/mines/<type>.yml
placeables:
  mortar1:
    type: mortar
    mortar: default
    position: '8.5,89,-9.5,-45,0'
```

Use one placeable per mortar type. A different type per mine type (bigger mortar for bigger mines) is just another file and another `mortar:` value. `/mp move mortar1` moves it in-game.