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 的資源包。localPath 或 url 應恰好有一個非 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 | 您的外掛程式名稱,需與外掛程式列表中顯示的名稱完全一致。區分大小寫。 |
localPath | 從 plugins 目錄到您的資源包檔案或資料夾的相對路徑。 |
url | 下載資源包的 URL。 |
encrypts | 保留供未來使用。目前沒有作用。 |
distributes | 保留供未來使用。目前沒有作用。 |
zips | 資源包是否已壓縮。如果為 false,ResourcePackManager 會在合併前進行壓縮。 |
reloadCommand | 您的外掛程式的重新載入指令。保留供未來使用。 |
觸發重新載入
ResourcePackManagerAPI.reloadResourcePack();
重新載入 ResourcePackManager,重新合併所有已註冊的資源包,並在啟用自動託管時重新託管結果。
注意事項
- 透過 API 註冊的資源包與內建整合一樣參與
priorityOrder。在config.yml中將您的外掛程式名稱加入priorityOrder以控制其在合併順序中的位置。 - 如果您的外掛程式名稱未列在
priorityOrder中,您的資源包將獲得最低優先順序。 - 註冊應在您的外掛程式的
onEnable或初始化期間進行,在 ResourcePackManager 完成自身初始化並觸發第一次合併之前。