脚本API（Script API）是Minecraft国际版中的一个脚本系统，可在附加包中实现脚本运算。目前脚本API在主机版上不可用[1]，其他平台上均可使用。

脚本API支持使用JavaScript语言（以下简称JS）编写，因此其灵活性要远大于数据驱动，可为附加包的创作提供更多可能，但脚本API无法取代数据驱动的底层注册与定义功能，例如添加方块、实体、物品等内容。在附加包的实际开发过程中，脚本API可以弥补数据驱动在逻辑运算方面灵活性的不足，从而实现更复杂的效果，而且可以在一定程度上减小附加包编写过程中的繁琐程度。同时，脚本API与Molang的对接也可以使数据驱动的灵活性更进一层。

在游戏测试方面，Mojang加入了GameTest框架[注 1]，用于对原版游戏进行测试。在游戏中通过/gametest命令可以加载一个预制的结构并运行对应脚本来进行游戏测试，最终会将测试结果反馈给玩家。

启用该脚本系统需要在附加包的清单文件中添加类型为脚本的清单模块。示例如下：

清单模块的类型（即type字段）为script时表示该包需启用脚本系统。其中language字段的值需填写为javascript，entry字段填写加载附加包时加载的JS文件。JS文件都存储在行为包的scripts文件夹中：

因此需要将entry的值填写为scripts/.js。

依此成功启用脚本API后，还需要在清单文件中添加脚本API的模块作为依赖项，才能将原生接口导入并使用。

要启用脚本API在新版本中的测试功能，需要开启“测试版API”实验性玩法选项。

JS中的eval()和Function()不能直接在脚本系统中使用，若要启用这两项功能，需通过在清单文件功能字段中添加"script_eval"字符串来启用：

使用/reload命令可以对脚本系统进行热重载。

脚本API提供的原生模块包含了很多的接口。原生模块需要在清单文件中的dependencies字段作为包的依赖项加载，并在脚本中使用import语句导入到脚本的作用域中。例如在清单文件中通过模块名加载：

或通过UUID加载：

然后在JS文件中导入之前加载的模块：

模块的版本用于指定游戏使用对应版本的接口来加载脚本文件，而不因为游戏更新受到影响。Mojang于1.19.40.23版本修改了模块名之后，创作者在清单文件中加载任意版本的模块都应使用新名称，而在JS文件中通过import语句导入模块时，要使用对应版本的模块名。

需要注意的一点是，模块的测试版本（即版本号带“beta”字样的版本）在脚本API更新下一个版本时不会被保留，因此使用了模块测试版本的附加包需在新版本中修改模块版本号，否则将会抛出内容日志错误并无法正常加载脚本。

脚本API目前仅支持JS，但也可先使用TypeScript（以下简称TS）编写再转化为JS来运行。官方在脚本API文档中引入了部分TS概念并适当使用TS进行演示[2]，这有利于开发者对脚本API的理解，提高编写代码过程的便捷性。本Wiki的脚本API相关页面也将使用部分TS概念进行演示。

枚举（Enumeration）包含了一组命名常量，可以使脚本编写中的某些特定值更规范统一。枚举值的调用方式与对象属性的调用方式一致，例如调用Direction枚举的值进行比较判断：

接口（Interface）是一种用于描述对象内容格式的TS类型。在脚本API的编写中，接口表示传入参数的格式或者返回值格式。

JS中以接口指定格式对象编写即可，下面是一个同时使用EntityQueryOptions接口和Vector3接口的示例：

官方在文档中引入了类型别名（Type Alias），用于为脚本API的编写提供便利。类型别名是TS中的一种类型，其本质是一种名称映射。在获取NPM包后类型别名可用于TS的编写，其并不存在于游戏的脚本引擎中。

在脚本API中，大多数核心功能都在@minecraft/server模块中，可以使用其与Minecraft中的实体、方块、维度等进行交互。

只读模式（Read-only Mode）是Mojang定义的一种非只读属性或函数的锁定状态[3]，在此状态下脚本系统将禁止写入某些属性或调用某些函数，并且会抛出内容日志错误[注 2]。此模式是Mojang对前事件作出的一种限制。

在传入前事件的回调函数中进行任何改变世界状态的操作都将受到此限制，相关的属性和方法会被设置为只读模式。例如以下操作：

但可通过使用system.run()等方式来延迟执行操作，从而错开前事件的触发时间。

动态属性（Dynamic Property）是脚本系统存储自定义数据的一种格式。目前动态属性可以存储在实体、物品和世界上。相较于数据驱动中属性（或状态）的“静态性”，动态属性可以实时增删，且动态属性的类型不固定，脚本系统以此可以实现数据的动态存储。

官方提供了以下5个方法来对动态属性进行操作：

这些方法可从World、​Entity和ItemStack三个类中调用。

动态属性可以存储布尔型、数值型、字符串型和三维向量型的数据，单个动态属性的数据大小限制在32KB以内。大量的动态属性数据可能会导致某些设备上加载缓慢。

动态属性以NBT的形式存储，其数据内容位于DynamicProperties复合标签下。每个行为包的动态属性存储在以该行为包UUID命名的复合标签内。

设置在实体或物品上的动态属性存储于其NBT内，若该实体或物品被清除，则其携带的动态属性数据也会随之一同消失。结构可以保存实体或物品的动态属性，且动态属性的包UUID信息不会丢失。

卸载行为包并重新加载世界不会使该行为包设置的动态属性消失，动态属性数据仍然会保留在存档中，重新装载该行为包后可以正常读写以前设置的动态属性。

每个附加包的脚本都是独立的，它们之间互不相通。不能通过一个已启用脚本API的附加包来使其他未启用脚本API的附加包接入脚本系统，附加包之间的JS文件也不能互相依赖或调用。

动态属性在存储时会记录创建它的行为包的UUID并以此作区分，因此不同行为包创建的动态属性也是相互独立的。一个行为包不能删除、创建或读写属于另一个行为包的动态属性。

通过/scriptevent命令可以一定程度上实现包与包之间的数据和逻辑互通。

看门狗（Watchdog）是一个性能监视器，用于监控脚本引擎中运行缓慢的脚本。

Template:Navbox Addon