Commands and Permissions

Feb 25, 2019
Commands and Permissions
  • [​IMG]
    [​IMG]


    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 help 8:
          description: Displays the eighth page of the available help menu.
          permission: itemjoin.use
          usage: |
              /itemjoin help 8
       itemjoin reload:
          description: Reloads all ItemJoins configuration files and caches any new data.
          permission: itemjoin.reload
          usage: |
              /itemjoin reload
       itemjoin creator:
          description: Opens a GUI Menu to allow the view, modification, and creation of all ItemJoin items.
          permission: itemjoin.creator
          usage: |
              /itemjoin creator
       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> <amount>:
          description: Gives you the item and the amount you specified.
          permission: itemjoin.get
          usage: |
              /itemjoin get <item> <amount>
              Example: /itemjoin get Ultra 12 - You have received the item [Ultra]!
       itemjoin get <item> <player>:
          description: Gives 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 get <item> <player> <amount>:
          description: Gives the amount of the item you specified to the player.
          permission: itemjoin.get.others
          usage: |
              /itemjoin get <item> <player> <amount>
              Example: /itemjoin get Ultra RockinChaos 8 - You have given the item [Ultra] to RockinChaos!
       itemjoin getOnline <item>:
          description: Gives the item you specified to all online players of the server.
          permission: itemjoin.get.others
          usage: |
              /itemjoin getOnline <item>
              Example: /itemjoin getOnline Ultra - 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] from RockinChaos!
       itemjoin removeOnline <item>:
          description: Removes the item you specified from all online players of the server.
          permission: itemjoin.remove.others
          usage: |
              /itemjoin removeOnline <item>
              Example: /itemjoin removeOnline Ultra - You have removed the item [Ultra] from 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 players 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 said player from the database file.
          permission: itemjoin.purge
          usage: |
              /itemjoin purge first-join <player>
       itemjoin purge first-world <player>:
          description: This will purge all first-world data for the said player from the database file.
          permission: itemjoin.purge
          usage: |
              /itemjoin purge first-world <player>
       itemjoin purge ip-limits <player>:
          description: This will purge all ip-limits data for said player from the database file.
          permission: itemjoin.purge
          usage: |
              /itemjoin 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.creator: 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 use of basic commands.
          default: true
       itemjoin.reload:
          description: Allows use of /itemjoin reload command.
          default: false
       itemjoin.creator:
          description: Allows use of /itemjoin creator 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


    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...