/scriptevent

原文：Commands/scriptevent；源修订：3619573。

本命令不同于 /script。基岩版和教育版独有，需要开启作弊；权限等级为 1。

以一个 ID 和消息触发脚本事件。

语法

scriptevent <messageId: string> <message: message>

参数

messageId: string：必须为字符串，且必须带命名空间；不能使用 minecraft 命名空间。例如 /scriptevent give:coal、/scriptevent my_scripts:spawn_sheep。

message: message：可选参数，类型为 CommandMessage，最大长度为 C++ 字符串的最大长度。

结果

参数指定不正确时无法解析，其他情况成功。

命令本身不会直接影响游戏中的任何内容，但可以在应用于该世界或服务器的任意附加包中触发事件。

输出

基岩版中，失败时成功次数为 0，成功时为 1。

示例

调用 ID 为 wiki:example 的事件处理程序，消息为 Example Message：

/scriptevent wiki:example Example Message

用于脚本 API 的 JavaScript 示例：

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;
});

代码来源。

另见

/script：GameTest 框架的调试选项。

外部链接

Microsoft Learn：/scriptevent 命令（2024 年 12 月 12 日）。

来源为 Minecraft Wiki；本中文翻译/改编按 CC BY-NC-SA 3.0 共享。