Commands/scriptevent

This feature is exclusive to Bedrock Edition and Minecraft Education.

 

{
    "title": "<code>/scriptevent</code>",
    "rows": [
        {
            "field": "1",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "(link to Cheat article, displayed as Cheat) only<br>",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

Triggers a script event with an ID and message.

scriptevent <messageId: string> <message: message>

messageId: string: basic_string

Must be a string. Must be namespaced and use of the minecraft namespace is invalid (e.g. /scriptevent give:coal, /scriptevent my_scripts:spawn_sheep)

message: message: CommandMessage

Optional argument. Maximum length is the C++ max string length. It is a greedy phrase string argument (taking the rest of the command as the string argument). Can include spaces as well as target selectors. The game replaces entity selectors in the message with the list of selected entities' names, which is formatted as "name1 and name2" for two entities, or "name1, name2, ... and namen" for n entities.@<player name> can be used to mention a player; @here can be used to mention all players.

The command by itself does not directly affect anything in the game, but can trigger an event in any add-ons applied to the world/server.

• To evoke an event handler with the ID wiki:example and the message "Example Message":
  • /scriptevent wiki:example Example Message
• Example JavaScript code for use in the scripting API:

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

system.afterEvents.scriptEventReceive.subscribe((event) => {
  const {
  	id,           // returns string (wiki:example)
  	initiator,    // returns Entity
    message,      // returns string (Example Message)
    sourceBlock,  // returns Block
    sourceEntity, // returns Entity
    sourceType,   // returns MessageSourceType
  } = event;
});

Code source

• /script— debugging options for GameTest Framework

• "/scriptevent Command" – Microsoft Learn, December 12, 2024.