linkAvailable Triggers

Below is the comprehensive list of available trigger types. Each trigger includes a description, its properties with explanations, and an example usage in Kotlin.

linkallayDropItemOnBlock

Description:
Triggers when an allay drops an item on a block.

Properties:

• location: The location where the item is dropped.

Example:

allayDropItemOnBlock("allay_drop") {
	location {
		block {
			blocks(Blocks.GRASS_BLOCK, Blocks.DIRT)
		}
	}
}

linkanyBlockUse

Description:
Triggers when a player uses any block.

Properties:
None.

Example:

anyBlockUse("use_block") {
	conditions {
		playerProperties {
			lookingAt(Blocks.CRAFTING_TABLE)
		}
	}
}

linkavoidVibrations

Description:
Triggers when a player avoids vibrations.

Properties:

• location: The location where vibrations are avoided.

Example:

avoidVibrations("avoid_sculk") {
	conditions {
		location {
			block = Blocks.SCULK_SENSOR
		}
	}
}

linkbeeNestDestroyed

Description:
Triggers when a bee nest is destroyed.

Properties:

• block: The type of block that was destroyed.
• item: The item involved in the destruction.
• numBeesInside: The number of bees that were inside the nest.

Example:

beeNestDestroyed("destroy_nest") {
	block = Blocks.BEE_NEST
	numBeesInside = rangeOrInt(1)
	item {
		item(Items.HONEYCOMB)
	}
}

linkbredAnimals

Description:
Triggers when animals are bred.

Properties:

• child: The child animal resulting from the breeding.
• parent: One of the parent animals.
• partner: The other parent animal.

Example:

bredAnimals("breed_animals") {
	child {
		conditions {
			entityProperties {
				type(EntityTypes.COW)
			}
		}
	}
	parent {
		conditions {
			entityProperties {
				type(EntityTypes.COW)
			}
		}
	}
	partner {
		conditions {
			entityProperties {
				type(EntityTypes.COW)
			}
		}
	}
}

linkchangedDimension

Description:
Triggers when a player changes dimension.

Properties:

• from: The original dimension.
• to: The new dimension.

Example:

changedDimension("enter_nether") {
	from = Dimensions.OVERWORLD
	to = Dimensions.NETHER
}

linkchanneledLightning

Description:
Triggers when lightning is channeled.

Properties:

• victims: A list of entities affected by the lightning.

Example:

channeledLightning("lightning_rod") {
	victim {
		conditions {
			entityProperties {
				type(EntityTypes.CREEPER)
			}
		}
	}
}

linkconstructBeacon

Description:
Triggers when a beacon is constructed.

Properties:

• level: The level of the beacon.

Example:

constructBeacon("make_beacon") {
	level = rangeOrInt(4)
}

linkconsumeItem

Description:
Triggers when an item is consumed.

Properties:

• item: The item that was consumed.

Example:

consumeItem("eat_apple") {
	item {
		items = listOf(Items.GOLDEN_APPLE)
	}
}

linkcrafterRecipeCrafted

Description:
Triggers when a recipe is crafted.

Properties:

• recipeId: The ID of the crafted recipe.
• ingredients: The ingredients used in the recipe.

Example:

crafterRecipeCrafted("craft_diamond") {
	recipeId = Recipes.DIAMOND
	ingredient(Items.DIAMOND) {
		components {
			damage(0)
		}
	}
}

linkcuredZombieVillager

Description:
Triggers when a zombie villager is cured.

Properties:

• villager: The villager involved in the curing.
• zombie: The zombie involved in the curing.

Example:

curedZombieVillager("cure_zombie") {
	villager {
		conditions {
			entityProperties {
				type(EntityTypes.VILLAGER)
			}
		}
	}
	zombie {
		conditions {
			entityProperties {
				type(EntityTypes.ZOMBIE)
			}
		}
	}
}

linkdefaultBlockUse

Description:
Triggers when a block is used with default interaction.

Properties:
None.

Example:

defaultBlockUse("use_default") {
	conditions {
		playerProperties {
			lookingAt(Blocks.CHEST)
		}
	}
}

linkeffectsChanged

Description:
Triggers when a player's effects change.

Properties:

• effects: The effects that have changed.
• source: The source of the effect changes.

Example:

