Towny General
What is Towny?
Towny is a gamemode where each town has a mayor, while a nation has a king. They both have their own assistants to help run their respective people. Players can also purchase land from the town, as well as an optional daily tax set by the mayor. The player can allow his friends from out of town to build on his land when even his very own town's people can't build if he so wishes.
The basis of protection follows under how the world is separated into chunks. For those unaware, minecraft servers are broken up into 16x384x16 sections of blocks. The 384 being the height from the bedrock floor to the clouds in the sky. The protection ignores the height and focuses on the x and z planes. The default size for grid squares is 16x16, similar to the chunk size. So claiming a townblock (a grid square) allows that section of land to follow your town's or the plot owner's permissions.
Each town can claim up to a certain amount of townblocks, a set ratio or amount that is relative to the amount of players taking residence in that town (See Claiming land for details). Residents themselves have no limit on how many they claim, however the daily tax will take a bite out of their resources. The money is tunnelled to the town's bank account that only the mayor can withdraw from, except if the town belongs to a nation. Any town belonging to a nation may be required to pay the nation a daily upkeep as well.
Towny Wars can occur at specific times of the day (See Towny Wars for details) but can be declared whenever and can last for up to several days (with breaks). During war, most commands are frozen in order to focus on the event. Wars comprise of several stages: Assembly, Battle, Invasion. Neutral Towns/Nations cannot participate in any wars. A Battle Chest is prepared during wartime, which is dependent on the number of claims a defending Town has. The winning Town of the battle acquires the monetary prize, and if the defending Town fails to fend off the invaders during the invasion, the attackers' Nation takes control of the Town and its claims.
Hierarchy
Nomads
Nomads are simply players who are not part of any town.
Residents
Every person who joins your server can become a resident of a town, (by default they are given the towny.town.resident permission node in townyperms.yml's nomad section.) Residents have their own command /resident which used by itself outputs a Resident Status Screen, displaying Money, Town, Plots owned and Friends. Residents can join towns or choose to start a town of their own.
Residents who join towns can claim plots that the Mayor of the town has set for sale. When a resident owns 1 or more plots, they will see a new line on their Resident Screen, showing plots owned and a default perm line showing the plot perms given on all plots that resident owns, (which haven't had a custom plot line set.)
Mayor
Mayors run towns and with the help of their assistants, manage a town and its residents.
Mayors can decide which ranks their residents fall into, in their town. This can be a Town Assistant or any other custom ranks created by the server admin in the townyperms.yml file. Mayors can see the available ranks using /town ranklist command. Players are ranked using /town rank {add|remove} {playername} {rankname}. A player can have more than one rank assigned, allowing admins to create diverse town-roles such as bankers, builders, inviters for the mayor to choose for their trusted residents.
Mayors also determine what sort of tax and tax rates the town will charge the residents.
Outlaws
Towns (typically mayors by default, but possibly other town ranks,) can set a list of Outlaws. Outlaws are set using /town outlaw [add/remove] [name].Outlaws can be any player and do not have to be in a town or nation.
If the newly-minted outlaw is a member of your town they will be kicked. Towns that have themselves set to Open-status (anyone can join using the /town join command,) can use the outlaw list to prevent these players from joining their town freely. Players cannot spawn to public towns which consider them outlaws.
Players that enter into a town where they are considered to be an outlaw will see a warning-title-message informing them. If a player is online and they are made into an Outlaw they will see a message in chat.
Outlaws can be jailed if they die in the town where they are considered to be an outlaw.
A town member can view their town's outlaw list using /town outlawlist. Anyone can view any town's outlawlist using /town outlawlist {townname}
Nations
A nation is a collection of towns (or just one town) with one town as the capital. The mayor of that capital is the nation leader. A nation can join the war event, as well as ally other nations. A nation also has it's own bank. It can also tax the towns that belong to it.
Two nations can decide to join in an alliance, which allows them to be protected from friendly fire, help on each others plots (if the plot's perm line allows allies,) and to help each other in war. Nations can grant many perks to their towns which can increase as the nation population increases, these include:
- Bonus townblocks to be claimed.
- Cheaper town upkeep costs.
- An increased outpost limit.
Starting a Town
Mayors start towns using the command /town new {townname}. Towns and Nations cost $1500 and $8500 to create respectfully.
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. Note, the homeblock will by default also be the Town's bank claim. You will need to be standing in your spawn chunk to be able to perform transactions into your Town's bank.
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.
Claiming Land
Land in Towny, also known as Towny Block, comprise the size of a chunk (16 x 384 x 16), where each Town starts with a maximum 32 Town Blocks. To claim a chunk (town block) type /town claim which will claim the chunk you are currently standing in. Note, performing this action will deduct $150 from your Town bank.
You can increase the number of Towny Blocks that you can claim for your town, either by recruiting more players into your Town, buying more Town blocks /town buy bonus {# of chunks}, or by joining a Nation.
Each claim has to be adjacent to an existing claim corresponding to your Town. You cannot claim other Town/Nation claims. Claims will protect your claimed chunk from malicious actions such as raids/griefers but is still vulnerable to mob griefing, firespread, and other environmental activities. Players not part of your Town/Nation will not be able to break blocks, or steal items out of your chests within a claim, but will still be able to interact with blocks (e.g. buttons, levers, doors, pressure plates, etc.).
Outposts
Town/Nation outposts are claims that do not lie adjacent to an existing Town/Nation claim. Infact, an outpost claim must be a minimum of 5 chunks from your existing Town/Nation claim and is limited by the level of your Town/Nation. A Town must have a minimum of 2 players in order to claim an outpost. Outposts can be claimed by executing /town claim outpost and cost $350.
Towny Economy
When starting a Town, the chunk you are standing in will be automatically claimed for you as your spawn townblock. In this town block, you can deposit your balance into your Town's bank, which can be down with /town deposit {amount}.
Every action that costs a certain amount to perform, will withdraw funds from your Town's bank, not your balance. This is especially the case with your Town's daily upkeep.
Town Upkeep
Every 24 hours, 12:00 PM EST, the server withdraws an amount dependent on the level and status of the Town/Nation from its bank. See table below for a list of upkeep costs:
| Town/Nation | Upkeep Cost ($) |
|---|---|
| Town | 5 |
| Neutral Town | 10 |
| Nation | 25 |
| Neutral Nation | 35 |
If a Town/Nation fails to fulfill the daily upkeep cost, the Town/Nation will become bankrupt. During a bankrupt state a Town/Nation will not be deleted, but rather the Town's bank is now in debt to the server. While in debt, the Town/Nation can no longer expand (claim, recruit, or build). The only way out of a bankruptcy is to pay back all your debt to the server. In addition, a Neutral Town's state is reverted back to a default Town state, thus is susceptible to attack (siege wars).
If the debt amount exceeds $100, the Town/Nation will be deleted.
