Aller au contenu principal

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

ParametreDescription
pluginNameLe nom de votre plugin exactement tel qu'il apparait dans la liste des plugins. Sensible a la casse.
localPathChemin relatif depuis le repertoire plugins vers votre fichier ou dossier de resource pack.
urlURL pour telecharger le resource pack.
encryptsReserve pour une utilisation future. Ne fait rien actuellement.
distributesReserve pour une utilisation future. Ne fait rien actuellement.
zipsSi le resource pack est deja zippe. Si false, ResourcePackManager le zippera avant la fusion.
reloadCommandLa 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 priorityOrder de la meme maniere que les integrations internes. Ajoutez le nom de votre plugin a priorityOrder dans config.yml pour 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 onEnable ou l'initialisation de votre plugin, avant que ResourcePackManager ne termine sa propre initialisation et ne declenche la premiere fusion.