> For the complete documentation index, see [llms.txt](https://plugins-1.gitbook.io/plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://plugins-1.gitbook.io/plugins/plugin/tags/configuration.md).

# Configuration

In order for players to use a certain tag, they'll need the **cifytags.use.\<id>** permission if (`permission: true`) is set for a particular tag.

{% code title="config.yml" %}

```yaml
## PlayerTags | Configuration File ##
## This configuration is default for v1.0.5 ##

settings:
  debug: false
  storage:
      type: SQLITE
      host: "localhost"
      port: 3306
      username: "root"
      password: "password"
      database: "playertags_data"
  gui:
    size: 45
    show-no-perm: true
    item:
      has-perm: NAME_TAG
      no-perm: BARRIER
tags: {}

```

{% endcode %}

## Per-Tag Items

The plugin has support for allowing a custom item, name and lore per tag for extra customisation. In the below example, our tag by the id 'og' will show a diamond with its name and lore if they have permission - while if they don't, it'll show redstone.

{% code title="config.yml" %}

```yaml
tags:
  og:
    type: 'PREFIX'
    prefix: '&b[&lOG&b]'
    description: "Much OG, Much Wow"
    permission: true
    item:
      has-perm:
        item: DIAMOND
        name: "&aOG Tag"
        lore:
          - '&7This tag is well.. og.'
      no-perm:
        item: REDSTONE
        name: "&cOG Tag"
        lore:
          - '&cDarn.. no permissions.'
```

{% endcode %}

## Placeholders

Since `v1.1.9` you may specify 'placeholders' (or fake items) inside of your GUI to customise the appearance. Take the below example:

```yaml
tags:
  close:
    placeholder: true
    actions:
    - '[CLOSE]'
    - '[PLAYER] spawn'
    - '[CONSOLE] msg %player% Action Example!'
    item:
      has-perm:
        item: BARRIER
        name: '&c&lCLOSE'
        lore:
        - '&7Close the GUI.'
  Test:
    prefix: '&7[Test]'
    description: Default description for Test tag..
    permission: true
    slot: 1
  Placeholder:
    placeholder: true
    permission: false
    slot: 0
    item:
      has-perm:
        name: '&7Placeholder #1'
        item: STAINED_GLASS_PANE
        data: 5
        lore:
        - '&7Hi!'
  Placeholder2:
    placeholder: true
    permission: true
    slot: 2
    item:
      has-perm:
        name: '&7Hello Again!'
        item: STAINED_GLASS_PANE
        data: 6
        lore:
        - '&7This will show if you have'
        - '&7the valid permission!'
```

The video (seen [here](https://i.imgur.com/7K6ANMT.gif)) will be shown when using the plugin.