-
Notifications
You must be signed in to change notification settings - Fork 4
Advancements 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.
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)
}
}
}Description:
Triggers when a player uses any block.
Properties:
None.
Example:
anyBlockUse("use_block") {
conditions {
playerProperties {
lookingAt(Blocks.CRAFTING_TABLE)
}
}
}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
}
}
}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)
}
}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)
}
}
}
}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
}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)
}
}
}
}Description:
Triggers when a beacon is constructed.
Properties:
-
level: The level of the beacon.
Example:
constructBeacon("make_beacon") {
level = rangeOrInt(4)
}Description:
Triggers when an item is consumed.
Properties:
-
item: The item that was consumed.
Example:
consumeItem("eat_apple") {
item {
items = listOf(Items.GOLDEN_APPLE)
}
}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)
}
}
}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)
}
}
}
}Description:
Triggers when a block is used with default interaction.
Properties:
None.
Example:
defaultBlockUse("use_default") {
conditions {
playerProperties {
lookingAt(Blocks.CHEST)
}
}
}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)
}
}
}
}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)
}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"
}
}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)
}
}
}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.
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)
}
}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)
}
}Description:
Triggers when a bucket is filled.
Properties:
-
item: The bucket item that was filled.
Example:
filledBucket("fill_bucket") {
item {
item(Items.WATER_BUCKET)
}
}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)
}
}
}
}Description:
Triggers when becoming a hero of the village.
Properties:
None.
Example:
heroOfTheVillage("save_village") {
conditions {
location {
dimension = Dimensions.OVERWORLD
}
}
}Description:
Prevents the advancement from being achieved. Useful for creating advancements that should only trigger functions.
Properties:
None.
Example:
impossible("impossible")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)
}
}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)
}
}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)
}
}
}
}
}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)
}
}
}
}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)
}
}
}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)
}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)
}
}
}
}
}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
}
}
}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)
}
}
}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)
}
}
}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)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)
}
}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)
}
}
}
}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)
}
}
}Description:
Triggers when a recipe is unlocked.
Properties:
-
recipe: The recipe that was unlocked.
Example:
recipeUnlocked("unlock_recipe", Recipes.DIAMOND)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)
}
}
}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)
}
}
}Description:
Triggers when a player sleeps in a bed.
Properties:
None.
Example:
sleptInBed("sleep_in_bed")Description:
Triggers when sliding down a block.
Properties:
-
block: The block being slid down.
Example:
slideDownBlock("slide_down") {
block {
blocks(Blocks.SNOW_BLOCK)
}
}Description:
Triggers when a player starts riding an entity.
Properties:
None.
Example:
startedRiding("ride_horse") {
conditions {
vehicle {
type(EntityTypes.HORSE)
}
}
}Description:
Triggers when an entity is summoned.
Properties:
-
entity: The entity that was summoned.
Example:
summonedEntity("summon_iron_golem") {
entity {
type(EntityTypes.IRON_GOLEM)
}
}Description:
Triggers when an animal is tamed.
Properties:
-
entity: The animal that was tamed.
Example:
tameAnimal("tame_wolf") {
entity {
type(EntityTypes.WOLF)
}
}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)
}
}
}
}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)
}
}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)
}
}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
}
}Description:
Triggers when an ender eye is used.
Properties:
-
distance: The distance traveled using the ender eye.
Example:
usedEnderEye("find_stronghold") {
distance {
horizontal(100f)
}
}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)
}
}Description:
Triggers while using an item.
Properties:
-
item: The item being used.
Example:
usingItem("shield_block") {
item {
items = listOf(Items.SHIELD)
}
}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"
}
}
}
}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.
Explore the different pages:
- Home
- Chat Components
- Configuration
- Creating a Datapack
- Functions
- Data-Driven Features:
- Scoreboards
Helpers: