Towny

Towny is a server plugin used on the server to protect claims, create nations, and wage war.

## Joining a Town

To join a town, you can ask Mayors of a town to invite you by doing **"/jointown"**. You can also ask in chat to join a town.

When a town's mayor invites you, you can do **"/accept <town name>"** to join the town.

## Towns

Towns are at the center of this plugin and play a key role on the server. Players join Towns, where you can build your settlement alone or with others. Towns can then join a nation for protection or involve itself with server politics, however Towns can also act independently and form their own nation. Towns are protected from griefing except for times of War.

You can manage your town by doing **"/tm"** or "**/tmenu"**.

### Making a Town

Players can make a town by doing the command **"/t new <name>"**. In order to claim, the player needs to reach a specific sum of money to make the town in order to assure that player who is settling is sure about their decision. The chunk the player is standing in will form a claim. You do not need to pay for upkeep but keep in mind that inactive towns may be deleted by Admins.

### Expanding your Town

The first thing you need to do is **"/t deposit <amount>"**. After depositing money into your bank, you can claim more chunks. To claim, go into a chunk and do **"/t claim"**. Do "f3 + g" with your keys in order to see chunks better or do "/towny map".

Pro Tip: You can do **"/tm"** for a handy GUI to modify town settings!

### Protecting Your Town from Town Residents

Although griefing is not allowed, some troublesome players tend to grief regardless. By default, town chunks are public to all residents inside of your town. You can protect your town from people inside of your town by making chunks you want to protect private. You can either claim chunks you want to protect for yourself or sell the chunks to other town residents to own.

* "/plot forsale <amount>" - Sells the plot for a given amount. Can be $0
* "/plot claim" - Claims the plot you're on if it's for sale. When claimed, it becomes a private plot that only you can build on.
* "/plot trust <add/remove> <player name>" - Gives other players permission to build in your private plots

### Managing your Private Plots

You can change different properties of your town using the **"/tm"** command and going to the Plot Management Section (Wooden Shovel).

You can set permissions for other people, toggle plot settings (such as PVP), and who is trusted on your plot from an easy to use GUI.

#### Types of Plots

There are different types of plots with different uses. The type of plot is set by the mayor by doing "/plot set <type>" or through the "/tm" GUI.

* **Default** - The default plot type with no specific features other than the usual plot management.
* **Shop** - Plots useful for chest shops. A tax can be set for those who use these plots for shops. Mayors can do "/town set shopplot" to set the default purchasing price of all shop plots.
* **Arena** - PVP is on all the time here
* **Embassy** - 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.
* **Wild** - A Tplot allows residents to destroy the blocks as if it were in the wild. This includes ores, trees, flowers, mushrooms and other harvestable blocks by default. It does not include stone, dirt, grass and other terrain blocks. It is useful for creating public tree farms.
* **Inn** - Allows anyone to use a bed to set their '/res spawn' and spawn on death. The Inn plot will still deny a player who is in a nation declared as an enemy by your nation.
* **Jail** - A place to store people who were jailed. Jailing players only work if there is a jail. If a player escapes a jail chunk, they are immediately freed.

#### Town Jail

Town Jails are set by Mayors and Co-Mayors. Jails can either hold outlaws or town residents.

* **"/plot set jail"** - Sets the plot you're in to a jail plot. *It will automatically set where you're standing in as a jail cell.*
* **"/plot jailcell add"** - Adds a jail cell inside of a Jail Plot type where you're standing. Jailed players will teleport to where you're standing when you do this command.
* **" /t ban add (player name)"** - Declares a player an outlaw. When outlaws die inside of the town claim, they go to the town's jail.
* **"/t jail"** - Shows all the commands needed to jail town residents.

### Protecting your Town from Outsiders

There are two main ways to protect your town: neutrality or joining a nation.

A town can declare neutrality by doing **"/t toggle neutral"**. When Neutral, your town is unable to declare war but other towns are also unable to declare war on you as well.

You can also join a nation who is willing to protect your town. Remember that this is a little risky because if the nation goes to war, you will be at war as well.

You can also declare a specific outsider an outlaw by doing **"/t ban <player name>"**. When an outlaw is killed in the town, the player will go to the town's jail.

### Joining a Nation

You can either create a nation by doing **"/n new <name>"** with the required sum of money or being invited by another nation.

### Town Roles

There are a few town roles that players can have.

* Mayor - Has full permissions in the town
* Co-Mayor - Can invite other players and manage town chunks as well. Can jail players.
* Sheriff - Can jail members in the town (**"/town toggle jail <player>"**)
* Builder - Bypass private claims (be careful who you hand this out to!!!)

You can change a player's role in "/tm" > Town Settings > Resident Overview

### Town Titles and Surnames

By doing into "/tm" > Town Settings > Resident Overview > (Target Resident) you can set titles and surnames for people in your town. This is a neat way to give players a touch of roleplay naming and titles. However, this will not affect your prefix in chat.

## Nations

Nations are the most common way of protecting a group of towns from aggressors by working together. Nations also give a few bonus chunks.

### Making a Nation

Players can do **"/n new <name>"** to make a nation. The town requires at least a population of 3 players.

### Inviting Players to a Nation

A nation member can do "/n invite <town>" to invite another town into your nation.

### Allies

Your nation can form an alliance with another nation to mutually protect each other in wars and offer special town/plot perms customized by each town's mayors.

**Enemies**

When two nations hate each other very much, they become enemies. Enemies can go to war with each other.