> 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/edevents/features/commands.md).

# Commands & Permissions

Aliases: `/edevents`, `/events`, `/ev`, `/miningevents`, `/edevent`.

## Player commands

| Command                                              | Description                                                                                  |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `/events`                                            | Shows the running event (time left, your score, leader) or the next automatic one.           |
| `/events help`                                       | Command help.                                                                                |
| `/events list`                                       | Every configured event.                                                                      |
| `/events info [event]`                               | Details of a running event.                                                                  |
| `/events top [event] [page]`                         | Leaderboard of a running event.                                                              |
| `/events next`                                       | When the next automatic event starts.                                                        |
| `/events stats [player]`                             | Wins, top 3 finishes, events played, best score (`edevents.stats.others` for other players). |
| `/events toggle [bossbar\|actionbar\|messages\|all]` | Hide / show the event displays (`edevents.toggle`).                                          |

## Admin commands (`edevents.admin`)

| Command                                         | Permission                  | Description                                                                                  |
| ----------------------------------------------- | --------------------------- | -------------------------------------------------------------------------------------------- |
| `/events start <event> [duration]`              | `edevents.command.start`    | Starts an event, optionally with a custom duration (`5m`, `1h`).                             |
| `/events stop [event\|all]`                     | `edevents.command.stop`     | Ends an event now; rewards are given unless `rewards-on-manual-stop: false`.                 |
| `/events extend <time> [event]`                 | `edevents.command.extend`   | Adds time to a running event.                                                                |
| `/events skip`                                  | `edevents.command.skip`     | Starts the next automatic event now.                                                         |
| `/events pause` / `/events resume`              | `edevents.command.pause`    | Pauses / resumes the scheduler.                                                              |
| `/events progress <player> <event> <amount>`    | `edevents.command.progress` | Adds progress (any objective; the way to feed `CUSTOM` events from other plugins' commands). |
| `/events setprogress <player> <event> <amount>` | `edevents.command.progress` | Sets a player's progress.                                                                    |
| `/events reload`                                | `edevents.command.reload`   | Reloads configs, messages and events (running events are cancelled).                         |

Every argument tab-completes; admin completions are hidden from players without permission.

## Permissions

| Permission               | Description                                                                               | Default  |
| ------------------------ | ----------------------------------------------------------------------------------------- | -------- |
| `edevents.admin`         | Every admin command and `edevents.stats.others`.                                          | OP       |
| `edevents.command.<sub>` | One admin sub-command (`start`, `stop`, `extend`, `skip`, `pause`, `progress`, `reload`). | OP       |
| `edevents.toggle`        | `/events toggle`.                                                                         | everyone |
| `edevents.stats.others`  | `/events stats <player>`.                                                                 | OP       |

Events can additionally require a permission to score (`permission` / `filter.permission` in the event file).