Commands and Permissions

Aug 29, 2018
Commands and Permissions
  • [​IMG]

    (More details coming soon)


    Commands
    You can either use /ItemJoin or /IJ to execute a command.​
    Code (Text):

       itemjoin:
          description: Displays a menu giving credit to the creator and the help menu command.
          permission: itemjoin.use
          usage: |
              /itemjoin

       itemjoin help:
          description: Displays the first page of the available help menu.
          permission: itemjoin.use
          usage: |
              /itemjoin help

       itemjoin help 2:
          description: Displays the second page of the available help menu.
          permission: itemjoin.use
          usage: |
              /itemjoin help 2

       itemjoin help 3:
          description: Displays the third page of the available help menu.
          permission: itemjoin.use
          usage: |
              /itemjoin help 3

       itemjoin help 4:
          description: Displays the fourth page of the available help menu.
          permission: itemjoin.use
          usage: |
              /itemjoin help 4

       itemjoin help 5:
          description: Displays the fifth page of the available help menu.
          permission: itemjoin.use
          usage: |
              /itemjoin help 5

       itemjoin help 6:
          description: Displays the sixth page of the available help menu.
          permission: itemjoin.use
          usage: |
              /itemjoin help 6

       itemjoin help 7:
          description: Displays the seventh page of the available help menu.
          permission: itemjoin.use
          usage: |
              /itemjoin help 7

       itemjoin reload:
          description: Reloads all ItemJoins configuration files and caches any new data.
          permission: itemjoin.reload
          usage: |
              /itemjoin reload

       itemjoin info:
          description: Displays necessary held items information, such as material type.
          permission: itemjoin.use
          usage: |
              /itemjoin info

       itemjoin updates:
          description: Checks for updates that are available for the plugin.
          permission: itemjoin.updates
          usage: |
              /itemjoin updates

       itemjoin permissions:
          description: Checks what permissions you have for ItemJoin.
          permission: itemjoin.permissions
          usage: |
              /itemjoin permissions

       itemjoin permissions 2:
          description: Second page of checking what permissions you have for ItemJoin.
          permission: itemjoin.permissions
          usage: |
              /itemjoin permissions 2

       itemjoin save <item>:
          description: Saves the specified item to the items.yml.
          permission: itemjoin.save
          usage: |
              /itemjoin save <item>
              Example: /itemjoin save special-item - You have saved the item [special-item] to the items.yml.

       itemjoin get <item>:
          description: Gives you the item you specified.
          permission: itemjoin.get
          usage: |
              /itemjoin get <item>
              Example: /itemjoin get Ultra - You have received the item [Ultra]!

       itemjoin get <item> <player>:
          description: Gives you the item you specified to the player.
          permission: itemjoin.get.others
          usage: |
              /itemjoin get <item> <player>
              Example: /itemjoin get Ultra RockinChaos - You have given the item [Ultra] to RockinChaos!

       itemjoin remove <item>:
          description: Removes the item you specified from your inventory.
          permission: itemjoin.remove
          usage: |
              /itemjoin remove <item>
              Example: /itemjoin remove Ultra - You have removed the item [Ultra] from your inventory!

       itemjoin remove <item> <player>:
          description: Removes the item you specified to the player.
          permission: itemjoin.remove.others
          usage: |
              /itemjoin remove <item> <player>
              Example: /itemjoin remove Ultra RockinChaos - You have removed the item [Ultra] to RockinChaos!

       itemjoin enable:
          description: Enables the use of ItemJoin for all players globally.
          permission: itemjoin.enable
          usage: |
              /itemjoin enable
              Example: /itemjoin enable - You have globally enabled ItemJoin.

       itemjoin enable <player>:
          description: Enables the use of ItemJoin for the specified player.
          permission: itemjoin.enable.others
          usage: |
              /itemjoin enable <player>
              Example: /itemjoin enable RockinChaos - You have enabled ItemJoin for RockinChaos!

       itemjoin disable:
          description: Disables the use of ItemJoin for all players globally.
          permission: itemjoin.disable
          usage: |
              /itemjoin disable
              Example: /itemjoin disable - You have globally disabled ItemJoin.

       itemjoin disable <player>:
          description: Disables the use of ItemJoin for the specified player.
          permission: itemjoin.disable.others
          usage: |
              /itemjoin disable <player>
              Example: /itemjoin disable RockinChaos - You have disabled ItemJoin for RockinChaos!

       itemjoin getall:
          description: Gives you all ItemJoin items.
          permission: itemjoin.get
          usage: |
              /itemjoin getall
               Example: /itemjoin getall - You have received all of the ItemJoin items.

       itemjoin getall <player>:
          description: Gives the player all ItemJoin items.
          permission: itemjoin.get.others
          usage: |
              /itemjoin getall <player>
              Example: /itemjoin getall RockinChaos - You have given RockinChaos all of the ItemJoin items that are available.

       itemjoin removeall:
          description: Removes all ItemJoin items from your inventory.
          permission: itemjoin.remove
          usage: |
              /itemjoin removeall
              Example: /itemjoin removeall - You have removed all of the ItemJoin items from your inventory.

       itemjoin removeall <player>:
          description: Removes all ItemJoin items from the player's inventory.
          permission: itemjoin.remove.others
          usage: |
              /itemjoin removeall <player>
              Example: /itemjoin removeall RockinChaos - You have removed all of the ItemJoin items from RockinChaos.

       itemjoin world:
          description: Checks what world you are in, useful for debugging purposes.
          permission: itemjoin.use
          usage: |
              /itemjoin world

       itemjoin list:
          description: Checks what items you can get in each available world.
          permission: itemjoin.list
          usage: |
              /itemjoin list

       itemjoin autoupdate:
          description: Force updates ItemJoin, will require a server restart.
          permission: itemjoin.autoupdate
          usage: |
              /itemjoin autoupdate

       itemjoin purge:
          description: This will purge all data from the database file, removing all first-join players, ip-limited players, enabled/disabled players, and all other player data.
          permission: itemjoin.purge
          usage: |
              /itemjoin purge

       itemjoin purge first-join <player>:
          description: This will purge all first-join data for the said player from the database file.
          permission: itemjoin.purge
          usage: |
              /itemjoin purge first-join <player>

       itemjoin purge ip-limits <player>:
          description: This will purge all ip-limits data for the said player from the database file.
          permission: itemjoin.purge
          usage: |
              /itemjoin purge ip-limits <player>

       ij:
          description: Displays a menu giving credit to the creator and the help menu command.
          permission: itemjoin.use
          usage: |
              /ij

       ij help:
          description: Displays the first page of the available help menu.
          permission: itemjoin.use
          usage: |
              /ij help

       ij help 2:
          description: Displays the second page of the available help menu.
          permission: itemjoin.use
          usage: |
              /ij help 2

       ij help 3:
          description: Displays the third page of the available help menu.
          permission: itemjoin.use
          usage: |
              /ij help 3

       ij help 4:
          description: Displays the fourth page of the available help menu.
          permission: itemjoin.use
          usage: |
              /ij help 4

       ij help 5:
          description: Displays the fifth page of the available help menu.
          permission: itemjoin.use
          usage: |
              /ij help 5

       ij help 6:
          description: Displays the sixth page of the available help menu.
          permission: itemjoin.use
          usage: |
              /ij help 6

       ij help 7:
          description: Displays the seventh page of the available help menu.
          permission: itemjoin.use
          usage: |
              /ij help 7

       ij reload:
          description: Reloads all ItemJoins configuration files and caches any new data.
          permission: itemjoin.reload
          usage: |
              /ij reload

       ij info:
          description: Displays necessary held items information, such as material type.
          permission: itemjoin.use
          usage: |
              /ij info

       ij updates:
          description: Checks for updates that are available for the plugin.
          permission: itemjoin.updates
          usage: |
              /ij updates

       ij permissions:
          description: Checks what permissions you have for ItemJoin.
          permission: itemjoin.permissions
          usage: |
              /ij permissions

       ij permissions 2:
          description: Second page of checking what permissions you have for ItemJoin.
          permission: itemjoin.permissions
          usage: |
              /ij permissions 2

       ij save <item>:
          description: Saves the specified item to the items.yml.
          permission: itemjoin.save
          usage: |
              /ij save <item>
              Example: /ij save special-item - You have saved the item [special-item] to the items.yml.

       ij get <item>:
          description: Gives you the item you specified.
          permission: itemjoin.get
          usage: |
              /ij get <item>
              Example: /ij get Ultra - You have received the item [Ultra]!

       ij get <item> <player>:
          description: Gives you the item you specified to the player.
          permission: itemjoin.get.others
          usage: |
              /ij get <item> <player>
              Example: /ij get Ultra RockinChaos - You have given the item [Ultra] to RockinChaos!

       ij remove <item>:
          description: Removes the item you specified from your inventory.
          permission: itemjoin.remove
          usage: |
              /ij remove <item>
              Example: /ij remove Ultra - You have removed the item [Ultra] from your inventory!

       ij remove <item> <player>:
          description: Removes the item you specified to the player.
          permission: itemjoin.remove.others
          usage: |
              /ij remove <item> <player>
              Example: /ij remove Ultra RockinChaos - You have removed the item [Ultra] to RockinChaos!

       ij enable:
          description: Enables the use of ItemJoin for all players globally.
          permission: itemjoin.enable
          usage: |
              /ij enable
              Example: /ij enable - You have globally enabled ItemJoin.

       ij enable <player>:
          description: Enables the use of ItemJoin for the specified player.
          permission: itemjoin.enable.others
          usage: |
              /ij enable <player>
              Example: /ij enable RockinChaos - You have enabled ItemJoin for RockinChaos!

       ij disable:
          description: Disables the use of ItemJoin for all players globally.
          permission: itemjoin.disable
          usage: |
              /ij disable
              Example: /ij disable - You have globally disabled ItemJoin.

       ij disable <player>:
          description: Disables the use of ItemJoin for the specified player.
          permission: itemjoin.disable.others
          usage: |
              /ij disable <player>
              Example: /ij disable RockinChaos - You have disabled ItemJoin for RockinChaos!

       ij getall:
          description: Gives you all ItemJoin items.
          permission: itemjoin.get
          usage: |
              /ij getall
               Example: /ij getall - You have received all of the ItemJoin items.

       ij getall <player>:
          description: Gives the player all ItemJoin items.
          permission: itemjoin.get.others
          usage: |
              /ij getall <player>
              Example: /ij getall RockinChaos - You+ have given RockinChaos all of the ItemJoin items that are available.

       ij removeall:
          description: Removes all ItemJoin items from your inventory.
          permission: itemjoin.remove
          usage: |
              /ij removeall
              Example: /ij removeall - You have removed all of the ItemJoin items from your inventory.

       ij removeall <player>:
          description: Removes all ItemJoin items from the player's inventory.
          permission: itemjoin.remove.others
          usage: |
              /ij removeall <player>
              Example: /ij removeall RockinChaos - You have removed all of the ItemJoin items from RockinChaos.

       ij world:
          description: Checks what world you are in, useful for debugging purposes.
          permission: itemjoin.use
          usage: |
              /ij world

       ij list:
          description: Checks what items you can get in each available world.
          permission: itemjoin.list
          usage: |
              /ij list

       ij autoupdate:
          description: Force updates ItemJoin, will require a server restart.
          permission: itemjoin.autoupdate
          usage: |
              /ij autoupdate

       ij purge:
          description: This will purge all data from the database file, removing all first-join players, ip-limited players, enabled/disabled players, and all other player data.
          permission: itemjoin.purge
          usage: |
              /ij purge

       ij purge first-join <player>:
          description: This will purge all first-join data for the said player from the database file.
          permission: itemjoin.purge
          usage: |
              /ij purge first-join <player>

       ij purge ip-limits <player>:
          description: This will purge all ip-limits data for the said player from the database file.
          permission: itemjoin.purge
          usage: |
              /ij purge ip-limits <player>
     


    Permissions
    Please note; permissions are case sensitive, including the world names!​
    Code (Text):

       itemjoin.*:
          description: Allows use of all commands.
          default: false
          children:
              itemjoin.all: true

       itemjoin.all:
          description: Allows use of all commands.
          default: false
          children:
              itemjoin.permissions: true
              itemjoin.use: true
              itemjoin.reload: true
              itemjoin.updates: true
              itemjoin.autoupdate: true
              itemjoin.purge: true
              itemjoin.save: true
              itemjoin.get: true
              itemjoin.get.others: true
              itemjoin.remove: true
              itemjoin.remove.others: true
              itemjoin.enable: true
              itemjoin.enable.others: true
              itemjoin.disable: true
              itemjoin.disable.others: true
              itemjoin.list: true
              itemjoin.bypass.inventorymodify: false

       itemjoin.permissions:
          description: Use of the /itemjoin permissions commands.
          default: true

       itemjoin.use:
          description: Currently allows the use of basic commands.
          default: true

       itemjoin.reload:
          description: Allows use of reload command.
          default: false

       itemjoin.updates:
          description: Use of the /itemjoin updates command.
          default: false

       itemjoin.autoupdate:
          description: Use of the /itemjoin autoupdate command.
          default: false

       itemjoin.purge:
          description: Use of the /itemjoin purge command.
          default: false

       itemjoin.save:
          description: Use of the /itemjoin save <item> command.
          default: false

       itemjoin.get:
          description: Use of the /itemjoin get <item> command.
          default: false

       itemjoin.get.others:
          description: Use of the /itemjoin get <item> <player> for player command.
          default: false

       itemjoin.remove:
          description: Use of the /itemjoin remove <item> command.
          default: false

       itemjoin.remove.others:
          description: Use of the /itemjoin remove <item> <player> for player command.
          default: false

       itemjoin.enable:
          description: Use of the /itemjoin enable global command.
          default: false

       itemjoin.enable.others:
          description: Use of the /itemjoin enable <player> for player command.
          default: false

       itemjoin.disable:
          description: Use of the /itemjoin disable global command.
          default: false

       itemjoin.disable.others:
          description: Use of the /itemjoin disable <player> for player command.
          default: false

       itemjoin.list:
          description: Use of the /itemjoin list command.
          default: false

       itemjoin.bypass.inventorymodify:
          description: Players will this permission will bypass any effect that the inventory modify flag has.
          default: false

       itemjoin.Your_Specified_World_Name_Here.Item_Name:
          description: Gives permission to get a specific item in a specific world. Replace Item_Name with the name of the specified item (in the items.yml) and Your_Specified_World_Name_Here with the name of the world to receive that item.
          default: false

       itemjoin.Your_Specified_World_Name_Here.*:
          description: Gives permission to get all items from the specified world. Replace Your_Specified_World_Name_Here with the name of the world to receive that item.
          default: false


    Item Permissions
    These are the permission(s) required for players who are not a server administrator to receive the item(s).
    Please note; permissions are case sensitive, including the world names! Sometimes certain permissions plugins fix this but in reality, it depends on the permissions plugin you use.​
    Code (Text):
    itemjoin.Your_Specified_World_Name_Here.Item_Name:
    description: Gives permission to get a specific item in a specific world. Replace Item_Name with the name of the specified item (in the items.yml) and Your_Specified_World_Name_Here with the name of the world to receive that item.
    default: false

    itemjoin.Your_Specified_World_Name_Here.*:
    description: Gives permission to get all items from the specified world. Replace Your_Specified_World_Name_Here with the name of the world to receive that item.
    default: false

    (I recommend itemjoin.Your_Specified_World_Name_Here.* as it would be easier unless you are trying to create permission group specific items)


    Remember to replace Your_Specified_World_Name_Here with your world's name. If you need to see what world you want the items in, simply stand in the world and type /itemjoin world this will tell you the world name you are in that you want to put in the permission node.

    The other option is to add a permission node for each specific item you have created. You can use these interchangeably such as adding a custom permission node to one item and using the default permission nodes listed above for items without a dedicated permission node.

    Simply add the following to your item and replace specialty with your desired text. You can change the permission node to whatever you want such as 'example.fish'. I simply chose to use ItemJoin as the beginning string of the custom permission node. Make sure add the custom permissions you create to a permissions plugin afterward.


    Add this to your item;
    Code (Text):
        permission-node: 'itemjoin.specialty'


    Here is an example of an item utilizing the custom permission node utility;
    Code (Text):
    items:
      example-item:
        id: DIAMOND_SWORD
        slot: 0
        permission-node: 'itemjoin.specialty'
  • Loading...
  • Loading...