Conditions

Conditions

Conditions allow you to restrict when actions can be performed or rewards can be claimed. UniverseJobs supports 7 condition types.

Condition Types

Type	Description
permission	Check if player has a permission
world	Check if player is in a specific world
biome	Check if player is in a specific biome
time	Check in-game time
weather	Check weather conditions
placeholder	Check PlaceholderAPI values
item	Check item in player's hand

Basic Syntax

Conditions are added to actions using the requirements property:

actions:
  break:
    - target: DIAMOND_ORE
      xp: 50
      money: 10
      requirements:
        world: "world"
        permission: "jobs.mining.diamond"

Permission Condition

Check if the player has a specific permission:

requirements:
  permission: "universejobs.premium"

World Condition

Restrict actions to specific worlds:

requirements:
  world: "world"

Multiple worlds (OR logic):

requirements:
  world:
    - "world"
    - "world_nether"

Biome Condition

Restrict actions to specific biomes:

requirements:
  biome: "DESERT"

Time Condition

Restrict actions based on in-game time (0-24000 ticks):

requirements:
  time:
    from: 0                         # Sunrise (6:00 AM)
    to: 12000                       # Sunset (6:00 PM)

Time Reference

Time	Ticks	Description
6:00 AM	0	Sunrise
12:00 PM	6000	Noon
6:00 PM	12000	Sunset
12:00 AM	18000	Midnight

Weather Condition

Restrict actions based on weather:

requirements:
  weather: "RAIN"

Values: CLEAR, RAIN, THUNDER

Placeholder Condition

Use PlaceholderAPI to create complex conditions:

requirements:
  placeholder: "%player_level% >= 10"

Operators: >, <, >=, <=, ==, !=

Item Condition

Check the item in the player's hand:

requirements:
  item: "DIAMOND_PICKAXE"

For custom items:

requirements:
  nexo-id: "custom_pickaxe"
  # or
  itemsadder-id: "namespace:custom_pickaxe"

Combining Conditions

All conditions in requirements use AND logic by default.

Use any wrapper for OR logic:

requirements:
  any:
    - world: "world"
    - world: "world_nether"