# Configuration

{% hint style="info" %}
**Tip:** This page refere to the orginal config.yml file.
{% endhint %}

## File location

config.yml is located on the plugins Directory under CreativeManager

## Default file

CreativeManager generate your first config file at startup.

This file contain default configuration.

```yaml
##Plugin configuration
tag: '&r[&cCreativeManager&r] '
lang: en_EN
log: true
save-interval: 300
save-log: true
send-player-messages: true
antispam-tick: 5
## Protection module
protections:
  container: true #Bypass : creativemanager.bypass.container
  spawn: false #Bypass : creativemanager.bypass.spawner
  drop: true #Bypass : creativemanager.bypass.drop
  pickup: true #Bypass : creativemanager.bypass.pickup
  build: false #Bypass : creativemanager.bypass.build
  entity: true #Bypass : creativemanager.bypass.entity
  pvp: false #Bypass : creativemanager.bypass.hit.player
  pve: false #Bypass : creativemanager.bypass.hit.monster
  lore: true # Bypass : creativemanager.bypass.lore
  loot: true
  spawn-build: true
  throw: true
  commands: true
  useblock: true
  blockcopy: true
  gui: false
  custom-nbt: false
  armor: false
  build-container: true #Bypass : creativemanager.bypass.build-container
  plugins:
    citizens: true
    chestshop: true
    slimefun: true
## Multi inventory
inventory:
  adventure: true #Bypass : cm.bypass.inventory
  creative: true #Bypass : cm.bypass.inventory
  spectator: true #Bypass : cm.bypass.inventory
stop-inventory-save: false #Use it at your own risk, this option fully disable the inventory save system.
## List
list:
  mode:
    place: blacklist
    use: blacklist
    get: blacklist
    break: blacklist
    commands: blacklist
    useblock: blacklist
  place: #Bypass : creativemanager.bypass.blacklist.place
    - 'tnt'
  use: #Bypass : creativemanager.bypass.blacklist.use
    - 'lava_bucket'
    - 'flint_and_steel'
    - 'fire_charge'
  get: #Bypass : creativemanager.bypass.blacklist.get
    - 'diamond'
  break:
    - 'bedrock'
  commands:
    -  'somecommandtoblacklist optionnaly with some argument'
  useblock:
    - 'CRAFTING_TABLE'
creative_armor:
  helmet:
    name: '&6Creative Helmet'
    lore:
      - '&7This creative Helmet is bind to your Gamemode !'
    material: BEDROCK
    model-data: 0
    items-adder: ''
  chestplate:
    name: '&6Creative Chestplate'
    lore:
      - '&7This &6Creative Chestplate&7 is bind to your Gamemode !'
    material: LEATHER_CHESTPLATE
    leather-color:
      red: 255
      green: 255
      blue: 255
    model-data: 0
    items-adder: ''
  leggings:
    name: '&6Creative Leggings'
    lore:
      - '&7This &6Creative Leggings&7 is bind to your Gamemode !'
    material: CHAINMAIL_LEGGINGS
    model-data: 0
    items-adder: ''
  boots:
    name: '&6Creative Boots'
    lore:
      - '&7This &6Creative Boots&7 is bind to your Gamemode !'
    material: CHAINMAIL_BOOTS
    model-data: 0
    items-adder: ''
## Lore settings
creative-lore:
  - '&5Creative {ITEM}'
  - '&7Generate by {PLAYER}'
  - '&7{UUID}'
```

## Configuration details

| Node                | Description                                                 |
| ------------------- | ----------------------------------------------------------- |
| tag                 | Allow you to edit the plugins tags                          |
| lang                | Configure with the lang file name                           |
| log                 | Allow CreativeManager to log in console protections actions |
| save-interval       | Delay between each inventory save                           |
| save-log            | Allow CreativeManager to save block log                     |
| send-player-message | Send player message with CreativeManager protections        |
| protections.\*      | Enable / Disable protections                                |
| inventory.\*        | Enable / Disable inventory switch                           |
| blacklist.\*        | Add some items / block on the blacklist                     |
| creative-lore       | Edit the Creative lore added on Creative items.             |

## Blacklist usage

Blacklist can be easily used with '\*'.

The following example blacklist all 'somecommand' command and subcommands and also deny 'anothercommands sub' command and subcommand.

This example also deny placing all type of LOG

```yaml
list:
  place: 
    - '*_LOG'
  commands:
    - 'somecommand*'
    - 'anothercommands sub*'
```

#### Tag usage in blacklist

With 1.31.1 update server owner can use Tag in the blacklist config. These Tag are managed by Spigot and can change with future update.

{% hint style="info" %}
Official Tag list can be found here : <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Tag.html>
{% endhint %}

For helping everyone server admin can run the \`/cm items\` commands to get some informations like the TAG list of the in hand item.

```yaml
list:
  place:
    - '#PLANKS'
```

The above example disallow placement of every planks block.

#### List mode

With 1.31.1 update server owner can now change the list mode.

{% tabs %}
{% tab title="whitelist" %}
Whitelist allow all items listed for usage and disallow unlisted items.
{% endtab %}

{% tab title="blacklist" %}
Whitelist disallow all items listed for usage and allow unlisted items.
{% endtab %}
{% endtabs %}


---

# 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://wiki.k0bus.fr/configuration.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.