Town

### TOWN BASICS

The name for the land protection used by the server. Towns are run by mayors who invite others into their town. each member adds 12 plots to a town. each town mayor can claim more land with those plots and sell however many is needed to the new player for whatever price the mayor believes is fair. Plots can have many properties, from shops, inns, and even embassies!

Embassy; allows members from another town, either in your nation or not to own the flagged plot. 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.

shop; allows mayors to sell semi ownership of a plot, recommended near the town spawn for players wishing to make chestshops.

Inn; limited use in our current server setup, 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.

Farm; Farm plots are designated with `/plot set farm`. A Farm plot players to only build/destroy crops

Jail; please see Jails

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 `/t set outpost` command.

All town mayors may request a page, requirements below. All towns that qualify will have a page linked in the list of towns page.

* must have at least 3 members
* must be a town for at least 2 weeks
* must have at least 24 claimed plots

## Starting a Town

Mayors start towns using the command `/town new {townname}`. this costs $25k, and is one time, additional plots are $250.

The townblock they are standing in will be the home block for the town, the exact spot/position will be the spawn point for the town. A mayor can move the spawn point within the homeblock using `/t set spawn`. The homeblock can be moved to another claimed townblock using `/t set homeblock`.

More townblocks can be claimed using `/town claim`. These townblocks need to be directly adjacent to already claimed townblocks, unless it is an outpost.

## Joining Towns

There are two ways to join towns, the first is by being invited by a Mayor or a Town assistant. The second is by joining an open town.

Mayors and assistants can add players to their town with the command `/town add {playername}`. The player will receive a prompt to either `/accept` or `/deny` the invitation.

Mayors can set their towns to open using `/town toggle open`. A player who isn't in a town already can use the command `/town join {townname}` to join open towns. Open towns can be viewed using the `/town list by open`.

When residents join towns they increase the number of townblocks accessible to the mayor for claiming.

# Plot System of Land Ownership

## Town Blocks

Towny provides a server admin a hands-off approach to block-protection. Block protection is broken down into plots of land, called townblocks, which are 16x16x256 (the full height of the world.) 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.

 `/town claim auto` | Claims all possible townblocks in a square shape centered around the command user.

Using the `/town` command will list how many townblocks are available to be claimed.

As of 0.95.0.0 you may set a refund amount for unclaiming townblocks at `economy.new_expand.price_claim_townblock_refund`, it is not recommended that this be set at or higher than the cost to claim a townblock.

As of 0.95.0.0 you may make the cost of claiming townblocks increase at `economy.new_expand.price_claim_townblock_increase`. When set to 1 this is deactivated. 1.3 means +30% to every bonus claim block cost. Cost increase can be seen in `/towny prices` output.

As of 0.96.3.0 you can set the maximum price that the `economy.new_expand.price_claim_townblock_increase` can reach. This is set at `economy.new_expand.max_price_claim_townblock` in the config.yml.