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

# Permissions

## Permissions

Grant command permissions to staff. Configure mine requirements to control player access.

## 🔐 Command permissions

| Permission                    | Grants                                                                |
| ----------------------------- | --------------------------------------------------------------------- |
| `simplymines.admin`           | Open the main GUI (`/sm`) and the per-mine editor (`/sm edit`).       |
| `simplymines.tool`            | Toggle the selection wand on/off (`/sm tool`).                        |
| `simplymines.select`          | Use the wand to actually mark corners once it's toggled on.           |
| `simplymines.create`          | Create new mines (`/sm create`).                                      |
| `simplymines.reset`           | Force-reset a mine (`/sm reset`).                                     |
| `simplymines.move`            | Move/reassign a mine's region (`/sm reassign`).                       |
| `simplymines.rename`          | Rename a mine (`/sm rename`).                                         |
| `simplymines.save`            | Force-save a mine to disk (`/sm save`).                               |
| `simplymines.setteleport`     | Set a mine's teleport point (`/sm setteleport`).                      |
| `simplymines.teleport`        | Base permission required to use `/sm teleport` at all.                |
| `simplymines.teleport.<mine>` | Per-mine permission required in addition to the base one — see below. |
| `simplymines.disable`         | Disable a mine's auto-reset timer (`/sm disable`).                    |
| `simplymines.enable`          | Re-enable a mine's auto-reset timer (`/sm enable`).                   |
| `simplymines.delete`          | Permanently delete a mine (`/sm delete`).                             |
| `simplymines.reload`          | Reload config/mines (`/sm reload`).                                   |

***

## 🚀 Per-mine teleport permission

`/sm teleport <name>` checks `simplymines.teleport.<name>` on top of the base `simplymines.teleport` permission.\
This lets you grant a group access to teleport to specific mines only:

{% code title="permissions config example" %}

```yaml
groups:
  vip:
    permissions:
      - simplymines.teleport
      - simplymines.teleport.diamond
      - simplymines.teleport.emerald
```

{% endcode %}

{% hint style="warning" %}
A player without `simplymines.teleport.<name>` for a given mine is denied even if they have the base `simplymines.teleport` permission.
{% endhint %}

***

## 🧩 Mine requirement permissions (set per-mine by admins)

Separately from the command permissions above, admins can attach a **permission mine requirement** through the GUI or [API / Developer Guide](/simplymines-docs/introduction/api-developer-guide.md). This gates whether a player can break blocks in that mine.

{% hint style="info" %}
The permission node itself is arbitrary and chosen by whoever configures the mine (e.g. `simplymines.mine.diamond`) — it isn't hardcoded.\
Check each mine's configuration, or ask your admin, for the exact node required to mine there.
{% endhint %}

If a player fails a mine requirement, they'll see the configured deny message instead of being able to break the block:

| Requirement     | Deny message key                   |
| --------------- | ---------------------------------- |
| Permission      | `messages.no-permission-mine`      |
| Tool Efficiency | `messages.higher-efficiency-level` |


---

# 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, and the optional `goal` query parameter:

```
GET https://simplymines.gitbook.io/simplymines-docs/introduction/permissions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.