Editing Towny (section)

==Town Features==
[[File:TownyMenu.png|thumb|After opening the GUI, you can manage your town, nation, and private plots]]

=== Towny Menu ===
Towny has a lot of commands! Fortunately, you can easily manage your town information by using a handy GUI. 

To access the Towny Menu, you can do the command <code>'''/tmenu'''</code>

===Public Plots===
Until made private, every chunk is considered a '''Public Plot'''. Public Plots are subject to the town's basic plot permissions. By default, any player can build and break blocks in public plots. ''<u>It is highly recommended to make plots private</u>''

=== Private Plots ===
Chunks/Town Plots that are owned by players are called '''Private Plots'''. Only the owner of these plots and players the owner as trusted through <code>/tmenu</code> can use these chunks. Additionally, mayors and co-mayors can override private plots. Permissions are fully controlled by the owner of the plot. 

Here are two commends done to make a plot private:
#'''"/plot forsale <amount>"''' - You must sell the plot for someone to buy. The price can be $0 (free)
#'''"/plot claim"''' - The person who wants to own the plot must stand in the chunk and perform this command. After claiming, it is their private plot
If you want to add players, you can use the <code>/tmenu</code> GUI or do this command:

* '''"/plot trust <add/remove> <player name>"''' - Gives other players permission to build in your private plots

===Managing Private Plots===
You can change different properties of your town using the '''<code>/tmenu</code>''' command and going to the Plot Management Section (Wooden Shovel).

You can set permissions for other people, toggle plot settings, 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 /tmenu 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 wild plot allows all residents to destroy the blocks as if it were in the wild. This includes crops, trees, flowers, mushrooms and other harvestable blocks by default. I It is useful for creating public farms.
*'''Inn''' - Allows anyone to use a bed to set their spawnpoint 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 the town borders, 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. ''<u>It will automatically set where you're standing in as a jail cell.</u>''
*'''"/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. <u>Remember that this is a little risky because if the nation goes to war, you will be at war as well.</u>

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 and can bypass private claims
*Co-Mayor - Can invite other players and manage town chunks as well. Can jail players and bypass private claims.
*Sheriff - Can jail players ('''"/town toggle jail <player>"''')
*Builder - Bypass private claims (be careful who you hand this out to!!!)
You can change a player's role in "/tmenu" > Town Settings > Resident Overview
===Town Titles and Surnames===
By doing into "/tmenu" > 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.