> For the complete documentation index, see [llms.txt](https://squareplugins.gitbook.io/sentry/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://squareplugins.gitbook.io/sentry/info/sentry-modules/item-control.yml.md).

# item-control.yml

With this module, you can block dangerous items from your server.

This is extra useful if you are running gamemodes like Creative and/or allow your players to have creative mode.

***

## Configuration

### Check potions

Here is the check-potions section inside the Module file.

```yaml
check-potions:
  enabled: true

  # Check thrown potions by dispensers?
  detect-dispensers-aswell: true

  notify-admins: true

  on-detect:
    remove: false # If true, will force delete the item from the person hand.
    item-to-replace: item # "item" to use base item type. Requires remove: false
    message: true # If true, sends a message to the player.
```

Everything there is pretty self-explanatory.

To check thrown potions at dispensers, set "`detect-dispensers-aswell`" to true, if false, players can exploit the plugin using the potions using Dispensers.

***

### Check enchantments

Here is the check-enchantments section inside the Module file.

If enabled, will check if any item contains a enchantment level above the vanilla maximum level. For example, this will prevent players from using a Sharpness 9999 sword, because the vanilla maximum level is 5.

```yaml
check-enchantments:
  enabled: true

  notify-admins: true

  on-detect:
    remove: false # If true, will force delete the item from the person hand.
    item-to-replace: item # "item" to use base item type. Requires remove: false
    message: true # If true, sends a message to the player.
```

Everything there is pretty self-explanatory.

***

### \[Requires MC 1.13.2+] Check item attributes

If enabled, will check if any item contains any attribute modifier.

<pre class="language-yaml"><code class="lang-yaml"><strong>check-attributes:
</strong>  enabled: true

  # Should Sentry trigger on all items with modified attributes?
  detect-every-attribute-modified-item: true

  # Requires the option above to be false.
  # Here you can set the attribute modifier power limit of item attributes,
  attribute-modifier-amount-threshold: 5

  notify-admins: true

  on-detect:
    remove: false # If true, will force delete the item from the person hand.
    item-to-replace: item # "item" to use base item type. Requires remove: false
    message: true # If true, sends a message to the player.
</code></pre>

***

### Configuring the "on-detect"

This module have his own on-detect actions, here is a breakdown of every option.

```yaml
on-detect:
    # If true, will force delete the item from the player hand.
    # You can't use the item-to-replace the same time this is set to true.
    remove: false
    
    # Here you can set a specific item to replace the original item for.
    # If you set it to "item" it will use the original item type as the base.
    item-to-replace: item
    
    # Will send a message to the player saying that he is not
    # allowed to have this dangerous.
    message: true
```

On `item-to-replace`, you need to put the item type, for example: `STONE` (for the stone block), `DIRT` (for a dirt block), `BARRIER` (for the barrier block). If you put it as "item" will use the original item type as the base item.

```yaml
    item-to-replace: WATER_BUCKET
```

In this example above, the item will be replaced to a Water Bucket.

***

## Default file & values

<details>

<summary>Default file &#x26; values</summary>

```yaml
#     _____            __
#    / ___/___  ____  / /________  __
#    \__ \/ _ \/ __ \/ __/ ___/ / / /
#   ___/ /  __/ / / / /_/ /  / /_/ /
#  /____/\___/_/ /_/\__/_/   \__, /
#                           /____/
#
# DOCUMENTATION: https://squareplugins.gitbook.io/sentry
# SUPPORT: https://discord.gg/7cFjDnSpEs - CHECK THE DOCUMENTATION BEFORE ASKING FOR HELP!
#
# LIKE THIS PLUGIN? CONSIDER DONATING! https://patreon.com/drawned

# Enable this module? true / false
module-enabled: true

# If true, players with sentry.bypass.item-control will not be checked by Sentry.
permission-bypass: true

# If "enabled: true", will check every potion if it is NOT a vanilla one.
check-potions:
  enabled: true

  # Check thrown potions by dispensers?
  detect-dispensers-aswell: true

  notify-admins: true

  on-detect:
    remove: false # If true, will force delete the item from the person hand.
    item-to-replace: item # "item" to use base item type. Requires remove: false
    message: true # If true, sends a message to the player.

# If "enabled: true", will check every enchantment on items to detect if anyone has an unsafe and not vanilla enchant.
check-enchantments:
  enabled: true

  notify-admins: true

  on-detect:
    remove: false # If true, will force delete the item from the person hand.
    item-to-replace: item # "item" to use base item type. Requires remove: false
    message: true # If true, sends a message to the player.
```

</details>