API ResourcePackManager
ResourcePackManager expose une API Java qui permet a d'autres plugins d'enregistrer leurs resource packs pour la fusion au moment de l'execution.
Acceder a l'API
La classe API est com.magmaguy.resourcepackmanager.api.ResourcePackManagerAPI. Toutes les methodes sont statiques.
Enregistrer un Resource Pack
Il existe trois methodes d'enregistrement selon que votre pack est local, distant ou les deux.
registerResourcePack
ResourcePackManagerAPI.registerResourcePack(
String pluginName,
String localPath,
String url,
boolean encrypts,
boolean distributes,
boolean zips,
String reloadCommand
);
Enregistre un resource pack qui peut provenir d'un chemin local ou d'une URL distante. Exactement l'un des parametres localPath ou url doit etre non-null.
registerLocalResourcePack
ResourcePackManagerAPI.registerLocalResourcePack(
String pluginName,
String localPath,
boolean encrypts,
boolean distributes,
boolean zips,
String reloadCommand
);
Enregistre un resource pack depuis un chemin local relatif au repertoire plugins.
registerRemoteResourcePack
ResourcePackManagerAPI.registerRemoteResourcePack(
String pluginName,
String url,
boolean encrypts,
boolean distributes,
boolean zips,
String reloadCommand
);
Enregistre un resource pack qui sera telecharge depuis l'URL fournie.
Parametres
| Parametre | Description |
|---|---|
pluginName | Le nom de votre plugin exactement tel qu'il apparait dans la liste des plugins. Sensible a la casse. |
localPath | Chemin relatif depuis le repertoire plugins vers votre fichier ou dossier de resource pack. |
url | URL pour telecharger le resource pack. |
encrypts | Reserve pour une utilisation future. Ne fait rien actuellement. |
distributes | Reserve pour une utilisation future. Ne fait rien actuellement. |
zips | Si le resource pack est deja zippe. Si false, ResourcePackManager le zippera avant la fusion. |
reloadCommand | La commande de rechargement de votre plugin. Reserve pour une utilisation future. |
Declencher un rechargement
ResourcePackManagerAPI.reloadResourcePack();
Recharge ResourcePackManager, qui fusionne a nouveau tous les packs enregistres et re-heberge le resultat si l'hebergement automatique est active.
Notes
- Les packs enregistres via l'API participent a
priorityOrderde la meme maniere que les integrations internes. Ajoutez le nom de votre plugin apriorityOrderdansconfig.ymlpour controler sa position dans l'ordre de fusion. - Si le nom de votre plugin n'est pas dans
priorityOrder, votre pack recoit la priorite la plus basse. - L'enregistrement doit se faire durant le
onEnableou l'initialisation de votre plugin, avant que ResourcePackManager ne termine sa propre initialisation et ne declenche la premiere fusion.