> For the complete documentation index, see [llms.txt](https://solana-craft.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://solana-craft.gitbook.io/wiki/towny/getting-started/additional-info/plot-system.md).

# Plot system

## Town Blocks

Block protection is broken down into plots of land, called townblocks, which by default are 16x16.

Think of them as cells on a uniform grid, all aligned and with no space in between each other, every one the same size.

Townblocks are claimed by town mayors who can then sell/give individual plots to their town's residents.

## Claiming Townblocks

Towns' residents can claim townblocks for the town as long as they have the right permission nodes. By default this is restricted to Mayors and people with the Assistant rank.

The player uses `/town claim` or `/town claim #` or `/town claim rect|circle #|auto` or `/town claim auto` to claim townblocks for their town.

## **Personal (Player) Claiming**

When a townblock has been claimed by a town using `/town claim` the mayor can put the townblock/plot up for sale using `/plot fs {optional cost}`. After a plot is put up for sale, a town resident can claim the land personally using `/plot claim`. Likewise, plots are unclaimed by residents by using `/plot unclaim`.

## Cede-ing Land

Players can voluntarily give up land to other towns.

This is done using the `/town cede plot [townname]` command.

In order to a town to be able to cede land, the town inheriting the plot must be able to claim the land if it were unclaimed and available to use `/t claim.`

This means that the inheriting town must have the available townblock to claim, must have an adjacent claim and must also obey all proximity rules.

When the `/t cede plot [townname]` command is used the player using the command must confirm their command, and the receiving mayor must also be online to confirm recieving the plot.

## Buying Townblocks

to be written...

## Plot Groups

Plots can be grouped together into *plot groups*. This allows plots to be sold/bought and manipulated as if it were one Plot. To create a group a player must have the proper permissions to operate on it. The player then stands in the plot and executes: `/plot group add {group_name}`, Towny will add the plot you're standing in, into a group if it exists, or create a new one if a group with that name doesn't exist. Simply repeat the command `/plot group add {same_group_as_above}` while standing in other plots to add those plots to the group.

Most of the other commands used to manipulate plots are the same with one exception, instead of starting with the prefix `/plot`, plot group operations start with the `/plot group` prefix. For example to set a property for sale you do `/plot fs 10000`, but for a plot group named highlands you would do `/plot group fs 10000`. Perms, types and others follow this convention. See `/plot group ?` for full command list.

As of Towny 0.99.6.0 it is now possible to add plots to a plotgroup by walking into them with a new resident mode: `plotgroup`. When a player has a plotgroupname set in memory any plot they want into will automatically join the plot group. The plotgroupname is set into memory when a player uses the `/plot group add NAME` command. In this way, a player can use `/plot group add NAME` to begin a plot group, and then use `/res toggle plotgroup` to turn on the resident mode, then begin adding plots to the plot group by walking around, using `/res toggle plotgroup` when they are finished.

## Districts

Plots can be grouped together into *districts*. Districts are similar to Plot Groups but come with less restrictions: Districts' townblocks are not required to have the same plot permissions, plot type, owner or plot name.

Districts are handy for naming sections of a town, or creating neighbourhoods.

Districts show their name in the chunk notifications, map hud, and in the `/towny map` hover text.

Townblocks in a district are required to be adjacent to each other.<br>

\
Plot Types

Players can use `/town plots {townname}` to view the counts of various plot types in a town.

This is to give mayors more control over their towns.

A plot's cost to create (using the `/plot set {plottype}` command.

Default Plots

These plots do not need any specific command to be designated. They are put up for sale with `/plot forsale {$$}`. A plot which is not of default type can be reset to a default plot with `/plot set reset`.

Shop Plots

Shop plots are designated with `/plot set shop`. A mayor can use `/town set shopprice {$$}` to set how much shop plots are sold at by default. This can be overridden when a mayor puts the actual plot up for sale with `/plot forsale {$$}`. A mayor can also charge an additional shoptax with `/town set shoptax {$$}`. This tax is charged in addition to the normal plottax.

Arena Plots

Arena plots are designated with `/plot set arena.` PVP is on all the time in arena plots as well as friendly-fire damage. Town health regen is also disabled in arena plots.

Embassy Plots

Embassy plots are designated with `/plot set embassy`. A mayor can use `/town set embassyprice {$$}` to set how much embassy plots are sold at by default. This can be overriden when a mayor puts the actual plot up for sale with `/plot forsale {$$}`. A mayor can also charge an additional embassytax with `/town set embassytax {$$}`. This tax is charged in addition to the normal plottax. An embassy plot can be bought by any player, whether they are in a town or not

\
The townblock remains owned by the host-town and a mayor from the host-town can take the plot from the owner at any time. Embassy plots can also be changed into shop plots, allowing for larger shop towns, where many different towns' players can set up shops. When a player leaves a town they do not lose ownership of their plots if those plots are set to be Embassy plots.

#### Inn Plots

Inn plots are designated with `/plot set inn`. Inns are most useful when the `deny_bed_use` setting is true in the [config.yml](https://github.com/TownyAdvanced/Towny/wiki/Default-Config.yml). This setting makes it so that players cannot use beds in plots they do not personally own, *except* when that plot is an Inn plot.

Inn plot allows anyone to use a bed to set their `/res spawn` and spawn on death locations. However, Inn plots cannot be used by enemies of your nation.

#### Jail Plots

Jail plots are designated with `/plot set jail`.

Players can become jailed if:

* The player's mayor/sheriffs send them to jail using one of the following commands:
  * **When Bail is Disabled:**
  * `/town jail [name]` - Jails the given player for 1 hour, must be a resident of your own town.
  * `/town jail [name] {hours}` - Jails the given player for the given hours.
  * `/town jail [name] {hours} {jail}` - Jails the given player for the given hours, in the given jail plot (which is a number.)
  * `/town jail [name] {hours} {jail} {cell}` - Jails the given player for the given hours, in the given jail plot and jail cell (which are both numbers.)
  * **When Bail is Enabled:**
  * `/town jail [name]` - Jails the given player for 1 hour, must be a resident of your own town, with the default bail amount.
  * `/town jail [name] {hours}` - Jails the given player for the given hours, with the default bail amount.
  * `/town jail [name] {hours} {bail}` - Jails the given player for the given hours, with the given bail amount.
  * `/town jail [name] {hours} {bail} {jail}` - Jails the given player for the given hours, with the given bail amount, in the given jail plot (which is a number.)
  * `/town jail [name] {hours} {bail} {jail} {cell}` - Jails the given player for the given hours, with the given bail amount, in the given jail plot and jail cell (which are both numbers.)
* An attacker who attacks a town which considers him an Enemy (Nation-relationship) dies in that Town. He is sent to the defending town's primaryjail.
* An attacker who attacks a town which considers him an Outlaw dies in that Town by a player with Sheriff rank he is sent to the defending town's primary jail.&#x20;

Also:

* Optionally in the config: newly-jailed players who log out before they can be teleported to their cell will be killed.
  * The player is warned to prevent surprises.

Jail plots can have multiple jail cells in them. Jail cells are made using `/plot jailcell add` and removed using `/plot jailcell remove`. Jail cells' spawn locations are marked ingame using a ring of particles.

A town can see a list of their jails using `/town jail list`. A town sets their primaryjail using `/town set primaryjail` while standing in a jail plot. Their first jail will automatically become the primaryjail.

The Bail System

Players can pay money in order to get released from jail.&#x20;

Cost:

Resident Bail Amount:

Resident Max Bail:

President Bail Amount:

Mayor Max Bail Amount:

#### Farm Plots

Farm plots are designated with `/plot set farm`.

### Outposts

Normally townblocks are claimed around the home block, always connected to the town's other townblocks. To claim a townblock out in the wilderness or in another world, a mayor or assistant must claim an outpost.

The outpost list can be viewed by using `/town outpost list` command. The spawn point inside of an outpost townblock can be moved using the `/plot set outpost spawn` or `/t set outpost` command.

The residents of the Town can teleport to outposts to using `/town outpost x|name`

### Buying and Selling Land

Land is sold by Mayors to Residents that are a part of their town.

Mayors have a command used in game to set the cost of all the plots that are set for sale hence-forth.

> * `/town set plotprice {$}`
>   * This sets the cost of newly-set-for-sale plots, already set-for-sale plots keep their costs.
>   * If it is not set, the plots will cost $0 by default.

To put a plot up for sale a mayor, while standing in the plot, type `/plot forsale {optional cost}`. The resident would then type `/plot claim` (while standing in the plot,) to buy it.

Mayors can specify a date range that the resident must be a member of the town for, in order to claim the land. This is done using two commands: `/t plot set minjoindays {#}` and `/plot set maxjoindays {#}`.

When these commands are used, this means that residents cannot use `/plot claim` on the plot that is for sale, unless they have been a resident for a long or short enough amount of time.&#x20;

Embassy plots are not affected by the min and max join days, unless it is being claimed by a town resident. In order to remove the requirements, mayors can use the word `clear` in place of the `{#}`

Plot Regeneration & Unclaimed Plots

#### Reverting unclaimed townblocks to their original state on unclaim

When a town plot is unclaimed (by a player using `/t unclaim` or through upkeep) it will slowly begin to revert to a pre-town state. Blocks will slowly change back to a snapshot taken of the plot when it was first claimed. A townblock must revert completely before the snapshot of the townblock is removed. If townblock is reclaimed mid-revert, a new snapshot is not taken and if the townblock is unclaimed again it will revert to the original snapshot.

## Using Maps

The map in towny displays the grid system of plots. The map can be viewed once using `/towny map` one time or you can set the map to show every time you move from one block to another:

> * Use `/resident toggle map` to turn it on or off.

A larger version of the map can be seen using `/towny map big`.

A hud version of the map can be seen using `/towny map hud`.

#### Wilderness Regeneration

This feature regenerates explosions made by entities every 60 seconds, such as:

* TNT
* Creepers
* Wither explosions
* Ender Dragons
* End Crystal
* Fire Ball
* TNT Minecraft
