教學:編寫腳本API/World類基礎

World類基礎

系列教學

所屬系列

編寫腳本API

難易度

初級

實踐裝置

所需軟件

◄ server模組基礎

System類基礎 ►

Dimension類基䂣 ►►

引言

World類是 server 模組的一部分，它包括世界事件，計分板等，我們將幫助您了解和使用此類(如果您需要了解有關World類的具體內容，請參見World)。

在前文中我們講到的AfterEvents和BeforeEvents中，大部分都在這裏。還有很多的方法都可以去其他地方參見到，故本文主要介紹它的幾個子類：

1. gameRules：遊戲規則
2. structureManager：結構管理器

它們都是read-only的。

遊戲規則

可以利用內容與/gamerule指令相似，同時它的行為也與/gamerule相似：

gamerule <rule: BoolGameRule> [value: Boolean]
gamerule <rule: IntGameRule> [value: int]

檢視指令的列舉後不難發現，BoolGameRule和IntGameRule都是不分大小寫的，SAPI中gameRules採用的卻是駝峰命名法。但他們的功能和參數都相同，以commandBlockOutput舉例：

/gamerule commandblockoutput true

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

world.gameRules.commandBlockOutput = true;

結構管理器

結構管理器(StructureManager) 是結構相關 API 的管理器。包括用於建立、取得、放置和刪除結構的 API。

createEmpty(
    identifier: string,
    size: Vector3,
    saveMode?: StructureSaveMode,
): Structure

它的原理是在記憶體中建立一個空Structure。使用Structure.setBlockPermutation用塊填充結構，並使用Structure.saveAs儲存變更。

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

world.structureManager.createEmpty(
    "wiki:example",
    {
        x: 1,
        y: 1,
        z: 1
    }
);

與結構管理器類似的還有Structure Class，更多的方法可以在這裏查閱。