Script API - v1.20.30
    Preparing search index...

    Class WorldAfterEvents

    Contains a set of events that are available across the scope of the World.

    Index

    Properties

    buttonPush entityDie entityHealthChanged entityHitBlock entityHitEntity entityHurt itemCompleteUse itemReleaseUse itemStartUse itemStartUseOn itemStopUse itemStopUseOn itemUse itemUseOn leverAction playerJoin playerLeave playerSpawn pressurePlatePop pressurePlatePush projectileHitBlock projectileHitEntity targetBlockHit tripWireTrip

    Properties

    buttonPush: ButtonPushAfterEventSignal

    This event fires when a button is pushed.

    import { world } from "@minecraft/server";

    world.afterEvents.buttonPush.subscribe((event) => {
        console.log("Button: ", event.block.typeId);
        console.log("Dimension: ", event.dimension.id);
        console.log("Source: ", event.source.typeId);
    });
    entityDie: EntityDieAfterEventSignal

    This event fires when an entity dies.

    import { world } from "@minecraft/server";

    world.afterEvents.entityDie.subscribe((event) => {
        world.sendMessage(
            `${event.deadEntity.typeId} died from ${event.damageSource}!`
        );
    });
    entityHealthChanged: EntityHealthChangedAfterEventSignal

    This event fires when entity health changes in any degree.

    import { world } from "@minecraft/server";

    const healthChangedSubscription =
        world.afterEvents.entityHealthChanged.subscribe(
            (event) => {
                console.log("Entity:", event.entity);
                console.log("Old Health:", event.oldValue);
                console.log("New Health:", event.newValue);

                // Your custom handling for entity health change event
                // Example: Display a message, update UI, etc.
            },
            {
                // Optionally provide EntityEventOptions to filter entities or entity types
                entities: [],
                entityTypes: ["minecraft:player", "minecraft:zombie"], // Array of entity type IDs
            }
        );

    // Later, you can unsubscribe when needed
    world.afterEvents.entityHealthChanged.unsubscribe(healthChangedSubscription);
    entityHitBlock: EntityHitBlockAfterEventSignal

    This event fires when an entity hits (that is, melee attacks) a block.

    import { world } from "@minecraft/server";
    world.afterEvents.entityHitEntity.subscribe((event) => {
        const location1 = event.damagingEntity.location;
        const location2 = event.hitEntity.location;

        const distance = Math.pow(
            Math.pow(location2.x - location1.x, 2) +
                Math.pow(location2.y - location1.y, 2) +
                Math.pow(location2.z - location1.z, 2),
            0.5
        );

        console.log("Distance: " + distance + " blocks");
    });
    entityHitEntity: EntityHitEntityAfterEventSignal

    This event fires when an entity hits (that is, melee attacks) another entity.

    import { world } from "@minecraft/server";
    world.afterEvents.entityHitBlock.subscribe((event) => {
        const location1 = event.damagingEntity.location;
        const location2 = event.hitBlock.location;

        const distance = Math.pow(
            Math.pow(location2.x - location1.x, 2) +
                Math.pow(location2.y - location1.y, 2) +
                Math.pow(location2.z - location1.z, 2),
            0.5
        );

        console.log("Distance: " + distance + " blocks");
    });
    entityHurt: EntityHurtAfterEventSignal

    This event fires when an entity is hurt (takes damage).

    import { Player, world } from "@minecraft/server";
    world.afterEvents.entityHurt.subscribe((event) => {
        if (event.hurtEntity instanceof Player) {
            event.hurtEntity.sendMessage(
                "You were hurt from " + event.damageSource.cause + "!"
            );
        }
    });
    itemCompleteUse: ItemCompleteUseAfterEventSignal

    This event fires when a chargeable item completes charging.

    itemReleaseUse: ItemReleaseUseAfterEventSignal

    This event fires when a chargeable item is released from charging.

    itemStartUse: ItemStartUseAfterEventSignal

    This event fires when a chargeable item starts charging.

    itemStartUseOn: ItemStartUseOnAfterEventSignal

    This event fires when a player successfully uses an item or places a block by pressing the Use Item / Place Block button. If multiple blocks are placed, this event will only occur once at the beginning of the block placement. Note: This event cannot be used with Hoe or Axe items.

    itemStopUse: ItemStopUseAfterEventSignal

    This event fires when a chargeable item stops charging.

    itemStopUseOn: ItemStopUseOnAfterEventSignal

    This event fires when a player releases the Use Item / Place Block button after successfully using an item. Note: This event cannot be used with Hoe or Axe items.

    itemUse: ItemUseAfterEventSignal

    This event fires when an item is successfully used by a player.

    itemUseOn: ItemUseOnAfterEventSignal

    This event fires when an item is used on a block by a player.

    leverAction: LeverActionAfterEventSignal

    A lever has been pulled.

    playerJoin: PlayerJoinAfterEventSignal

    This event fires when a player joins a world. See also playerSpawn for another related event you can trap for when a player is spawned the first time within a world.

    import { world } from "@minecraft/server";
    world.afterEvents.playerJoin.subscribe(({ playerId, playerName }) => {
        world.sendMessage(
            `Player ${playerName} (${playerId}) has just joined the world.`
        );
    });
    playerLeave: PlayerLeaveAfterEventSignal

    This event fires when a player leaves a world.

    import { world } from "@minecraft/server";
    world.afterEvents.playerLeave.subscribe(({ playerId, playerName }) => {
        world.sendMessage(
            `Player ${playerName} (${playerId}) has just left the world.`
        );
    });
    playerSpawn: PlayerSpawnAfterEventSignal

    This event fires when a player spawns or respawns. Note that an additional flag within this event will tell you whether the player is spawning right after join vs. a respawn.

    import { world } from "@minecraft/server";

    world.afterEvents.playerSpawn.subscribe((eventData) => {
        let { player, initialSpawn } = eventData;
        if (!initialSpawn) return;

        // This runs when the player joins the game for the first time!
    });
    pressurePlatePop: PressurePlatePopAfterEventSignal

    A pressure plate has popped back up (i.e., there are no entities on the pressure plate.)

    pressurePlatePush: PressurePlatePushAfterEventSignal

    A pressure plate has pushed (at least one entity has moved onto a pressure plate.)

    projectileHitBlock: ProjectileHitBlockAfterEventSignal

    This event fires when a projectile hits a block.

    projectileHitEntity: ProjectileHitEntityAfterEventSignal

    This event fires when a projectile hits an entity.

    targetBlockHit: TargetBlockHitAfterEventSignal

    A target block was hit.

    tripWireTrip: TripWireTripAfterEventSignal

    A trip wire was tripped.

    Settings

    Member Visibility

    On This Page

    Properties