Item Conditions

Condition settings

All conditions are formated the same, you have:

• {theCondition}
• {theCondition}Msg: The message to send if the condition is invalid
• {theCondition}Cancel: Whether or not the event should be cancelled if the condition is invalid
• {theCondition}Cmds: The command(s) to run if the condition is invalid
• Example:

itemConditions:
    ifDurability: '>600'
    ifDurabilityMsg: '' #<- Here is where you will add the custom message.
    ifDurabilityCancel: true
    ifDurabilityCmds:
    - say oh sympathy

info

For numerical conditions, you can assign 2 conditions at the same time. Example: "I want to create a condition that only activates if the value is greater than 50 but less than 250" {theCondition}: 50 < CONDITION < 250

ifDurability

• Description: Checks if the ei has the said durability.
• Example:

itemConditions:
    ifDurability: '>600'
    ifDurabilityMsg: '' #<- Here is where you will add the custom message.

• Example Situations:
  • If the value is <789, the activator will only activate if the item's durability is below 789
  • If the value is <=1000, the activator will only activate if the item's durability is 1000 and below.
  • If the value is ==788, the activator will only activate if the item's durability is 788.
  • If the value is >989, the activator will only activate if the item's durability is above 989.
  • If the value is >=676, the activator will only activate if the item's durability is 676 and above.
• Required: NO

ifUsage

• Description: Checks if the item has the said usage remaining.
• Example:

itemConditions:
    ifUsage: '>5565'
    ifUsageMsg: '' #<- Here is where you will add the custom message.

• Example Situations:
  • If the value is <456, the activator will only activate if the item's usage remaining is below 456
  • If the value is <=234, the activator will only activate if the item's usage remaining is 234 and below.
  • If the value is ==16, the activator will only activate if the item's usage remaining is 16.
  • If the value is >6666, the activator will only activate if the item's usage remaining is above 6666.
  • If the value is >=78, the activator will only activate if the item's usage remaining is 78 and above.
• Required: NO
• Also it supports to work in intervals

itemConditions:
  ifUsage: 4 < CONDITION <= 8
  ifUsageMsg: '&4&l&o[ExecutableItems] &cThis item must have the valid usage
    to active the activator: &6%activator% &cof this item!'
  ifUsageCancel: false

ifUseCooldown

• Description: Checks if the EI has the specified use cooldown. (It's like the enderpearl cooldown) (This cooldown is not related to the activator cooldown, it's the vanilla use cooldown)
  • This feature is only available for Minecraft 1.21.2 and +
  • The cooldown is specified in ticks (20 ticks = 1 second)
• Example:

itemConditions:
    ifUseCooldown: '>600'
    ifUseCooldownMsg: '' #<- Here is where you will add the custom message.

• Example Situations:
  • If the value is <789, the activator will only activate if the item's use cooldown is below 789 ticks
  • If the value is <=1000, the activator will only activate if the item's use cooldown is 1000 and below.
  • If the value is ==788, the activator will only activate if the item's use cooldown is 788.
  • If the value is >989, the activator will only activate if the item's use cooldown is above 989.
  • If the value is >=676, the activator will only activate if the item's use cooldown is 676 and above.
• Required: NO

ifHasEnchant

• Description: Checks if the item has the whitelisted enchantment.Enchantments
• Example:

itemConditions:
    ifHasEnchant: 
    - ARROW_FIRE:1
    ifHasEnchantMsg: '' #<- Here is where you will add the custom message.

• Example Situations:
  • If the EI item has the Flame enchantment and you have the condition in the example part, the activator activates
• Required: NO

ifHasNotEnchant

• Description: Checks if the item has the blacklisted enchantment.Enchantments
• Example:

itemConditions:
    ifHasNotEnchant: 
    - ARROW_POWER:6
    ifHasNotEnchantMsg: '' #<- Here is where you will add the custom message.

• Example Situations:
  • If the EI item has the Power VI enchantment and you have the condition in the example part, the activator does not activate
• Required: NO

ifCrossbowMustBeCharged - Not

• Description: Checks if the item is a (not) charged crossbow.
• Example:

  itemConditions:
    ifCrossbowMustBeCharged: true
    ifCrossbowMustBeChargedMsg: '' #<- Here is where you will add the custom message.
    
    ifCrossbowMustNotBeCharged: true
    ifCrossbowMustNotBeChargedMsg: '' #<- Here is where you will add the custom 

• Example Situations:
  • If the EI item is a charged crossbow, the activator activates
• Required: NO
• More Info: You can edit the error message by adding this in the file: