Minecraft Bedrock Super Script API

跨时代的Minecraft基岩版脚本开发前置API

开始使用

SuperSAPI简述

SuperSAPI(全称Minecraft Bedrock Super Script API)是基于Minecraft Bedrock Script API(SAPI)的扩展,采用面向对象的开发逻辑,通过替换类的方式简化脚本编写。

SuperSAPI的优点

代码复用

通过继承Super类实现代码复用。

简化维护

集中管理玩家、实体、世界等逻辑,简化维护。

提高可读性

清晰的模块划分和组件化设计提高可读性。

灵活应对变化

快速适应游戏逻辑变化。

SuperSAPI主模块

SuperSAPI是核心库,包含所有SuperSAPI类。

MC

原生Minecraft中@minecraft/server模块的内容。

Std

SSAPI的标准库,提供各种标准库函数。

MCVD

原生@minecraft/vanilla-data的引用模块。

类:

Super类

SuperWorld

对原生 world 类的提升类。

SuperPlayer

对原生 Player 类的提升类。

SuperEntity

对原生 Entity 类的提升类。

SuperItemStack

对原生 ItemStack 类的提升类。

SuperSystem

对原生 System 类的提升类,不可被替换。

组件类

EntityComponent

实体组件,可动态添加删除,可被添加到实体(包括玩家)的实例上。

PlayerComponent

玩家组件,继承与`EntityComponent`类,可被添加到玩家的实例上。

ItemComponent

物品组件,仅可添加到不可堆叠物品的实例上。

管理类

ClassManager

类管理,用于使用自定义继承类替换对应的Super类。

CommandManager

指令管理,用于注册#聊天指令。

CustomComponentManager

自定义组件类,用于注册自定义组件,默认注册了一个#help内部指令,使用时会输出所有已经被注册到SSAPI内的指令。

ItemStackManager

物品管理类,管理所有的SuperItemStack类的实例。

工具类

Timer

定时器类,可用于**延迟执行**​`Timeout`​ **,周期性执行**​`Interval`​ **,持续执行**​`Lasting`三种执行方式。

Debug

用于开发中的Debug调试。