effectsChanged("get_effect") {
	effect(Effects.SPEED) {
		amplifier = rangeOrInt(1..3)
		duration = rangeOrInt(100..200)
	}
	source {
		conditions {
			entityProperties {
				type(EntityTypes.WITCH)
			}
		}
	}
}

linkenchantedItem

Description:
Triggers when an item is enchanted.

Properties:

• item: The item that was enchanted.
• levels: The levels of enchantment applied.

Example:

enchantedItem("enchant_item") {
	item {
		item(Items.DIAMOND_SWORD)
	}
	levels = rangeOrInt(1..3)
}

linkenterBlock

Description:
Triggers when a player enters a specific block.

Properties:

• block: The block being entered.
• states: The state properties of the block.

Example:

enterBlock("enter_block") {
	block = Blocks.REDSTONE_LAMP
	states {
		this["lit"] = "true"
	}
}

linkentityHurtPlayer

Description:
Triggers when an entity hurts a player.

Properties:

• damage: Details about the damage inflicted.

Example:

entityHurtPlayer("hurt_player") {
	damage {
		sourceEntity {
			type(EntityTypes.ZOMBIE)
		}
		taken = rangeOrDouble(5.0..10.0)
		type {
			tag(Tags.DamageType.IS_FALL)
		}
	}
}

linkentityKilledPlayer

Description:
Triggers when an entity kills a player.

Properties:

• entity: The entity that killed the player.
• killingBlow: Details about the killing blow.

Example: Not provided in the original examples.

linkfallAfterExplosion

Description:
Triggers after falling from an explosion.

Properties:

• startPosition: The starting position of the fall.
• distance: The distance fallen.
• cause: The cause of the fall.

Example:

fallAfterExplosion("tnt_launch") {
	startPosition {
		position {
			y = rangeOrInt(100..200)
		}
	}
	distance {
		horizontal(10f)
	}
}

linkfallFromHeight

Description:
Triggers when falling from a height.

Properties:

• startPosition: The starting position of the fall.
• distance: The distance fallen.

Example:

fallFromHeight("high_fall") {
	distance {
		vertical(20f)
	}
}

linkfilledBucket

Description:
Triggers when a bucket is filled.

Properties:

• item: The bucket item that was filled.

Example:

filledBucket("fill_bucket") {
	item {
		item(Items.WATER_BUCKET)
	}
}

linkfishingRodHooked

Description:
Triggers when a fishing rod hooks something.

Properties:

• entity: The entity hooked by the fishing rod.
• item: The item used as the fishing rod.
• rod: Details about the fishing rod.

Example:

fishingRodHooked("catch_fish") {
	item {
		item(Items.FISHING_ROD)
	}
	rod {
		components {
			enchantments {
				enchantment(Enchantments.LUCK_OF_THE_SEA, 3)
			}
		}
	}
}

linkheroOfTheVillage

Description:
Triggers when becoming a hero of the village.

Properties:
None.

Example:

heroOfTheVillage("save_village") {
	conditions {
		location {
			dimension = Dimensions.OVERWORLD
		}
	}
}

linkimpossible

Description:
Prevents the advancement from being achieved. Useful for creating advancements that should only trigger functions.

Properties:
None.

Example:

impossible("impossible")

linkinventoryChanged

Description:
Triggers when inventory contents change.

Properties:

• items: The items involved in the inventory change.
• slots: The inventory slots affected.

Example:

inventoryChanged("get_diamond") {
	item {
		item(Items.DIAMOND)
	}
	slots {
		empty = rangeOrInt(1..3)
	}
}

linkitemDurabilityChanged

Description:
Triggers when item durability changes.

Properties:

• delta: The change in durability.
• durability: The current durability of the item.
• item: The item whose durability changed.

Example:

itemDurabilityChanged("tool_break") {
	delta = rangeOrInt(-10..-1)
	item {
		item(Items.DIAMOND_PICKAXE)
	}
}

linkitemUsedOnBlock

Description:
Triggers when an item is used on a block.

Properties:

• location: The location where the item was used.

Example:

itemUsedOnBlock("bone_meal_use") {
	location {
		predicate {
			locationCheck {
				block {
					blocks(Blocks.GRASS_BLOCK, Blocks.DIRT)
				}
			}
		}
	}
}

