Using signs you will have the ability to restrict access to the contents of chests, dispensers, furnaces, and doors. Containers To protect a container simply place a signpost on the floor directly beside a chest or other container to be locked. Enter [Private] as the first line. Your own name will automatically be entered on line 2 as the chest owner. Optionally type in the full names of two other users allowed to access the chest's inventory on lines 3 and 4. When done correctly, the sign will automatically fix itself to the side the target chest, protecting it from unauthorized access! Only the chest's owner can then break the sign or chest. Additionally, you can enter [Everyone] on lines 3 or 4 instead of a user name to allow everyone access to the contents of a private container, or replace “Everyone” with the name of a rank on the server e.g. [King]. The owner of a container can add more users by placing additional signs beside the container with the heading [More Users], where lines 2-4 specify the names of the additional users. You can edit the users on previously placed signs by right clicking the sign, and using the command '/lockette <line number> <text>' to change it.
To protect a door, you can use the same method as protecting a container, the sign will attach to the door automatically. In addition, you can attach a [Private] wall sign to any side of the blocks just above or just below a door. For double doors only one side needs a sign. Once a door is protected it will only open for someone listed as a user, and will not respond to redstone power or switches unless [Everyone] is listed as a user. Iron doors which usually won't open from clicking will work just as wooden doors. In addition, double doors will open together automatically! You can also use [More Users] signs as with containers, with the caveat that the sign cannot be placed on the block above the door if the [Private] sign is not above the door as well! (This is done to prevent a security uncertainty issue.) Protected doors will be closed automatically if a timer is set. A timer can be set globally with a configuration option, or individually for each door by using the tag [Timer: #] on line 3 or 4 of the [Private] sign, where # is the number of seconds that the door should remain open. If the timer is set to 0, this means the door will never automatically close. If no timer is specified, protected doors will use a global timer of 5. If the server is shut down cleanly any open doors will be closed, but in the event of a server crash while a door is open, it may remain so. Note that the initial state of a door is assumed to be closed. Care must be taken to place protected doors on a stable block. Building a door on sand, gravel, leaves, TNT and etcetera are allowed bythe plug-in, but cannot be secured fully.
Users can protect their own land using the protection stones sold at the market. Each block protects all blocks in a cuboid of a given radius, giving you a cube box of protected area that only the owner and owner-specified users can build or destroy in. In addition, protection blocks of the same size can be used to create larger protection fields. Simply place blocks so their fields overlap. The blocks come in three sizes: Small: Coal Ore These blocks protect a box with dimensions 11x11x11 blocks. Suggested for almost all projects. Medium: Lapis ore These blocks protect a box with dimensions 21x21x21 blocks. Suggested for large projects away from other buildings. Use caution when placing these as you may accidentally overlap someone's building. Large: Diamond ore These blocks protect a box with dimensions 41x41x41 blocks. Not suggested for most projects as its boundaries may easily overlap other buildings.
It is often better to get a lot of small protection blocks and combine them inside your building so you can fine-tune where the edge of your total protected area is. While holding a protection block in your hand, left-click a block near you to see a list of nearby fields that would be overlapped if you placed the protection stone there. Clicking on a block inside a protected field with a tool lists the fields that are protecting that block. Similar blocks can be used to create large fields by combining smaller ones. Although you CAN have multiple block sizes overlap, they will not link into one field.
These commands can be used to manipulate fields once a user has placed them (view these commands by doing /ps in the chat)
- /ps allow [player] : Allows the person named player to build and destroy inside any fields you are standing inside, or overlapping, that you own.
- /ps allow g:[group] : Allows the group named group to build and destroy inside any fields you are standing inside or overlapping, that you own.
- /ps allowall : Works the same as the above three, except it allows the user, group, or clan, to build and destroy inside ALL of your protected fields, not just ones you are inside.
- /ps remove : Works the same as the /PS ALLOW except in reverse, removing the user, group, or clan from the field you are standing inside.
- /ps removeall : Works the same as /PS ALLOWALL, except removing the user, group, or clan from the field you are standing inside.
- /ps allowed : Lists the allowed users, groups, and clans for the protection field you are standing inside.
- /ps locations : Lists the locations of fields you own.
- /ps who : Lists the names of people inside the field you are standing inside.
- /ps counts : Lists the number of each size protection field you own
- /ps mark : Displays a marker that shows each protection block you own within sight distance.
- /ps visualize : Displays a glass wall, ceiling, and floor around the entire protected area you are standing inside.
NOTE: The glass columns in /PS MARK, and the glass walls in /PS VISUALIZE, do NOT really exist. They are client-side only and will be removed when you move at all, or if you attempt to build on them. They will not affect anything in-game except you until they disappear.