# Commands and Permissions

## Commands

{% hint style="info" %}
Command aliases: /playerkits, /kits
{% endhint %}

| Command                                                                                                 | Description                                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **/kit**                                                                                                | Opens the GUI.                                                                                                                                                  |
| **/kit claim \<kit>**                                                                                   | Claims a kit outside the GUI.                                                                                                                                   |
| **/kit \<kit>**                                                                                         | Claims a kit outside the GUI only if `claim_kit_short_command` option is enabled on the config.                                                                 |
| <p><strong>/kit create \<kit></strong><br><strong>/kit create \<kit> original/configurable</strong></p> | Creates a new kit using the items in your inventory. Optionals `original/configurable` parameters, explained [**HERE**](#kit-creation-with-original-parameter). |
| **/kit edit \<kit>**                                                                                    | Edits a kit on a GUI.                                                                                                                                           |
| **/kit give \<kit> \<player>**                                                                          | Gives a kit to the player, ignoring cooldown, permission, one time and requirements.                                                                            |
| **/kit delete \<kit>**                                                                                  | Deletes a kit.                                                                                                                                                  |
| **/kit reset \<kit> \<player>**                                                                         | Resets kit data for a player. The player must be online                                                                                                         |
| **/kit reset \<kit> \***                                                                                | Resets kit data for all players. This will also modify offline player files, and there is no need for players to be online.                                     |
| **/kit preview \<kit> (optional)\<player>**                                                             | <p>Previews a kit. <br>Optionally for a player (requires playerkits.admin permission)</p>                                                                       |
| **/kit open \<inventory> \<player>**                                                                    | Opens a specific inventory (defined in inventory.yml file) for a player.                                                                                        |
| **/kit reload**                                                                                         | Reloads the config.                                                                                                                                             |
| **/kit verify**                                                                                         | Allows to check for plugin/configuration errors.                                                                                                                |
| **/kit migrate**                                                                                        | Imports kits data from PlayerKits v1. More info [**HERE**](/playerkits-2/migrating-from-playerkits-v1.md).                                                      |

## Permissions

| Permission                 | Description                                           |
| -------------------------- | ----------------------------------------------------- |
| playerkits.admin           | Grants access to all plugin commands.                 |
| playerkits.bypass.cooldown | Allows the player to bypass cooldowns of all kits.    |
| playerkits.bypass.onetime  | Allows the player to bypass the one time of all kits. |

## Kit Creation with 'original' and 'configurable' Parameters

When using `/kit create <kit>`, by default, items will be saved following the `new_kit_default_save_mode_original` option in the config.yml file.

When using `/kit create <kit> configurable`, items will be saved in a way you can modify their properties manually in the config following the documentation [**HERE**](/playerkits-2/items-tutorial.md).

When using `/kit create <kit> original` , items will be saved into the config as an EXACT/ORIGINAL COPY of the item, without losing any important properties and internal data. This prevents some complex items from other plugins to broke when giving them again to the player.

Here is an example of the same item and the config differences.

**With 'configurable' parameter:**

```yaml
items:
  '1':
    id: PLAYER_HEAD
    name: '&eEmoticon Derp'
    amount: 1
    durability: 3
    nbt:
    - Skulls:ID|534
    skull_data:
      texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHBzOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzNiYWFiZTcyNGVhZTU5YzVkMTNmNDQyYzdkYzVkMmIxYzZiNzBjMmY4MzM2NGE0ODhjZTU5NzNhZTgwYjRjMyJ9fX0=
      id: 069a79f4-44e9-4726-a5be-fca90e38aaf5
      owner: ''
```

**With 'original' parameter:**

```yaml
items:
  '1':
    original:
      ==: org.bukkit.inventory.ItemStack
      v: 3700
      type: PLAYER_HEAD
      meta:
        ==: ItemMeta
        meta-type: SKULL
        display-name: '{"text":"","extra":[{"text":"Emoticon Derp","obfuscated":false,"italic":false,"underlined":false,"strikethrough":false,"color":"yellow","bold":false}]}'
        Damage: 3
        internal: H4sIAAAAAAAA/+NiYOBg4AzOLs3JKbbydGFgNjU2YQAAOpvx+xUAAAA=
        skull-owner:
          ==: PlayerProfile
          uniqueId: 069a79f4-44e9-4726-a5be-fca90e38aaf5
          properties:
          - name: textures
            value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHBzOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzNiYWFiZTcyNGVhZTU5YzVkMTNmNDQyYzdkYzVkMmIxYzZiNzBjMmY4MzM2NGE0ODhjZTU5NzNhZTgwYjRjMyJ9fX0=
```

{% hint style="warning" %}
If you choose to save kits using the 'original' parameter, you'll not be able to modify the items manually in the config.
{% endhint %}


---

# Agent Instructions: 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://ajneb97.gitbook.io/playerkits-2/commands-and-permissions.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.