Plot Perms

There are 4 permission-type values, which can be set for personal plots and for town plots as well (town permissions can be set by the mayor and affect plots who are not owned by any player.) The basic command for this is either /resident set perm or /town set perm followed by the proper flags for each permission.

Players can see the server's switch blocks by using the towny switches command.

Players can see the server's item_use items by using the towny itemuse command.

An admin player can test permissions, or otherwise act as a normal player by using /res toggle adminbypass. The same command is run to remove the adminbypass mode. While in adminbypass mode the player will not be able to act as an admin in plots (as well as other places in Towny.)

Perm-Types

The 4 permission-types available are Build, Destroy, Switch and Itemuse.

• Build allows players to add blocks in your town/plot.
• Destroy allows players to remove blocks in your town/plot, or in some cases alter the states of existing blocks (think changing redstone repeater settings.)
• Switch covers the use of:
  • CHEST,
  • SHULKER_BOXES,
  • TRAPPED_CHEST,
  • FURNACE,
  • BLAST_FURNACE,
  • DISPENSER,
  • HOPPER,
  • DROPPER,
  • JUKEBOX,
  • STONECUTTER,
  • SMITHING_TABLE,
  • FLETCHING_TABLE,
  • SMOKER,
  • LOOM,
  • GRINDSTONE,
  • COMPOSTER,
  • CARTOGRAPHY_TABLE,
  • BELL,
  • BARREL,
  • BREWING_STAND,
  • LEVER,
  • PRESSURE_PLATES,
  • BUTTONS,
  • WOOD_DOORS,
  • FENCE_GATES,
  • TRAPDOORS,
  • MINECARTS,
  • LODESTONE,
  • RESPAWN_ANCHOR,
  • TARGET
  • .... or any other type of block which is clicked on.
• Itemuse covers the use of:
  • MINECARTS,
  • BOATS,
  • ENDER_PEARL,
  • FIREBALL,
  • CHORUS_FRUIT,
  • LEAD
  • .... or any other type of item which is used in some manner.
• ItemUse and Switch lists have the follow pre-configured catch-all groups you can add to them: BOATS,MINECARTS,WOOD_DOORS,PRESSURE_PLATES,FENCE_GATES,TRAPDOORS,SHULKER_BOXES,BUTTONS.
• Note: Vehicles like MINECARTS and BOATS can be added to the switch_ids. If you want to treat other rideable mobs like switches add SADDLE to protect HORSES, DONKEYS, MULES, PIGS, STRIDERS (This is not recommended, unless you want players to not be able to re-mount their animals in towns they cannot switch in.)

Perm-Groups

Here's a video for more information!

Each permission-type has 4 perm-groups to which the pemissions can be set for.

The four perm-groups are:

• Friend/Resident
• Town/Nation
• Ally
• Outsider

These are displayed on your /resident perm line as FTAO and stand for Friend, Town, Ally, Outsider. For residents the Friend group consists of a player's friend list and Town consists of townmembers.

For towns, the perm line reads RNAO, with R representing Residents (players in that town) and Nation representing residents of towns in your nation.

Mayors need to use /t set perm resident blah on/off instead of /t set perm friend blah on/off.

The other groups are:

• Ally
  • On personally-owned plots allies consist of players in your nation and players in your nation's allies.
  • On town-owed plots it is players in your nation's allies.
• Outsiders
  • Players who are not part of your town or nation or nation's allies.

All commands are found on the Wiki's Commands page.

Setting perms in-game with commands

Here's a video for more information!

Setting perms for your town's public land or your personal plots is easy! There are two distinct levels of protection provided by towns. First are the town blocks, protected because they are part of a town and not owned by anyone. When you enter one of these plots from the wilderness or an owned plot the notification will show "~ Unowned". Mayors are able to set the permission for unowned plots using the the `/town set perm` command. A full list of commands is available on the commands page, here are some examples:

• /town set perm {on/off} - This turns on or off all permissions for all perm-types and all perm-groups.
• /town set perm ally {on/off} - This turns on or off all perm-types and for the town's allies (Nations to which their nation is allied with.)
• /town set perm resident build {on/off} - This turns on or off all permissions for building done by residents of the town.

