> 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/edperks/essential/commands.md).

# Commands

EdPerks registers two commands: a player-facing `/perks` shortcut and the `/edperks` admin command.

***

### Player Command

#### /perks (Aliases: /toolperks)

**Permission:** None **Description:** Opens your own Tool Perks menu.

**Usage:**

* `/perks` — opens the [Tool Perks menu](/p/edperks/essential/guis.md) where you roll and buy tickets.

***

### Admin Command

#### /edperks (Aliases: /eperks)

**Description:** Administrative command for EdPerks.

**Usage:**

* `/edperks` — shows plugin information.
* `/edperks help` — shows the help/command list.

**Subcommands:**

**`/edperks help`**

* **Description:** Displays the command list.
* **Permission:** None.
* **Usage:** `/edperks help`

**`/edperks reload`**

* **Description:** Reloads `config.yml`, `messages.yml`, all perk files and the GUIs.
* **Permission:** `edperks.admin`
* **Usage:** `/edperks reload`

**`/edperks open [player]`**

* **Description:** Opens the Tool Perks menu — for yourself, or for another online player when a name is given.
* **Permission:** `edperks.admin`
* **Usage:** `/edperks open` · `/edperks open Steve`

**`/edperks tickets <player>`**

* **Description:** Checks a player's Perk Ticket balance.
* **Permission:** `edperks.admin`
* **Usage:** `/edperks tickets Steve`

**`/edperks tickets give <player> <amount>`**

* **Description:** Adds tickets to a player (use a negative amount to subtract).
* **Permission:** `edperks.admin`
* **Usage:** `/edperks tickets give Steve 10`

**`/edperks tickets set <player> <amount>`**

* **Description:** Sets a player's ticket balance to an exact value (clamped at 0).
* **Permission:** `edperks.admin`
* **Usage:** `/edperks tickets set Steve 50`

***

### Permissions

| Permission      | Default | Grants                                                     |
| --------------- | ------- | ---------------------------------------------------------- |
| `edperks.admin` | `op`    | Access to `reload`, `open`, and all `tickets` subcommands. |

`/perks` and `/edperks` / `/edperks help` require no permission.

***

### Examples

**Set up a new player with tickets:**

```
/edperks tickets give Steve 25
/edperks open Steve
```

**Run an event giving everyone tickets (with a multi-player plugin or a loop):**

```
/edperks tickets give Steve 100
/edperks tickets give Alex 100
```

**Check and correct a balance:**

```
/edperks tickets Steve
/edperks tickets set Steve 0
```

**Apply config changes live:**

```
/edperks reload
```


---

# 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/edperks/essential/commands.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.