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.

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.

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.

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 Gold (G). See the Economy page for exchange rates between Gold Nuggets, Gold Ingots, and Gold Blocks.

Costs at a Glance

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 Gold balance is paid out to the mayor or king.

Death Penalties

There is no 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.

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

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: home, spawn, teleport, tp, tpa, tpahere, back, dback, ptp, jump, kill, warp, suicide

ASCII Map

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

Symbol	Meaning
H	Homeblock
O	Outpost
$	Plot for sale
-	Wilderness (unclaimed)

Commands

Common Player Commands

Command	Description
/res	View your resident info
/town	View your town info
/town new [name]	Found a new town
/town join [name]	Join an open town
/town claim	Claim the townblock you are standing in
/town unclaim	Unclaim the townblock you are standing in
/town spawn	Teleport to your town spawn
/town deposit [amount]	Deposit Gold into the town bank
/town withdraw [amount]	Withdraw Gold from the town bank
/nation	View your nation info
/nation new [name]	Found a new nation
/nation spawn	Teleport to your nation spawn
/towny map	View the ASCII map around you

See Also

• Economy
• Official Towny Wiki