linkkilledByArrow

Description:
Triggers when killed by a crossbow.

Properties:

• firedFromWeapon: The weapon used to fire the arrow.
• uniqueEntityTypes: The number of unique entity types involved.
• victims: The entities that were killed.

Example:

killedByArrow("killed_by_arrow") {
	firedFromWeapon {
		items = listOf(Items.BOW)
		components {
			enchantments {
				enchantment(Enchantments.POWER, 5)
			}
		}
	}

	uniqueEntityTypes = rangeOrInt(1..5)

	victim {
		conditions {
			entityProperties {
				type(EntityTypes.PLAYER)
			}
		}
	}
}

linkkillMobNearSculkCatalyst

Description:
Triggers when a mob is killed near a sculk catalyst.

Properties:

• entity: The entity that was killed.
• killingBlow: Details about the killing blow.

Example:

killMobNearSculkCatalyst("kill_mob") {
	entity {
		type(EntityTypes.ZOMBIE)
	}
	killingBlow {
		sourceEntity {
			type(EntityTypes.PLAYER)
		}
	}
}

linklevitation

Description:
Triggers during levitation.

Properties:

• distance: The distance of levitation.
• duration: The duration of levitation.

Example:

levitation("float_up") {
	distance {
		y(10f)
	}
	duration = rangeOrInt(10..20)
}

linklightningStrike

Description:
Triggers on a lightning strike.

Properties:

• bystander: The bystanders affected by the lightning.
• lightning: Details about the lightning strike.

Example:

lightningStrike("struck") {
	bystander {
		type {
			conditions {
				entityProperties {
					type(EntityTypes.CREEPER)
				}
			}
		}
	}
}

linklocation

Description:
Triggers every second based on location conditions.

Properties:

• location: The specific location conditions for the trigger.

Example:

location("reach_end") {
	conditions {
		location {
			dimension = Dimensions.THE_END
		}
	}
}

linknetherTravel

Description:
Triggers when a player enters or exits the Nether.

Properties:

• distance: The distance traveled during the dimension change.
• startPosition: The starting position before the change.

Example:

netherTravel("enter_nether") {
	distance {
		horizontal(100f)
	}
	startPosition {
		position {
			x = rangeOrInt(0..100)
			z = rangeOrInt(0..100)
		}
	}
}

linkplacedBlock

Description:
Triggers when a block is placed.

Properties:

• location: The location where the block was placed.

Example:

placedBlock("place_block") {
	conditions {
		location {
			biomes(Biomes.PLAINS)
		}
	}
}

linkplayerGeneratesContainerLoot

Description:
Triggers when container loot is generated.

Properties:

• lootTable: The loot table used to generate the container loot.

Example:

playerGeneratesContainerLoot("find_treasure", LootTables.Chests.BURIED_TREASURE)

linkplayerHurtEntity

Description:
Triggers when a player hurts an entity.

Properties:

• damage: Details about the damage inflicted.
• entity: The entity that was hurt.

Example:

playerHurtEntity("hurt_mob") {
	damage {
		taken = rangeOrDouble(5.0..10.0)
	}
}

linkplayerKilledEntity

Description:
Triggers when a player kills an entity.

Properties:

• entity: The entity that was killed.
• killingBlow: Details about the killing blow.

Example:

playerKilledEntity("kill_mob") {
	entity {
		conditions {
			entityProperties {
				type(EntityTypes.ZOMBIE)
			}
		}
	}
}

linkrecipeCrafted

Description:
Triggers when a recipe is crafted.

Properties:

• recipeId: The ID of the crafted recipe.
• ingredients: The ingredients used in the recipe.

Example:

recipeCrafted("craft_diamond") {
	recipeId = Recipes.DIAMOND
	ingredient(Items.DIAMOND) {
		components {
			damage(0)
		}
	}
}

linkrecipeUnlocked

Description:
Triggers when a recipe is unlocked.

Properties:

• recipe: The recipe that was unlocked.

Example:

recipeUnlocked("unlock_recipe", Recipes.DIAMOND)

linkrideEntityInLava

Description:
Triggers when riding an entity in lava.

Properties:

• distance: The distance traveled while riding in lava.
• startPosition: The starting position before riding.

Example:

