# Commands and Permissions

{% hint style="danger" %}
**WARNING:** The core feature of this plugin, the Swapping Menu does not require normal players to issue any commands. Permissions for the menu are after the command section.
{% endhint %}

The permission, `villagerbiomeswapper.convert.entity.villager` along with a specific biome convert permission, for example, `villagerbiomeswapper.convert.biome.desert` are needed to allow players to convert the biomes of villagers!

### Commands

**Give Command**

**Description:** Gives the Villager Biome Swapper Item to the player that run the command OR the target player if given.

**Usage:**

```
/vbs give [player]
```

**Permission:**

* `villagerbiomeswapper.give`

***

**Give All Command**

**Description:** Gives the Villager Biome Swapper Item to ALL players.

**Usage:**

```
/vbs giveall
```

**Permission:**

* `villagerbiomeswapper.give`

***

**Reload Command**

**Description:** Reload all or a specific configuration file.

**Usage:**

```
/vbs reload [config|messages|gui|item]
```

**Permission:**

* `villagerbiomeswapper.reload`

***

**Help Command**

**Description:** Provides a list of all commands.

**Usage:**

```
/vbs help
```

**Permission:**

* `villagerbiomeswapper.help`

***

### Permissions

\
The following table lists all permissions for the Villager Biome Swapper plugin, along with their descriptions.

| Permission                                     | Description                                                                                                             |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **`villagerbiomeswapper.*`**                   | Grants access to all features.                                                                                          |
| `villagerbiomeswapper.base`                    | Ignore this permission, it is automatically granted when any other command permission is. Ability to use base command.  |
| `villagerbiomeswapper.reload`                  | Allows use of the /vbs reload command.                                                                                  |
| `villagerbiomeswapper.give`                    | Allows use of the /vbs give \[player] and /vbs giveall commands.                                                        |
| `villagerbiomeswapper.help`                    | Allows use of the /vbs help command.                                                                                    |
| **`villagerbiomeswapper.convert.*`**           | Allows converting villagers to any biome variant.                                                                       |
| `villagerbiomeswapper.convert.entity.villager` | Allows converting villagers to different biome variants.                                                                |
| **`villagerbiomeswapper.convert.biome.*`**     | Allows converting villagers to any biome variant.                                                                       |
| `villagerbiomeswapper.convert.biome.desert`    | Allows converting villagers to the desert biome variant.                                                                |
| `villagerbiomeswapper.convert.biome.jungle`    | Allows converting villagers to the jungle biome variant.                                                                |
| `villagerbiomeswapper.convert.biome.plains`    | Allows converting villagers to the plains biome variant.                                                                |
| `villagerbiomeswapper.convert.biome.savanna`   | Allows converting villagers to the savanna biome variant.                                                               |
| `villagerbiomeswapper.convert.biome.snowy`     | Allows converting villagers to the snow biome variant.                                                                  |
| `villagerbiomeswapper.convert.biome.swamp`     | Allows converting villagers to the swamp biome variant.                                                                 |
| `villagerbiomeswapper.convert.biome.taiga`     | Allows converting villagers to the taiga biome variant.                                                                 |

***

Notes

* /villagerbiomeswapper is the base command though vbs also works.
