API / Hooks

Sep 21, 2017
API / Hooks
  • This page still has a lot I need to add to it so if you have any questions about anything feel free to send me a Direct Message.

    How does TokenEnchant work?
    Currently, setting TokenEnchant to true in your config.yml gives you access to the following;

    You can add any TokenEnchantment to the correct/corresponding item it is allowed to be placed on,
    TokenEnchantments work the same way as regular/default Minecraft enchants for ItemJoin it just simply piggybacks off the already created system.

    Using the already provided enchantments identifier you can create an item with several TokenEnchantments as such;

    Code (Text):
        enchantment: TokenEnchantName:PowerLevel, TokenEnchantName:PowerLevel, TokenEnchantName:PowerLevel, TokenEnchantName:PowerLevel
    You can even use regular Minecraft enchantments at the same time for example;

    Code (Text):
        enchantment: EXPLOSIVE:3, DISK:2, ARROW_DAMAGE:3, DAMAGE_ALL:5
    As you can see I have two token enchantments as well as two default Minecraft enchantments all on one item. The first two enchants as you can see are the token enchantments.

    Here is an example of these enchants on an item;
    Code (Text):
    items:
      any-text:
        id: BOW
        slot: 0
        enchantment: EXPLOSIVE:3, DISK:2, ARROW_DAMAGE:3, DAMAGE_ALL:5
        enabled-worlds: world_name_here, another_world_name

    How does PlaceholderAPI work?
    How do Placeholders work?
    ItemJoin supports PlaceholderAPI, meaning it can hook into the plugin and use those placeholders! You can use ANY of these placeholders, in all parts of ItemJoin. Such as, skull-owner, name, lore, book pages, commands, cooldown-messages, and more! Placeholders will be supported by all parts of ItemJoin!!

    If you do not use PlaceholderAPI, ItemJoin currently only has two placeholders by default; which is %player% and %hitplayer%. This will be expanded upon in the future but it is highly recommended that you use PlaceholderAPI, as it is so useful and has so many features!


    How does Vault work?
    More info to be posted..


    How does AuthMe work?
    More info to be posted..


    How does Multiverse-Core work?
    More info to be posted..


    How does Multiverse-Inventories work?
    More info to be posted..


    How does PerWorldInventory work?
    More info to be posted..


    How does xInventories work?
    More info to be posted..


    How does PerWorldPlugins work?
    More info to be posted..


    How does MyWorld work?
    More info to be posted..


    How does WorldGuard work?
    How can I get items in a certain region?

    ItemJoin supports WorldGuard, meaning that you can hook into the plugin and use certain regions. If you want to receive items upon entering, joining, respawning into that region it's really simple.

    You have to set WorldGuard to true in the config.yml, then set the enabled-regions per item, you can set multiple regions separated by commas. Lastly, you have to set the triggers to region-enter. You can make your items multipurpose saying you can receive them on join anywhere but you can also get them when entering a region, see the available triggers above to set up more than just a region-enter trigger.

    Here is an example of several items you can get when entering/joining into/respawning into region1 and region2;
    Code (Text):
    items:
     first-item:
       d: SKULL_ITEM
       slot: 0
       triggers: region-enter
       enabled-regions: region1, region2
     second-item:
       id: DIAMOND_SWORD
       slot: Arbitrary
       triggers: region-enter
       enabled-regions: region1, region2
     helmet-item:
       id: DIAMOND_HELMET
       slot: Helmet
       triggers: region-enter
       enabled-regions: region1, region2
     chestplate-item:
       id: 299
       slot: Chestplate
       triggers: region-enter, join, respawn, world-change
       enabled-regions: region1, region2
     leggings-item:
       id: DIAMOND_LEGGINGS
       slot: Leggings
       triggers: region-enter, join, respawn, world-change
       enabled-regions: region1, region2
     boots-item:
       id: LEATHER_BOOTS
       slot: Boots
       triggers: region-enter
       enabled-regions: region1, region2
  • Loading...
  • Loading...