Bukkit

Documentation

This is the documentation for SerialKey v1.0.

How to clone a key ?

As of v0.2, you are able to clone a key. It is easy, all you have to do is to put a blank key next to a key, like that :

That's all ! You get two keys and they open the same padlock.

How to use the bunch of keys ?

As of v0.2, you are able to create a bunch of keys (see below for the default craft).
Right click with it will open an inventory in which you can put keys in. It is limited to one key per slot.

You can open padlocks with a bunch of keys if it contains the correct key.

How to use the padlock finder ?

As of v0.2, you are able to create a padlock finder with the following craft (a key next to a compass) :

When you make a right click with it, every compass in your inventory will point to the selected padlock.
Right click again with a padlock finder to disable it.

Commands

/serialkey getkey - See below for permission. - Allows you to get the key corresponding to your facing block.

Permissions

• serialkey.craft.key - Allows you to craft a key. - Default : Everyone.
• serialkey.craft.masterkey - Allows you to craft a master key. - Default : Operators.
• serialkey.craft.keyclone - Allows you to craft a key clone. - Default : Everyone.
• serialkey.craft.bunchofkeys - Allows you to craft a bunch of keys. - Default : Everyone.
• serialkey.craft.padlockfinder - Allows you to craft a padlock finder. - Default : Everyone.
• serialkey.use.key - Allows you to use a key. - Default : Everyone.
• serialkey.use.masterkey - Allows you to use a master key. - Default : Operators.
• serialkey.use.bunchofkeys - Allows you to use a bunch of keys. - Default : Everyone.
• serialkey.use.padlockfinder - Allows you to use a padlock finder. - Default : Everyone.
• serialkey.command.getkey - Allows you to use /serialkey getkey. - Default : Operators.

Configuration

Please stop your server before each modification !

config.yml

This file allows to configure the plugin.

enable - Contains the third party services options.

— updater - If you want to enable the Skyupdater.
— metrics - If you want to enable bStats.

options - Contains the plugin options.
— reusable-keys - When you destroy a door, if this option is set to true, the plugin will pop a blank key in front of yourself. Otherwise, the key will be broken.
— disable-hoppers - If you want to disable the ability to place hoppers next to locked chests.
encrypt-lore - This will encrypt keys' lore with the ROT47 algorithm.
— can-rename-items - Whether items can be renamed (be warned : any item of the same kind can be used as a replacement).
— allow-lost-chests - Whether players can place keys that unlock chests in them.

key - Contains the key item options.
— material - The key item material. A list of available materials is available here.
— name - The key item name. Supports colors.
— shape - The key item craft's shape. Max. three lines and three characters by line. Example : 'ABA', 'BAB', 'ABA'.
The default craft is :

master-key - Contains the master key item options.
— material - The master key item material. A list of materials is available here.
— name - The master key item name. Supports colors.
— shape - The master key item craft's shape. Max. three lines and three characters by line. Example : 'ABA', 'BAB', 'ABA'.
The default craft is :

bunch-of-keys - Contains the bunch of keys item options.
— material - The bunch of keys item material. A list of materials is available here.
— name - The bunch of keys item name. Supports colors.
— shape - The bunch of keys item craft shape. Max. three lines and three characters by line. Example : 'ABA', 'BAB', 'ABA'.
The default craft is :

— shape-materials-vX - Contains data about the shape. Example : A: GRASS, B: STONE, C: SPONGE. Do not take care about vX. A list of materials is available here.

messages.yml

This file contains the plugin's messages. You can translate it in your language.

data.yml

This file contains the plugin's data. Please, ignore this (and do not edit it manually).