Editing Towny

{{DISPLAYTITLE:Towny}}
'''Towny''' is the land claiming and town management plugin used on DiplomacyCraft. It allows players to found towns, claim land, form nations, manage taxes, and protect their builds from outsiders. This page documents how Towny is configured on this server.

__TOC__

== Overview ==

Towny divides the world into a grid of '''townblocks''' — each one a 16×16 column of land stretching the full height of the world. Players can band together to found towns, claim townblocks, and build protected communities. Towns can confederate into nations, and nations can ally or declare war on one another.

== Towns ==

=== Founding a Town ===

Creating a new town costs '''576G'''. New towns receive a bonus of '''24 townblocks''' at creation on top of whatever their resident count provides.

New towns are created with the following defaults:
* '''Public:''' No (players cannot /t spawn without permission)
* '''Open:''' No (players must be invited to join)
* '''Neutral:''' No
* '''War allowed:''' Yes
* '''PVP:''' Enabled
* '''Fire spread:''' Disabled
* '''Explosions:''' Disabled
* '''Mobs in town:''' Disabled

=== Townblocks & Claiming ===

A town's maximum number of claimable townblocks is determined by its resident count multiplied by a ratio of '''12'''. As an example, a town with 10 residents can claim up to 120 townblocks (plus any bonus blocks).

Each townblock costs '''36G''' to claim. Unclaiming a townblock provides '''no refund'''.

Towns must maintain a buffer of at least '''4 townblocks''' away from another town's nearest claim, and at least '''8 townblocks''' away from another town's homeblock. Outposts are disabled on this server.

=== Town Levels ===

As a town grows its resident count, it advances through levels that grant a title prefix to the town's name and its mayor. Town level is determined by '''resident count'''.

{| class="wikitable"
|-
! Residents !! Town Prefix !! Mayor Title !! Max Townblocks
|-
| 0 (unclaimed area) || Rural area of || — || 1
|-
| 1+ || Regional area of || Councillor || 16
|-
| 4+ || Regional village of || Councillor || 32
|-
| 8+ || Shire of || Mayor || 96
|-
| 12+ || Village of || Mayor || 192
|-
| 16+ || Town of || Lord Mayor || 288
|-
| 20+ || City of || Lord Mayor || 384
|-
| 24+ || Grand City of || Grand Mayor || 480
|-
| 28+ || Metropolis of || Grand Mayor || 480
|}

The town prefix and mayor title are displayed automatically based on the town's current resident count.

=== Taxes ===

Towns start with a default tax of '''0%''' (percentage-based). Mayors can configure taxes up to a maximum of '''25%''' or a flat cap of '''1,000G'''. Plot tax, shop tax, and embassy tax all default to 0. See [[Economy]] for details on how Gold works.

Daily taxes are collected once per day at '''12:00''' server time (noon). Towns with 0 claimed townblocks are automatically deleted at the next daily cycle.

=== Residents ===

Players who have not logged in for '''60 days''' will have their resident data deleted, including their economy account. If a deleted player was a mayor, mayoral succession rules apply.

=== Upkeep ===

Town upkeep is currently set to '''0G''' — towns do not pay a daily server charge to remain active.

== Nations ==

=== Founding a Nation ===

Creating a nation costs '''5,184G'''.

To join a nation, a town's homeblock must be within '''128 townblocks''' of the nation capital's homeblock, or within '''64 townblocks''' of another town already in the nation.

=== Nation Levels ===

Nations advance through levels based on their total resident count across all member towns.

{| class="wikitable"
|-
! Residents !! Nation Prefix !! Leader Title !! Bonus Town Townblocks !! Nation Zone Size
|-
| 0+ || Land of || — || +10 || 1
|-
| 10+ || Federation of || Count || +20 || 1
|-
| 20+ || Dominion of || Duke || +40 || 1
|-
| 30+ || Kingdom of || King || +60 || 2
|-
| 40+ || The … Empire || Emperor || +100 || 2
|-
| 60+ || The … Realm || God Emperor || +140 || 3
|}

''Bonus Town Townblocks'' is additional claiming space granted to each town in the nation on top of their resident-based limit.

=== Nation Upkeep ===

Nation upkeep is currently set to '''0G''' — nations do not pay a daily server charge to remain active.

=== Proximity Rules ===

A town must be within '''128 townblocks''' of its nation's capital to remain in the nation. If out of range of the capital, it may still qualify if it is within '''64 townblocks''' of another nation member town.

== Economy ==

All costs on this page are denominated in [[Economy|Gold (G)]]. See the [[Economy]] page for exchange rates between Gold Nuggets, Gold Ingots, and Gold Blocks.

=== Costs at a Glance ===

{| class="wikitable"
|-
! Action !! Cost
|-
| Found a town || 576G
|-
| Found a nation || 5,184G
|-
| Claim a townblock || 36G
|-
| Purchase bonus townblock || 144G
|-
| Reclaim a ruined town || 288G
|}

=== Town & Nation Banks ===

Both towns and nations have bank accounts with no hard cap by default. Mayors can deposit and withdraw freely. If a town or nation is deleted, the remaining [[Economy|Gold]] balance is paid out to the mayor or king.

=== Death Penalties ===

There is no [[Economy|Gold]] penalty on death.

== Plot Types ==

Towns can designate townblocks as different plot types. Each type is shown on the ASCII map with a different character.

{| class="wikitable"
|-
! Type !! Map Key !! Notes
|-
| Default || <code>+</code> || Standard residential/general land
|-
| Shop || <code>C</code> || Commerce plots
|-
| Arena || <code>A</code> || PVP is always enabled here
|-
| Embassy || <code>E</code> || Allows outsiders to own land in another town
|-
| Wilds || <code>W</code> || Only natural blocks (ores, wood, plants) can be broken/placed
|-
| Inn || <code>I</code> || Visitors can sleep here
|-
| Jail || <code>J</code> || Used to detain players
|-
| Farm || <code>F</code> || Restricted to crops, plants, and animals
|-
| Bank || <code>B</code> || Bank plot type
|}

== Permissions ==

=== Default Town Permissions ===

When a town is created, the following build/destroy/item-use/switch permissions apply to outsiders by default:

{| class="wikitable"
|-
! Group !! Build !! Destroy !! Item Use !! Switch
|-
| Residents || ✓ || ✓ || ✓ || ✓
|-
| Nation members || ✗ || ✗ || ✗ || ✗
|-
| Allies || ✗ || ✗ || ✗ || ✗
|-
| Outsiders || ✗ || ✗ || ✗ || ✗
|}

=== Wilderness ===

Outside of town claims, all players can freely build, destroy, use items, and interact with switches. Wilderness explosion damage from creepers, TNT, and similar entities is automatically reverted.

== Spawning ==

* '''/t spawn''' is available to town members. Spawning to other public towns is permitted with a 30-second cooldown.
* '''/n spawn''' is available to nation members and can be used to teleport to allied nations.
* Nation spawn must be set within the capital city.
* Respawn protection lasts '''10 seconds''' after death.

== Jail ==

Towns with a jail plot can detain players. Jailing of enemies killed in PVP and jailing of outlaws are both currently '''disabled''' on this server. The maximum jail sentence a mayor can set is '''5 hours'''. Players are given a jail book explaining their options upon being jailed.

Jailed players cannot use: <code>home, spawn, teleport, tp, tpa, tpahere, back, dback, ptp, jump, kill, warp, suicide</code>

== ASCII Map ==

Use <code>/towny map</code> in-game to view a 27×7 ASCII grid of the area around you. The following symbols are used:

{| class="wikitable"
|-
! Symbol !! Meaning
|-
| <code>H</code> || Homeblock
|-
| <code>O</code> || Outpost
|-
| <code>$</code> || Plot for sale
|-
| <code>-</code> || Wilderness (unclaimed)
|}

== Commands ==

=== Common Player Commands ===

{| class="wikitable"
|-
! Command !! Description
|-
| <code>/res</code> || View your resident info
|-
| <code>/town</code> || View your town info
|-
| <code>/town new [name]</code> || Found a new town
|-
| <code>/town join [name]</code> || Join an open town
|-
| <code>/town claim</code> || Claim the townblock you are standing in
|-
| <code>/town unclaim</code> || Unclaim the townblock you are standing in
|-
| <code>/town spawn</code> || Teleport to your town spawn
|-
| <code>/town deposit [amount]</code> || Deposit [[Economy|Gold]] into the town bank
|-
| <code>/town withdraw [amount]</code> || Withdraw [[Economy|Gold]] from the town bank
|-
| <code>/nation</code> || View your nation info
|-
| <code>/nation new [name]</code> || Found a new nation
|-
| <code>/nation spawn</code> || Teleport to your nation spawn
|-
| <code>/towny map</code> || View the ASCII map around you
|}

== See Also ==

* [[Economy]]
* [https://github.com/TownyAdvanced/Towny/wiki Official Towny Wiki]

[[Category:Mechanics]]