類別調整器 26.1.2

了解什麼是類別調整器，以及如何設定它們。

WARNING

This page is written for version 26.1.2. Documentation for older versions may be incomplete.

類別調整器（Class Tweakers）先前稱為存取權限擴寬器（Access Wideners），在取得更多功能後改稱為類別調整器。 它提供了可補充 Mixin 位元組碼操作的轉換工具，也能讓部分執行時期修改在開發環境中可見。

WARNING

類別調整器並不針對特定 Minecraft 版本，但僅從 Fabric Loader 0.18.0 與 Loom 1.12 起可用，且只能以原版 Minecraft 類別為目標。

設定

檔案格式

類別調整器檔案通常會依照你的 modid 命名，例如 example-mod.classtweaker，以協助 IDE 外掛辨識。 它們應存放在 resources 中。

檔案第一行必須包含以下標頭：

classTweaker  v1  official

某些功能可能需要高於 v1 的版本；若有此需求，會在各自的頁面中說明。

類別調整器檔案可以包含空白行，以及以 # 開頭的註解。 註解也可以從一行的結尾開始。

語法會依使用的功能而有所不同，但每項修改都會以獨立一行的「條目」（entry）宣告，並以指定要套用哪種修改的「指令」（directive）開頭。 條目中的各個元素可以使用任何空白字元分隔，包括定位字元。

傳遞性條目

若要讓依賴你的模組的其他模組，也能在反編譯原始碼中看到你所做的變更，請在指令前加上 transitive-：

# Transitive Access Widening directives
transitive-accessible
transitive-extendable
transitive-mutable

# Transitive Interface Injection directive
transitive-inject-interface

# Transitive Enum Extension directive
transitive-extend-enum

指定檔案位置

類別調整器檔案的位置必須在你的 build.gradle 與 fabric.mod.json 檔案中指定。 請記得，你也必須依賴 Fabric Loader 0.18.0 或以上版本，才能使用類別調整器。

為了維持向後相容性，相關設定名稱仍沿用存取權限擴寬器的命名。

build.gradle

loom {

	accessWidenerPath = file("src/main/resources/example-mod.classtweaker")

}

fabric.mod.json

...

"accessWidener": "example-mod.classtweaker",

...

在 build.gradle 檔案中指定檔案位置後，請務必在 IDE 中重新載入 Gradle 專案。

驗證檔案

預設情況下，類別調整器會忽略參照到找不到的修改目標的條目。 若要檢查檔案中指定的所有類別、欄位與方法是否有效，請執行 validateAccessWidener Gradle 工作。

錯誤訊息會指出任何無效條目，但不一定會明確指出條目中的哪個部分無效。