rideEntityInLava("lava_ride") {
	distance {
		horizontal(10f)
	}
	startPosition {
		position {
			y = rangeOrInt(100..200)
		}
	}
}

linkshotCrossbow

Description:
Triggers when shooting a crossbow.

Properties:

• item: The crossbow item that was shot.

Example:

shotCrossbow("shoot_crossbow") {
	item {
		item(Items.CROSSBOW)
		enchantments {
			enchantment(Enchantments.MULTISHOT, 1)
		}
	}
}

linksleptInBed

Description:
Triggers when a player sleeps in a bed.

Properties:
None.

Example:

sleptInBed("sleep_in_bed")

linkslideDownBlock

Description:
Triggers when sliding down a block.

Properties:

• block: The block being slid down.

Example:

slideDownBlock("slide_down") {
	block {
		blocks(Blocks.SNOW_BLOCK)
	}
}

linkstartedRiding

Description:
Triggers when a player starts riding an entity.

Properties:
None.

Example:

startedRiding("ride_horse") {
	conditions {
		vehicle {
			type(EntityTypes.HORSE)
		}
	}
}

linksummonedEntity

Description:
Triggers when an entity is summoned.

Properties:

• entity: The entity that was summoned.

Example:

summonedEntity("summon_iron_golem") {
	entity {
		type(EntityTypes.IRON_GOLEM)
	}
}

linktameAnimal

Description:
Triggers when an animal is tamed.

Properties:

• entity: The animal that was tamed.

Example:

tameAnimal("tame_wolf") {
	entity {
		type(EntityTypes.WOLF)
	}
}

linktargetHit

Description:
Triggers when a target block is hit.

Properties:

• signalStrength: The strength of the signal when the target is hit.
• projectile: The projectile used to hit the target.

Example:

targetHit("hit_target") {
	signalStrength = rangeOrInt(1..15)
	projectile {
		conditions {
			entityProperties {
				type(EntityTypes.ARROW)
			}
		}
	}
}

linkthrownItemPickedUpByEntity

Description:
Triggers when a thrown item is picked up by an entity.

Properties:

• entity: The entity that picked up the item.
• item: The item that was picked up.

Example:

thrownItemPickedUpByEntity("feed_animal") {
	entity {
		type(EntityTypes.COW)
	}
	item {
		item(Items.WHEAT)
	}
}

linkthrownItemPickedUpByPlayer

Description:
Triggers when a thrown item is picked up by a player.

Properties:

• entity: The entity that picked up the item.
• item: The item that was picked up.

Example:

thrownItemPickedUpByPlayer("catch_trident") {
	item {
		item(Items.TRIDENT)
	}
}

linktick

Description:
Triggers every tick (20 times per second).

Properties:

• conditions: Conditions that must be met for the trigger to activate.

Example:

tick("game_tick") {
	conditions {
		timeCheck(6000..18000) // Daytime only
	}
}

linkusedEnderEye

Description:
Triggers when an ender eye is used.

Properties:

• distance: The distance traveled using the ender eye.

Example:

usedEnderEye("find_stronghold") {
	distance {
		horizontal(100f)
	}
}

linkusedTotem

Description:
Triggers when a totem is used.

Properties:

• item: The totem item that was used.

Example:

usedTotem("save_life") {
	item {
		item(Items.TOTEM_OF_UNDYING)
	}
}

linkusingItem

Description:
Triggers while using an item.

Properties:

• item: The item being used.

Example:

usingItem("shield_block") {
	item {
		items = listOf(Items.SHIELD)
	}
}

linkvillagerTrade

Description:
Triggers when a villager trades.

Properties:

• item: The item involved in the trade.
• villager: The villager involved in the trade.

Example:

villagerTrade("trade") {
	item {
		item(Items.EMERALD)
	}
	villager {
		conditions {
			entityProperties {
				team = "villager"
			}
		}
	}
}

linkvoluntaryExile

Description:
Triggers when a player causes a raid in a village.

Properties:

• location: The location where the raid occurred.

Example:

voluntaryExile("raid_village") {
	conditions {
		location {
			dimension = Dimensions.OVERWORLD
		}
	}
}

Each trigger example demonstrates the basic usage with common properties and conditions. You can customize these triggers by adding more conditions and requirements to suit your specific advancement needs.