General Information:

The idea of this plugin is that players need to have an item, or items in their possession to enter a region. It can either be a WorldGuard region or a region you define within the plugin. There are options to define if keys need to be held in the main hand, in the off hand, worn, on the hotbar, or just anywhere in inventory. To be exempted from the key requirement, a user needs itemkeys.exempt permission.

For the commands, you can also use /IK as an alias to /ITEMKEYS

Commands:

ITEMKEYS ADD world region
itemkeys.add
Adds the item currently in hand as a required key for the region in the specified world.

ITEMKEYS DEL world region
itemkeys.del
Removes the item currently held in hand as a required key for the region in the specified world

ITEMKEYS LIST
itemkeys.list
Lists all regions that have key requirements, and what said requirements are

ITEMKEYS CLEAR world region
itemkeys.clear
Deletes all key requirements for a region

ITEMKEYS ESCAPE
itemkeys.escape
If you are stuck in a region and cannot move due to a lack of the key, this takes you to spawn.

ITEMKEYS RELOAD
itemkeys.reload
Reloads config from disk

ITEMKEYS CFG HOLDING (position) (status)
itemkeys.cfg.holding
Sets where keys need to be located to be valid. Pass no arguments to view the status of all possible locations.

ITEMKEYS CFG LIST-HOLDING-LOCATIONS (true | false)
itemkeys.cfg.list-holding-locations
Sets whether or not to show valid locations for keys when a person is denied entry. Omit the argument to view current status

ITEMKEYS CFG LIST-KEYS-ON-FAIL (true | false)
itemkeys.cfg.list-keys-on-fail
Sets whether or not to show the keys that are required to enter when a person is denied entry. Omit the argument to view current status

ITEMKEYS RG DEFINE name (we) (overwrite)
itemkeys.rg.define
Begins the region definition process. If you pass the argument we, it will attempt to use an existing WorldEdit selection for the region. If you pass the argument overwrite, it will overwrite existing regions.

ITEMKEYS RG DELETE world name
itemkeys.rg.delete
Deletes a region

ITEMKEYS RG LIST
itemkeys.rg.list
Lists regions


Miscellaneous:

If you want to define your own regions without using WorldGuard, you do /ik rg define (name). Once you do that, it will be in marking mode. You need to right click one corner of the cuboid that will define your region. If you do the command again before completing the selection, it will abort the marking process. Once you right click the first corner, you then need to right click the opposite corner then it will save the region. Be sure to allow for the Y range - don't just click two corners on a floor or else the region will be flat and essentially useless.