CraftBookToggle areas

Toggleable areas allow you to save an area and toggle it on or off. Multiple areas can be in the same location as well and you can toggle between them. Areas are saved per-user in a folder for each user. You can also define custom namespaces (folders) but Players with these permission will have access to other user folders.

This function requires WorldEdit (a plugin) because it requires selecting cuboids. You only need to use its cuboid selection functions.

Defining areas

The craftbook.mech.area.save.self permission must be given.

1. Select an area with WorldEdit.
2. Type /area save <area name> . You may only use numbers and letters and no spaces. The name is case insensitive and can be a maximum of 13 characters long.
3. The area is now saved under your player.

Saving to other namespaces

The craftbook.mech.area.save.<namespace> permission must be given.

1. Select an area with WorldEdit.
2. Type /area save -n <namespace> <area name>. You may only use numbers and letters and no spaces. The name is case insensitive and can be a maximum of 13 characters long. The namespace is case sensitive and can be a maximum of 14 characters long. You cannot currently save under another player's namespace as it is considered 'personal' and can only be saved to by that user.
3. The area is now saved under the specified namespace.

Toggling areas

You can see what area is currently displayed by the "-" around the areas name.

[Area]

The craftbook.mech.area.sign.area permission must be given.

Create a sign post with the second line as [Area], if your regions are saved in a different namespace set the first line as the namespace, otherwise leave it blank. The third line should be the areas on state, whilst the fourth line should be its off state, which can be left blank. Right clicking the sign will toggle the area.

The signs can be wired with redstone.

[SaveArea]

The craftbook.mech.area.sign.savearea permission must be given.

Same as above but on the second line write [SaveArea]. This will create an area sign, that will save the areas on toggle, to prevent duping.

Commands

Command	Flags	Permission	Description
/area save <area name>	-n <namespace>	craftbook.mech.area.save[.self]/[.<namespace>]	Saves the area to the users namespace or given namespace.
/area list [page]	-n <namespace>	craftbook.mech.area.list[.self]/[.<namespace>]/[.all]	Lists the areas of the player using the command or the areas of the specified namespace (-n) or all areas (-a).
/area delete <area name>	-n <namespace>	craftbook.mech.area.delete[.self]/[.<namespace>[.all]]	Deletes the specified area or all areas (-a) in the specified namespace (-n).

Troubleshooting

Chests, Signs, etc won't save items/text!

That is caused by having a version of WorldEdit installed, that doesn't match the version of bukkit you use. Please update WorldEdit and Bukkit. This can also be caused by having use-schematics turned off in the config, make sure it is set to true.

Permissions

See Permission Nodes.