教學:編寫腳本API/System類基礎[編輯]

System類基礎

系列教學

所屬系列

編寫腳本API

難易度

初級

實踐裝置

所需軟件

◄ World類基礎

ItemStack類基礎 ►

引言

System類是 server 模組的一部分，它包括系統事件等，我們將幫助您了解和使用此類。

事件

System中包含的事件較少，但都有較大作用，下面一一介紹：

scriptEventReceive

scriptEventReceive是用於監聽/scriptevent指令觸發的事件。這為指令和其他系統提供了一種在腳本中觸發行為的方法。這些內容在server模組基礎中有所介紹，此處不加贅述。

shutdown

它用於在世界關閉之前進行操作，不能阻止其執行(這與大部分beforeEvents不同，主要可以用於在世界關閉之前儲存動態屬性)。

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

system.beforeEvents.shutdown.subscribe(() => {
    // 假设有saveData可以保存动态属性
    saveData();
});

這些內容將會在動態屬性章節中使用。

startup

它用於在世界正式啟動之前進行操作，在它的event資料中傳遞了itemComponentRegistry和blockComponentRegistry兩個註冊器。這將在事件遷移中使用。

watchdogTerminate

該事件與看門狗相關。這個內容在前文已有所介紹，此處不加贅述。

高級

裝置資訊

在System中，可以透過serverSystemInfo來取得伺服器系統資訊。目前其中只有一個可以使用的量：

memoryTier。它對應一組列舉用於表示記憶體的使用情況。一個更重要的資訊類在Player類中，ClientSystemInfo繼承於ServerSystemInfo，在關於Entity類基礎的地方我們會介紹到它。

isEditorWorld

isEditorWorld同樣在System中，它用於判斷目前是否是編輯器工作的世界。