Block Conditions

For conditions that require numerical values, you can assign 2 conditions.

Example: "I want to create a condition that only activates if the value is greater than 50 but less than 250" So what you would type in the config will be 50 < CONDITION < 250

If a condition fails to be met, you can enable cancelEvent so if a specific condition isn't completed, cancelEvent will run. You can also customize the error message !

You can also run commands if the condition has failed to execute!

Example:

blockConditions:
     ifBlockAge: <2
     ifBlockAgeMsg: "héhéhé you can custom your message here"
     ifBlockAgeCancel: true
     ifBlockAgeCancelCmds:
     - say how sad

Example

name: '&7MyPickaxe'
lore:
- '&7&oDefault desc'
material: DIAMOND_PICKAXE
headDBID: ''
glow: false
glowDrop: false
disableStack: false
keepItemOnDeath: false
give-first-join: false
give-slot: 0
usage: 0
usePerDay: -1
usageLimit: -1
disable-world: []
unbreakable: false
isSpecialProjectile: false
canBeUsedOnlyByTheOwner: false
storeItemInfos: false
activators:
  activator1:
    activator: PLAYER_ALL_CLICK
    displayName: Activator name
    usageModification: 0
    usePerDay: -1
    cancelEventIfMaxUsePerDay: false
    autoUpdateItem: false
    commands: []
    silenceOutput: false
    blockCommands:
    - BREAK
    detailedBlocks:
      - WHEAT
      - CARROTS
    cancelEventIfNotDetailedBlocks: false
    onlyAirClick: false
    onlyBlockClick: true
    cancelEventIfInvalidRequiredExecutableItems: false
    cancelEvent: false
    conditions:
      targetBlockConditions:
        ifPlantFullyGrown: true
        ifPlantFullyGrownMsg: '&cError the plant clicked must be fully grown !'

ifContainerEmpty - Not

• Description: Check if the block contains items or not.

• Example:

blockConditions:
      ifContainerEmpty: true
      ifContainerNotEmpty: true

ifContainerContains

• Description: Check if the block contains material(s)

• Example:

blockConditions:
      requiredItems:
        requiredItem0:
          material: STONE
          amount: 1
          notExecutableItem: false

ifContainerContainsEI

• Description: Check if the block contains EI(s)

• Example:

 blockConditions:
      requiredExecutableItems:
        requiredEI0:
          executableItem: Bergbauhammer
          amount: 1

ifIsPowered - Not

• Description: Checks if the target block is (or must not be) powered by a redstone signal

• Example:

blockConditions:
    ifIsPowered: false   
    ifIsPoweredMsg: ''
    
    ifMustBeNotPowered: true 
    ifMustBeNotPoweredMsg: ''

• Example Situations:

  • If the block you are clicking at is a lit redstone lamp, the activator will activate

• Required: NO (Default: false)

ifMustBeNatural - ifMustBeNotNatural

• Description: Checks if the target block is a natural block (so not a placed block) (CORE PROTECT MUST BE INSTALLED)

Don't use that in an activator very frenquetly used because it will require a lot of performances

• Example:

    blockConditions:
      ifMustBeNotNatural: true
      ifMustBeNotNaturalMsg: ''
      ifMustBeNotNaturalCancel: true

    blockConditions:
      ifMustBeNatural: true
      ifMustBeNaturalMsg: ''
      ifMustBeNaturalCancel: true

• Example Situations:

  • If the block you are clicking is/isn't natural, the activator will activate

• Required: NO (Default: false)

ifPlayerMustBeOnTheBlock

• Description: Checks if the target block has a player on top of it

• Example:

blockConditions:
    ifPlayerMustBeOnTheBlock: false   
    ifPlayerMustBeOnTheBlockMsg: ''

• Example Situations:

  • If the block you are clicking has a player on top of it, the activator activates

• Required: NO (Default: false)

ifNoPlayerMustBeOnTheBlock

• Description: Checks if the target block has no player on top of it

• Example:

blockConditions:
    ifNoPlayerMustBeOnTheBlock: false   
    ifNoPlayerMustBeOnTheBlockMsg: ''

• Example Situations:

  • If the block you are clicking has a player on top of it, the activator doesn't activate

• Required: NO (Default: false)

ifPlantFullyGrown - ifPlantNotFullyGrown

• Description: Checks if the target block is a fully grown plant.

• Example:

blockConditions:
    ifPlantFullyGrown: true    
    ifPlantFullyGrownMsg: ''
##################################################
blockConditions:
    ifPlantNotFullyGrown: true    
    ifPlantNotFullyGrownMsg: ''

• Example Situations:

  • If the wheat crop is fully grown, the activator will activate.

• Required: NO (Default: false)

ifBlockAge

• Description: Checks the target block age (crops)

• Example:

blockConditions:
        ifBlockAge: <2
        ifBlockAgeMsg: "héhéhé you can custom your message here"

ifBlockLocationX - Y -Z

• Description: Checks the target block location X / Y / Z

• Example:

  blockConditions:
    ifBlockLocationX: 500 < CONDITION < 1500
    ifBlockLocationXMsg: "héhéhé you can custom your message here"
   
    ifBlockLocationY: 50 < CONDITION < 150
    ifBlockLocationYMsg: "héhéhé you can custom your message here"
        
    ifBlockLocationZ: 500 < CONDITION < 1500
    ifBlockLocationZMsg: "héhéhé you can custom your message here"

ifUsage

• It checks the usage of the clicked ExecutableBlock, if the usage is valid, the activator will work, otherwise an error message is displayed.

• Example:

  blockConditions:
    ifUsage: 4< #it also supports intervals like  4 < CONDITION <= 8
    ifUsageMsg: "&cError the executableBlock clicked must have more than 3 usages but less than 10"

• Required: NO

ifContainerContainsSellableItem

• Description: Checks if the clicked container has items that can be sold

• Example:

  blockConditions:
    ifContainerContainsSellableItem: true
    ifContainerContainsSellableItemMsg: "&cError the executableBlock clicked must have more than 3 usages but less than 10"

Block Around Conditions

• Description: Checks the blocks around the clicked block:

• Example:

    blockConditions:
      blockAroundCdts:
        blockAround0:
          southValue: 0
          northValue: 0
          westValue: 0
          eastValue: 0
          aboveValue: 1
          underValue: 0
          errorMsg: '&c&oA block is not placed correctly !'
          blockTypeMustBe:
          - STONE
          - COBBLESTONE
          - ANDESITE
          - ITEMSADDER:turquoise_block
          - EXECUTABLEBLOCKS:CUSTOMDIRT
          - !DIRT
          - ALL_ORES

    blockConditions:
      requiredItems: {}
      requiredExecutableItems: {}
      blockAroundCdts:
        blockAround0:
          southValue: 0
          northValue: 0
          westValue: 0
          eastValue: 0
          aboveValue: 0
          underValue: 1
          errorMsg: ''
          blockTypeMustBe:
          - stone
          placeholdersConditions:
            plchCdt0:
              type: PLAYER_STRING
              comparator: EQUALS
              part1: '%var_x%'
              part2: '10'
              cancelEventIfNotValid: false
              messageIfNotValid: ''
              messageIfNotValidForTarget: ''
              stopCheckingOtherConditionsIfNotValid: true
              placeholderConditionCmds:
              - say not run

Q: What exactly is going on in placeholder conditions? A: The placeholder %var_x% is being parsed according to the block in that position. Meaning, you can use this method to assign a specific number to insane amount of unique EBs without writing each id that may change overtime in blockTypeMustBe