跳至主要内容

ResourcePackManager API

ResourcePackManager 公開 Java API,讓其他外掛程式在執行時註冊其資源包以進行合併。

存取 API

API 類別為 com.magmaguy.resourcepackmanager.api.ResourcePackManagerAPI。所有方法都是靜態的。

註冊資源包

根據您的資源包是本機、遠端或兩者皆可,有三種註冊方法。

registerResourcePack

ResourcePackManagerAPI.registerResourcePack(
String pluginName,
String localPath,
String url,
boolean encrypts,
boolean distributes,
boolean zips,
String reloadCommand
);

註冊一個可來自本機路徑或遠端 URL 的資源包。localPathurl 應恰好有一個非 null。

registerLocalResourcePack

ResourcePackManagerAPI.registerLocalResourcePack(
String pluginName,
String localPath,
boolean encrypts,
boolean distributes,
boolean zips,
String reloadCommand
);

從相對於 plugins 目錄的本機路徑註冊資源包。

registerRemoteResourcePack

ResourcePackManagerAPI.registerRemoteResourcePack(
String pluginName,
String url,
boolean encrypts,
boolean distributes,
boolean zips,
String reloadCommand
);

註冊一個將從提供的 URL 下載的資源包。

參數

參數說明
pluginName您的外掛程式名稱,需與外掛程式列表中顯示的名稱完全一致。區分大小寫。
localPathplugins 目錄到您的資源包檔案或資料夾的相對路徑。
url下載資源包的 URL。
encrypts保留供未來使用。目前沒有作用。
distributes保留供未來使用。目前沒有作用。
zips資源包是否已壓縮。如果為 false,ResourcePackManager 會在合併前進行壓縮。
reloadCommand您的外掛程式的重新載入指令。保留供未來使用。

觸發重新載入

ResourcePackManagerAPI.reloadResourcePack();

重新載入 ResourcePackManager,重新合併所有已註冊的資源包,並在啟用自動託管時重新託管結果。

注意事項

  • 透過 API 註冊的資源包與內建整合一樣參與 priorityOrder。在 config.yml 中將您的外掛程式名稱加入 priorityOrder 以控制其在合併順序中的位置。
  • 如果您的外掛程式名稱未列在 priorityOrder 中,您的資源包將獲得最低優先順序。
  • 註冊應在您的外掛程式的 onEnable 或初始化期間進行,在 ResourcePackManager 完成自身初始化並觸發第一次合併之前。