Introduction to Towny

Towny is a manager for a Resident-Town-Nation hierarchy, as well as a block permission manager for a grid-like protection system. The basis of protection follows under how the world is separated into chunks. For those unaware, minecraft servers are broken up into 16x16x256 sections of blocks. The 256 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 16×16, similar to the chunk size. So claiming a town block (a grid square) allows that section of land to follow your town’s or the plot owner’s permissions.

Towns, Nations and Plots

Each town has a mayor, while a nation has a king. They both have their own assistants to help run their respective people. Towns can claim up to a certain amount of town blocks, a set ratio or amount configured in the setting that is relative to the amount of players taking residence in that town. Residents themselves have no limit on how many they claim, however the daily tax (when using alongside an economy plugin) will take a bite out of their resources. The money is tunneled 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.

The Hierarchy


Nomads are simply players who are not part of any town. Nomads can purchase Embassy plots.


Everyone who joins the server can become a resident. Residents have their own command /resident which used by itself outputs a Resident 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 perm line showing the plot perms given on all plots that resident owns.


A town is a collection of residents (or just one resident) with one resident as the mayor. A town also has a bank which the mayor can withdraw from. A mayor can also have assistants who have the same powers as him/herself. Towns can have taxes that will be taken at the end of each day interval.

Towns usually grow outwards from their home block, the town block the mayor stood in during town creation. Town blocks need to be claimed beside other town blocks, unless the mayor claims an outpost in the wilderness. All of the towns on the server can be seen in a list using /town list.



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. 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.

It is not possible to run two towns.

Mayors have the ability to set titles (prefixes) and surnames (postfixes) to the residents of their town. This is done with:

  • /town set title {name} titlegoeshere
  • /town set surname {name} surnamegoeshere


Mayors and Assistants 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.

A town member can view their town’s outlaw list using /town outlawlist. Anyone can view any town’s outlawlist using /town outlawlist {townname}


A nation is a collection of towns (or just one town) with one town as the capital. The mayor of that capital is the king. 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.

Nations can also have a spawn reached using /nation spawn which if the nation is considered ‘Public’ can be reached by nearly any non-enemy players. The nation spawn is restricted to the capital.

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. Nation alliances are restricted to be 2-way only. So that Nation A cannot consider Nation B an ally unless the Nation B also considers Nation A an ally.

The maximum number of residents per-town if they do not have a nation, is unlimited.

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.


Kings lead Nations and are the mayor of the capital city. Kings can decide which ranks their residents fall into, in their nation. This can also be decided by the Nation Assistant. Kings can see the available ranks using /nation ranklist command. Players are ranked using /nation rank {add|remove} {playername} {rankname}. A player can have more than one rank assigned.

Kings have the ability to set titles (prefixes) and surnames (postfixes) to the residents of the towns they have in their nation. This is done with:

  • /nation set title {name} titlegoeshere
  • /nation set surname {name} surnamegoeshere

Typing the commands with nothing after the player’s name resets the title or surname to blank.


The perms for all town/nation/plots can be found here

This documentation was taken from here and here and was edited.

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes:

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>