Towny

Prismacraft includes a Towny plugin, which is a land management plugin for players to protect their belongings or work together by forming towns. All towns are located in the Towny world since this world is to never be reset.

# Towns

A town can be a collection of residents, or just one resident. To be able to first create a town, a player would need a plot of land at least three chunks separated from another town, and $25,000 in coins (it used to be $40,000) to create a town. You can also join an existing town by being invited to a town by a leader, or mayor.

The creator of the town is known as the mayor, and the mayor is the leader that would be able to perform all administrative commands for the town.

## Towny commands

The following list relates to each of the commands from Towny based on its starting word. All of these commands can be shown through the help page command on the server by using /[word] ?, such as /towny ? or /plot ?.

**Commands under /towny**

 /towny ?
 /towny map
 /towny prices
 /towny time
 /towny universe

**Commands under /plot**

**/plot** - shows the plot commands

**/plot claim** - claims the town block, which is 16x16

**/plot claim auto** - resident can claim an area of plots for sale, around the player who typed the command.

**/plot unclaim** - resident/player can unclaim personally owned plots

**/plot perm** - review the permissions/ownership of the plot, including those trusted on the plot

**/plot {forsale/fs}** - put the plot for auction

**/plot {forsale/fs} within {rect/circle} {radius}** - put up a plot within a circle or rectangular radius for sale

## Plot management

A plot's owner controls who has access to the plot by typing **/plot set perm <group> <permission> [on/off]** while standing inside the plot.

Plot groups:

* **friend:** player on your friends list, edited through /res friend
* **resident**: players in your town
* **ally:** players in your town, nation or allied nations
* **outsider:** players who are not in your town, nation or allied nations.

Permissions:

* **build** - controls whether a group can build in your plot
* **destroy** - controls whether a group can break blocks or fight mobs in your plot
* **switch** - controls whether a group can use job blocks, like chests, furnaces, doors, levers, trapdoors, etc.
* **itemuse** - controls whether a group can place or destroy minecarts, use buckets, bonemeal, boats or lead.

A resident could control these permissions for *all owned plots*, by using **/resident set perm [group] [permission] [on/off]**. Town mayors can control these permissions for all unowned plots by using **/town set perm [group] [permission] [on/off]**

Towns also have ranks within its own members, which can be assigned in the following order of ranking and give the following permission:

* **Builder:** This is the rank with permission to build and destroy anywhere in the town excluding owned plots.
* **Sheriff:** A resident with this rank has the additional permissions to jail people using jail commands.
* **Assistant:** This rank can claim land, invite people to the town, change plot permissions, can "switch" anywhere in the town. This rank cannot withdraw money from the bank.
* **Councelor:** This rank has all permissions including withdrawing money from the bank. It cannot unclaim all land or delete the town.
* **Comayor**: This rank is like a second mayor position. It can delete the town and do all mayor commands, but it cannot leave, start or join a nation.
* **Mayor:** Leader of the town, with all available perms in towny.

## Taxation

Taxes are collected every 24 hours and are automatically removed from the town bank. Towns can choose to tax their members to contribute to the town bank, or any member can contribute through /t deposit [money]. Town ranking members are exempt from taxes.

Town leaders can elect two ways two collect taxes from members if they choose to do this: percentage taxes and flat rate taxes.

* **Flat-rate taxes:** takes a flat rate from the resident's money per day. If a resident can't pay this tax, they will be kicked from the town. This tax rate is set through **/town set taxes [amount/percentage]**

* **Percentage taxes:** takes a percentage of the resident's money per day. If a resident can't pay this tax, they will not be kicked from the town. To switch between the two taxation modes type **/town toggle taxpercent**

Towns can also collect taxes by plots owned, shop plots owned or embassy plots owned. The following commands allow you to set this tax:

* **/town set plottax [amount]** - sets taxes daily for each resident, per plot that they own
* **/town set shoptax [amount]** - sets taxes daily for each resident, per shop plot that they own
* **/town set embassytax [amount]** - set taxes daily for each resident, per embassy plot that they own

## Notes about town upkeep

Every day, a daily upkeep cost, neutrality cost, and taxes are removed from the town bank. It is always important to make sure your town always has money in the bank to pay for these costs. These costs vary depending on the land chunks taken up by the town.

Once a town runs out of money, the town is considered bankrupt. A town is bankrupt for five days before it falls and the items in the town's chests are no longer protected.

Leaders have the responsibility of assigning town ranks or perms to new residents. These give residents permissions to do or not do certain things in the town.

## Nations

Towns can come together to form a nation, which is an entity that multiple towns can be part of. Joining or creating a nation gives towns the benefits of bonus townblocks. Here are some quick facts about nations:

* You can talk with your nation members on /nc

* Nations have their own creation cost and daily upkeep cost. Nation members can contribute to the nation bank by typing /n deposit [money]

* The nation's top leader can elect their ranks within the nation through the following categories: coregent, assistant, helper