ResourcePackManager API

ResourcePackManagerは、他のプラグインがランタイムでリソースパックをマージ登録できるJava APIを公開しています。

APIへのアクセス

APIクラスは com.magmaguy.resourcepackmanager.api.ResourcePackManagerAPI です。すべてのメソッドはstaticです。

リソースパックの登録

パックがローカル、リモート、またはいずれかに応じて、3つの登録メソッドがあります。

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	リソースパックが既にzip形式かどうか。false の場合、ResourcePackManagerがマージ前にzip化します。
reloadCommand	プラグインのリロードコマンド。将来の使用のために予約済み。

リロードのトリガー

ResourcePackManagerAPI.reloadResourcePack();

ResourcePackManagerをリロードし、登録されたすべてのパックを再マージします。自動ホスティングが有効な場合は結果を再ホストします。

備考

• APIを通じて登録されたパックは、組み込み連携と同様に priorityOrder に参加します。マージ順序を制御するには、config.yml の priorityOrder にプラグイン名を追加してください。
• プラグイン名が priorityOrder に記載されていない場合、パックは最低の優先度を受けます。
• 登録はプラグインの onEnable または初期化中に行い、ResourcePackManagerが独自の初期化を完了して最初のマージをトリガーする前に行う必要があります。