Second are the town blocks owned personally by a resident of a town. A resident is able to set the permission for unowned plots using the the /resident set perm command. A full list of commands is on the commands page, here are some examples:

• /resident set perm {on/off} - This turns on or off all permissions for all perm-types and all perm-groups.
• /resident set perm friend {on/off} - This turns on or off all permissions for the resident's friend list.
• /resident set perm ally {on/off} - This turns on or off all permissions for all perm-types to the resident's ally list. This consists of the nation's fellow towns and their nation's allied nations.
• /resident set perm outsider switch {on/off} - This turns on or off permissions for switch use by outsiders.

Lastly, don't forget those are just the defaults for plots, any owned plot can be set with it's own individual perms:

• /plot set perm {on/of} - This turns on or off all permissions for all perm-types and all perm-groups on the plot which is being stood in.
• /plot set perm friend {on/off} - This turns on or off all permissions for the resident's friend list on the plot which is being stood in.
• /plot set perm ally {on/off} - This turns on or off all permissions for all perm-types to the resident's ally list. This consists of the nation's fellow towns and their nation's allied nations. This affects the plot which is being stood in.
• /plot set perm outsider switch {on/off} - This turns on or off permissions for switch use by outsiders on the plot which is being stood in.

Mayors can changed the protection of their town with the following commands:

• /town toggle explosion
• /town toggle fire
• /town toggle pvp
• /town toggle mobs

Mayors and Residents can change each of their plots individually using these commands:

• /plot toggle explosion
• /plot toggle fire
• /plot toggle pvp
• /plot toggle mobs

Explosion and fire toggles are overridden by a mayor's town toggles. The preceding commands by themselves will change the perm line seen from /town or /res. They will also change any plots that were using the previously-set default perm line (town-owned or player-owned plots.) They will not change plots which were not set to the default perm line see in /town or /res. In order to change all plots a mayor or resident must use the following command, which will propagate the current perm line seen in /town or /res to ALL plots owned by the town or resident.

• /res set perm reset - Propagates the perm line in /res to ALL plots owned by that resident.
• /town set perm reset - Propagates the perm line in /town to ALL town-owned plots owned by that town.
• These commands also affect the /town toggle and /plot toggle settings.

Setting trusted lists and plot perm overrides

There are Trusted lists for plots and towns, and plot's can have very fine-grained overrides set up. These features allow players to let other players work in towns and plots while not having to be restricted by the Friend/Resident/Town/Nation/Ally/Outsider plotgroups.

Towns may add a player as a trusted person in their town using /town trust add {name}, and remove them from the trusted list using /town trust remove {name}. Trusted players are treated similar to the mayor in all of the town's plots, able to do any build/destroy/switch/itemuse action.

A player may add or remove another player as trusted in their plots using /plot trust add|remove {name}. While a player is trusted in a plot, they have the same plot permissions as the plot owner, able to do any build/destroy/switch/itemuse action.

Plot perm overrides lets a player make very specific changes to how specific players are able to use plots. To begin a player is added or removed from a plot's perm overrides using /plot perm add|remove {name}. After a player is on this list, the plot owner can use /plot perm gui to open a GUI showing an inventory of player heads (the players who've been added to the plot perm override with /plot perm add {name}.) When a head is clicked on, a new inventory will display the options for Build/Destroy/Switch/ItemUse and a clickable book which explains how the rest of the system works. Players on the perm overrides list will have specific build/destroy/switch/itemuse permissions in the plot, overriding any other plot perm settings.

There is the ability to use /t trusttown add {townname}, which would make an entire Town's residentslist "trusted" by your town. This means that anyone in the 2nd town can do any build/destroy/switch/itemuse as if they were a mayor in the first town. Obviously this should only be given out under very limited circumstances, anyone added to the 2nd town after trust is given will also have full plot perm rights in the first town. There is a confirmation warning the player that uses the /t trusttown add command.