> For the complete documentation index, see [llms.txt](https://eggsess-plugins.gitbook.io/eggsess-plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eggsess-plugins.gitbook.io/eggsess-plugins/wandering-trader-announcer/commands-and-permissions.md).

# Commands and Permissions

### Trader Announcements

**Description:** Allows players to be notified when a Wandering Trader spawns. 

**Permission:** wanderingtraderannouncer.announce – Allows players to be notified when a Wandering Trader spawns. 

{% hint style="danger" %}
⚠ **WARNING:** This permission must be present for `/wta toggle` and `/wta announcements` to have any effect on a Player. If a player does not have this permission, enabling announcements will have NO effect.
{% endhint %}

### Commands

#### `/wta toggle`

**Description:** Toggles wandering trader spawn announcements on or off for the player.

**Usage:**

```
/wta toggle
```

**Example:**

* If announcements are **enabled**, running the command will **disable** them.
* If announcements are **disabled**, running the command will **enable** them.

**Permissions:**

* `wanderingtraderannouncer.toggle` – Allows the player to toggle announcements.

***

#### `/wta announcements <enable|disable|check> <player>`

**Description:** Manages wandering trader announcements for a specific player.

**Usage:**

```
/wta announcements <enable|disable|check> <player>
```

**Permissions:**

* `wanderingtraderannouncer.announcements.enable` – Allows enabling announcements for a player.
* `wanderingtraderannouncer.announcements.disable` – Allows disabling announcements for a player.
* `wanderingtraderannouncer.announcements.check` – Allows checking a player's announcement status.

***

#### `/wta settings`

**Description:** Opens the Settings menu, where values in the main config.yml file can be changed.

**Usage:**

```
/wta settings
```

**Permissions:**

* `wanderingtraderannouncer.settings` – Allows opening and usage of the Settings menu.

***

#### `/wta reload [config|messages|players|gui]`

**Description:** Reloads specific or all configuration files.

**Usage:**

```
/wta reload [config|messages|players|gui]
```

**Permissions:**

* `wanderingtraderannouncer.reload` – Allows reloading of configuration files.

***

#### `/wta help`

**Description:** Displays a list of available commands for the plugin.

**Usage:**

```
/wta help
```

**Permissions:**

* `wanderingtraderannouncer.help` – Allows use of the help command.

***

### Permissions

| Permission                                       | Description                                                                                                                          | Default |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ | ------- |
| `wanderingtraderannouncer.*`                     | Grants access to all Wandering Trader Announcer commands                                                                             | `op`    |
| `wanderingtraderannouncer.base`                  | <p>Base permission for <code>/wanderingtraderannouncer</code><br>This is automatically given  <br>when required, can be ignored.</p> | `op`    |
| `wanderingtraderannouncer.announce`              | Allows players to be notified when a Wandering Trader spawns                                                                         | `op`    |
| `wanderingtraderannouncer.toggle`                | Allows players to toggle Wandering Trader Announcements                                                                              | `op`    |
| `wanderingtraderannouncer.reload`                | Allows reloading of the configuration files                                                                                          | `op`    |
| `wanderingtraderannouncer.help`                  | Allows use of the help command                                                                                                       | `op`    |
| `wanderingtraderannouncer.announcements.enable`  | Allows enabling announcements for a player                                                                                           | `op`    |
| `wanderingtraderannouncer.announcements.disable` | Allows disabling announcements for a player                                                                                          | `op`    |
| `wanderingtraderannouncer.announcements.check`   | Allows checking a player's announcement status                                                                                       | `op`    |
| `wanderingtraderannouncer.settings`              | Allows opening and usage of the Settings menu.                                                                                       | `op`    |

***

### Notes

* /wanderingtraderannouncer is the base command though /wta also works.
* Remember, Players must have wanderingtraderannouncer.notify to recive notifications!

***