Item Condition

The Item condition allows you to create placeholders that display different text based on whether a player has a specific item in their inventory.

Overview

This condition is perfect for creating item-based rewards, quest completion indicators, or special item holder statuses.

Configuration

To create an item condition, set the type to ITEM and configure the item properties.

Basic Example

placeholders:
  1:
    placeholder: "status"
    text: "No special item"
    conditions:
      itemExample:
        type: ITEM
        material: STONE
        text: "Example condition text"

How it works:

Players without the item see: “No special item”
Players with the item see: “Example condition text”

Item Properties

Material (Required)

The material of the item. You can view a list of all available materials in the Bukkit Material enum. Example:

material: STONE
material: DIAMOND
material: GOLDEN_APPLE

Name (Optional)

The display name of the item. Supports color codes if colors is enabled. Example:

name: "&cExample Item"
name: "Special Sword"

Lore (Optional)

The lore of the item as a string list. Supports color codes if colors is enabled. Example:

lore:
  - "First line"
  - "Second line"
  - "&aColored line"

Colors (Optional)

If set to true, color codes like &a are translated and displayed in color. Default: false Example:

colors: true

Complete Example

Here’s a full example with all options:

placeholders:
  1:
    placeholder: "badge"
    text: "No badge"
    conditions:
      itemExample:
        type: ITEM
        material: STONE
        name: "&cExample"
        lore:
          - "&aExample line"
          - "&7Second line"
        colors: true
        text: "Example condition text"

Real-World Examples

Quest Item Holder

placeholders:
  1:
    placeholder: "quest"
    text: "No quest item"
    conditions:
      quest_complete:
        type: ITEM
        material: EMERALD
        name: "&aQuest Completion Token"
        lore:
          - "&7You completed the quest!"
        colors: true
        text: "Quest Completed"

Special Weapon Holder

placeholders:
  1:
    placeholder: "weapon"
    text: "No special weapon"
    conditions:
      legendary_sword:
        type: ITEM
        material: DIAMOND_SWORD
        name: "&6&lLegendary Sword"
        lore:
          - "&7A powerful weapon"
          - "&7Only for the worthy"
        colors: true
        text: "Legendary Warrior"

VIP Token Holder

placeholders:
  1:
    placeholder: "vip_status"
    text: "Regular Player"
    conditions:
      vip_token:
        type: ITEM
        material: GOLD_INGOT
        name: "&e&lVIP Token"
        lore:
          - "&7Hold this to show VIP status"
        colors: true
        text: "VIP Token Holder"

Matching Behavior

The item condition checks if the player has an item that matches:

The specified material
The specified name (if provided)
The specified lore (if provided)

All provided properties must match for the condition to be true.

Tips and Best Practices

Be specific - Use name and lore to make items unique and prevent false matches
Use colors - Enable colors: true to make items more visually distinct
Test thoroughly - Make sure the item matching works as expected with your specific items
Combine conditions - You can combine item conditions with permission, money, or group conditions

Troubleshooting

Q: The condition isn’t matching
A: Make sure:

The material name is correct (case-sensitive)
If you specified a name, it matches exactly (including color codes)
If you specified lore, all lines match exactly
The player actually has the item in their inventory

Q: Color codes aren’t working
A: Make sure colors: true is set in your condition configuration.

Conditions Overview - Learn about all condition types
Permission Condition - Permission-based conditions

RocketJoin

RocketPlaceholders

MultiLang

Item Condition

Item Condition

Overview

Configuration

Basic Example

Item Properties

Material (Required)

Name (Optional)

Lore (Optional)

Colors (Optional)

Complete Example

Real-World Examples

Quest Item Holder

Special Weapon Holder

VIP Token Holder

Matching Behavior

Tips and Best Practices

Troubleshooting

​Item Condition

​Overview

​Configuration

​Basic Example

​Item Properties

​Material (Required)

​Name (Optional)

​Lore (Optional)

​Colors (Optional)

​Complete Example

​Real-World Examples

​Quest Item Holder

​Special Weapon Holder

​VIP Token Holder

​Matching Behavior

​Tips and Best Practices

​Troubleshooting

​Related Guides

Item Condition

Overview

Configuration

Basic Example

Item Properties

Material (Required)

Name (Optional)

Lore (Optional)

Colors (Optional)

Complete Example

Real-World Examples

Quest Item Holder

Special Weapon Holder

VIP Token Holder

Matching Behavior

Tips and Best Practices

Troubleshooting

Related Guides