Skip to content

Permissions

TheRobLP edited this page Nov 21, 2022 · 13 revisions

Index:

Permissions are case sensitive, including the world names!​


itemjoin.<world>.<item>

Description:
These are the permission(s) required for player(s) who are not a server administrator to receive the item(s).

Argument(s):

  • <world> - The world that the player(s) have permission to get the custom item in.
  • <item> - The name of the item in the items.yml, this is the identifier, NOT the actual items custom name! By default defining this with a star will the player permission to get ALL items in that world.

Information:

  • Given by default

While this permission is NOT given by default, ALL items have their permission requirement disabled by default. In order for this permission to work (only if you intend on using item permissions), in the config.yml set Permissions.Obtain-Item to TRUE.

If you want to have a custom permission node for each item, you can set up individual ones which will supersede the default node shown above. All you have to do is add the permission-node to your item, in this case, we will call it itemjoin.specialty but it can technically be anything such as chicken.fingers. The permission you choose will need to be given to the player and added to the item in this format permission-node: 'itemjoin.specialty'. Lastly, custom permission nodes can be used interchangeably with the default permission nodes in the instance where you only want a few items to have custom permission nodes.

Example(s):

itemjoin.world_the_end.*
itemjoin.world_the_end.ultra-item
  example-item:
    id: DIAMOND_SWORD
    slot: 0
    permission-node: 'itemjoin.specialty'

itemjoin.bypass.inventorymodify

Description:
Bypasses any item movement restrictions.

Information:

  • Given by default

Any player with this permission will bypass the inventory-modify itemflags and item movement restrictions for all items, allowing them to be able to move any item in their inventory.


itemjoin.lang.<categories.node>

Description:
Setting this permission to FALSE in any permission plugin will prevent the lang message from being sent to the specified group or players. You must define both the categories and the node when specifying the lang message.

Information:

  • Given by default

If you do not know how to set a permission as FALSE in your permission plugin please contact the developer.

Example(s):

itemjoin.lang.commands.default.unknownCommand
itemjoin.lang.general.failedOverwrite
itemjoin.lang.commands.menu.openMenu

itemjoin.all

Description:
Grants access to all aspects of the plugin, including every permission node.

Information:

  • Given by default

The alternative permission node is itemjoin.* as they have the same effect, although is not recommended.


itemjoin.menu

Description:
Grants access to the menu command.

Command(s):

/itemjoin menu

Information:

  • Given by default

Allows the executor to create, modify, and view all custom items.


itemjoin.use

Description:
Grants access to basic plugin commands.

Command(s):

/itemjoin
/itemjoin help
/itemjoin info
/itemjoin world

Information:

  • Given by default

Allows the executor to view the help menu, author credits, the world that they are in, and the material data of the item they are holding.


itemjoin.permissions

Description:
Grants access to the permissions command

Command(s):

/itemjoin permissions

Information:

  • Given by default

Allows the executor to view which plugin permissions and custom item permissions are enabled and disabled for them.


itemjoin.reload

Description:
Grants access to the reload command.

Command(s):

/itemjoin reload

Information:

  • Given by default

Allows the executor to reload the plugin configuration file(s).


itemjoin.query

Description:
Grants access to the query command.

Command(s):

/itemjoin query

Information:

  • Given by default

Allows the executor to query the plugin for information on a specific custom item.


itemjoin.updates

Description:
Grants access to the updates command.

Command(s):

/itemjoin updates

Information:

  • Given by default

itemjoin.upgrade

Description:
Grants access to the upgrade command.

Command(s):

/itemjoin upgrade

Information:

  • Given by default

itemjoin.autoupdate

Description:
Grants access to the autoupdate command.

Command(s):

/itemjoin autoupdate

Information:

  • Given by default

Warning: Allows the executor to FORCE UPDATE the plugin to the latest version if a new version is detected.


itemjoin.list

Description:
Grants access to the list command.

Information:

  • Given by default

Allows the executor to view the active custom items and their respective worlds.


itemjoin.purge

Description:
Grants access to the purge command.

Command(s):

/itemjoin purge

Information:

  • Given by default

Warning: Allows the executor to purge ALL data from the database file!


itemjoin.get

Description:
Grants access to the basic get commands.

Command(s):

/itemjoin get

Information:

  • Given by default

Allows the executor to give themselves any of the custom items and specify an amount.


itemjoin.get.others

Description:
Grants access to all get commands that could affect other players.

Command(s):

/itemjoin getOnline
/itemjoin getAll <player>
/itemjoin get <item> <player>

Information:

  • Given by default

Allows the executor to give any custom item to any or all players and any specified amount.


itemjoin.remove

Description:
Grants access to the basic remove commands.

Command(s):

/itemjoin remove

Information:

  • Given by default

Allows the executor to remove any custom items from themselves and any custom amount.


itemjoin.remove.others

Description:
Grants access to all remove commands that could affect other players.

Command(s):

/itemjoin removeOnline
/itemjoin removeAll <player>
/itemjoin remove <item> <player>

Information:

  • Given by default

Allows the executor to remove any custom item from any or all players and any specified amount.


itemjoin.enable

Description:
Grants access to the basic enable command.

Command(s):

/itemjoin enable

Information:

  • Given by default

Allows the executor to enable custom items for ALL players.


itemjoin.enable.others

Description:
Grants access to all enable commands that could affect other players individually.

Command(s):

/itemjoin enable <player>

Information:

  • Given by default

Allows the executor to enable custom items for individual players in any or all worlds.


itemjoin.disable

Description:
Grants access to the basic disable command.

Command(s):

/itemjoin disable

Information:

  • Given by default

Allows the executor to disable custom items for ALL players.


itemjoin.disable.others

Description:
Grants access to all disable commands that could affect other players individually.

Command(s):

/itemjoin disable <player>

Information:

  • Given by default

Allows the executor to disable custom items for individual players in any or all worlds.