Joining a town

To join a town you can-

Recieve an invite with /t invite [playername]. You can accept incoming invite with /accept [town name]
View publicly open and joinablr towns with /town list by open. You can join one of the listed towns with /t join [town]

Creating a town

First, view how much money you need for a town with /towny prices

Tip: earn money easily wit /vote

Create a the town with /t new [name of your choice]. The cost will be taken from your /balance

Ensure you can afford the daily upkeep of 100$

Upkeep will be withdrawn from your town bank daily. If you have insufficient funds to pay this daily minimum, your town will fall to ruin

Inviting Residents

Members of towns are called its Residents.
To invite a player to be a resident of your town, type /t add <name of player>
- After being invited, they join using /t invite accept <town name>
- Alternatively, they can join using /t invitelist
You can remove residents from your town using /t kick <resident>
Chat with your residents through the /tc chat channel. Return to global chat with /g

Upkeep & Ruins

Towns and Nations are charged upkeep every 24 hours. Upkeep is taken from the town bank
Type /towny time to see the time until upkeep is next charged
Town upkeep is $100 minimum; after your 100th claim chunk, each claim chunk will add an additional $1 to your town's upkeep
- Eg. If you have 350 claim chunks, $1x350 claim chunks, your daily upkeep is $350
Nation upkeep is $1000
If a town cannot afford to pay upkeep, it fall into ruin. Ruined towns can be griefed
- Ruins are marked with a hazard symbol on the map
- Ruins that are not reclaimed (/t reclaim) are eventually deleted

Claiming Land

Claiming land costs money /t prices
The money is taken from your town;s virtual bank
- To deposit money in the town bank, type /t deposit <amount of money> while standing inside your homeblock
To claim, stand inside a wilderness chunk next to one of your town's claims, Then type /t claim
- To see chunk outlines-
  1. f3+g
  2. /chunk view | cv - Places blocks on the chunk border of the chunk you are in without using f3+g
  3. /chunkviewparticle | chunkvp | cvp - Shows the chunk border with particles for a short period of time, without the need for f3+g
- To see a map of nearby claims, type /towny map
Claimed chunks are called plots

Claim Limits

Towns have a claim limit. Every two residents, your town's donus claim chunk limit increases by 50
You spend money to increase your claim limit using /t buy bonus
Joining a nation will also increase your claim limit

Commands and Town Menu

There are many town settings that can be changed. You can control these through commands, or alternatively through-

/tmenu
/nation menu

Listed below, beginning with their prefixes, are the different Towny Advanced commands.

/towny

- Shows basic towny commands.

- ? - Shows more towny commands.
- map - Shows the towny map.
- prices - Shows taxes/costs associated with running a town.
- time - Shows time until next new-day (tax/upkeep collection.)
- top
  - residents {all/town/nation} - Shows top residents.
  - land {all/resident/town} - Shows top land owners.
- spy - Admin command to spy on all chat channels
- tree - Shows lots of stuff.
- universe - Shows full towny stats, resident/town/nation/world counts as well as townblocks claimed.
- v - Shows towny version.
- war
  - stats
  - scores

/plot

- Shows the /plot commands.

- claim - Resident command to personally claims a plot that are for sale.
  - auto - Resident command to personally claim an area of plots that are for sale, around the player typing the command.
- unclaim - Resident command to unclaim personally owned plots.
  - circle/rect - Resident command to unclaim personally owned plots in a circle or rectangle shape.
  - {# (radius around current position)} - Radius of the area to unclaim.
- {forsale/fs} - Set a plot for sale.
  - circle/rect - Set a shape.
  - {# (radius around current position)} - Radius of the area to set forsale.
  - $$ - Cost of plot.
  - circle/rect - Set a shape.
    - {# (radius around current position)} - Radius of the area to set forsale.
- {notforsale/nfs} - Set a plot to not be for sale.
  - circle/rect - Set a shape.
  - {# (radius around current position)} - Radius of the area to set notforsale.
- perm - Shows the perm line of the plot in which the player stands.
- set
  - reset - Sets a shop/embassy/arena/wilds plot back to a normal plot.
  - shop - Sets a plot to a shop plot.
  - embassy - Sets a plot to an embassy plot.
  - arena - Sets a plot to an arena plot.
  - wilds - Sets a plot to a wilds plot.
  - name - allows a mayor or plot-owner to rename plots they own, overwriting the ~Unowned message. Personal-plots display both the plot's given name and the name of the plot-owner.
  - perm
  - {on/off} - Edits the perm line of the single plot in which the player is standing. See here for details.
  - {resident/ally/outsider} {on/off}
  - {build/destroy/switch/itemuse} {on/off}
  - {resident/ally/outsider} {build/destroy/switch/itemuse} {on/off}
  - reset - Resets the plot in which you stand to the default perm line of the /town or /resident screen (depending on if the plot is owned personally or by the town.)
- toggle
  - fire - Turn on/off firespread in the plot in which you stand.
  - pvp - Turn on/off pvp in the plot in which you stand.
  - explosion - Turn on/off explosions in the plot in which you stand.
  - mob - Turn on/off hostile mobspawning in the plot in which you stand.
- clear - Command to remove list of block id's from a plot, used by a mayor on town-owned land, or by a plot-owner on their personal plots.

/resident

- Shows a player their resident screen.

- ? - Shows /res commands available.
- {resident} - Shows a player another player's resident screen.
- friend
  - add {resident} .. {resident} - Resident adds online player to their friends list.
  - add+ {resident} .. {resident} - Resident adds offline player to their friends list.
  - remove {resident} .. {resident} - Resident removes online player from their friends list.
  - remove+ {resident} .. {resident} - Resident removes offline player from their friends list.
  - clearlist - Removes all friends from a resident's friend list.
- list - Lists residents in towny's data folder.
- spawn - If deny_bed_use: true in the config.yml and player has a current bed spawn, command will teleport player to their bed.
- toggle
  - map - Turns on map which refreshes when moving across plot borders.
  - townclaim - Turns on mode where /town claim is automatically used when moving across plot borders.
  - plotborder - Turns on smokey plot-border view. Border shows when players cross to different townblocks.
  - spy - Admins can turn on chat-channel spying.
  - reset - This turns off all modes that are active.
- set
  - perm
  - {on/off} - Edits the perm line on the resident screen. See here for details.
  - {friend/ally/outsider} {on/off}
  - {build/destroy/switch/itemuse} {on/off}
  - {friend/ally/outsider} {build/destroy/switch/itemuse} {on/off}
  - reset - This takes the perm line seen in the /resident screen and applies it to all plots personally owned by the player typing it.
- tax - Shows taxes a player pays.

/town

- Shows a player their town's town screen.

- ? - Shows /town commands available.
- menu - Displays an interactive town management gui.
- {town} - Shows a player another town's town screen.
- here - Shows you the town screen of the town in which you stand.
- leave - Leaves a town.
- list - Lists towns.
- online - Shows players in your town which are online.
- new
  - {townname} - Creates new town.
  - {townname} {mayor} - Admin command to create town.
- add {resident} .. {resident} - Mayor command to add residents to your town.
- kick {resident} .. {resident} - Mayor command to remove residents from your town.
- spawn - Teleports you to your town's spawn.
- spawn {town} - Teleports you to another town's spawn.
- claim - Mayor command to claim the townblock in which you stand for your town.
  - outpost - Claims an outpost for your town.
  - {# (radius around current position)} - Claims an area of townblocks around you for your town.
  - auto - Claims as many townblocks around you as is possible given money in townbank and available townblocks.
- unclaim - Mayor command to unclaim the townblock in which you stand.
  - all - Mayor command to unclaim all townblocks.
  - {# (radius around current position)} - Command to unclaim an area of townblocks around you.
- withdraw {$} - Removes money from town bank.
- deposit {$} - Adds money from player to the town bank.
- buy
  - bonus {amount} - Buys available bonus townblocks.
- delete {town name} - Admin/Mayor command to delete a town from towny's data folder's files.
- outpost
  - {# (where # equals the corresponding outpost's number)} - Teleports to an outpost.
- ranklist - Displays residents and their ranks.
- rank {add|remove} {playername} {rankname} - Grants or removes a rank to a resident of the town.
- reslist - Displays a full list of residents in the town.
- set
  - board {message} - Sets message seen by residents upon logging in.
  - mayor {resident} - Mayor command to give mayor status to another resident.
  - homeblock - Sets the homeblock and spawn of your town.
  - spawn - Sets the town spawn, must be done inside the homeblock.
  - name {name} - Change your town's name.
  - outpost - Sets a townblock as an outpost.
  - perm
  - {on/off} - Edits the perm line on the town screen. See here for details.
  - {resident/ally/outsider} {on/off}
  - {build/destroy/switch/itemuse} {on/off}
  - {resident/ally/outsider} {build/destroy/switch/itemuse} {on/off}
  - reset - This takes the perm line seen in the /town screen and applies it to all plots owned by the town.
  - tag {upto4character} - Sets the town's tag, which is sometimes used on that chat line.
  - clear - Clears the tag set for the town.
  - taxes {$} - Sets taxes collected from each resident daily. Also sets percentage if taxpercent is toggled on.
  - plottax {$} - Set taxes collected from each resident daily, per plot that they own.
  - plotprice {$} - Sets default cost of plot for the town.
  - shopprice {$} - Sets default cost of a shopplot for the town.
  - shoptax {$} - Set taxes collected from each resident daily, per shopplot that they own.
  - embassyprice {$} - Sets default cost of a embassy plot for the town.
  - embassytax {$} - Set taxes collected from each resident daily, per embassy plot that they own.
- toggle
  - explosion - Turn on/off explosions in town.
  - regen - Allow or deny explosions from regenerating in your town.
  - fire - Turn on/off firespread in town.
  - mobs - Turn on/off hostile mobspawning in town.
  - public - Turn on/off public /town spawning and the co-ordinates of the town's homeblock in the /town screen.
  - pvp - Turn on/off pvp in town.
  - taxpercent - Turn on/off taxing by percent/flatrate.
  - open - Turn on/off public joining to your town.
- join {townname} - Command to join a town that doesn't require invites.

/nation

- Shows a player their nation's nation screen.

- ? - Shows /nation commands.
- menu - Displays an interactive town management gui.
- list - Lists nations.
- online - Shows players in your nation which are online.
- {nation} - Shows a player the /nation screen of another nation.
- leave - Mayor command to leave the nation they are a part of.
- withdraw {$} - King command to remove money from the nation bank.
- deposit {$} - King command to add money to the nation bank.
- new
  - {nationname} - Mayor command to create a nation.
  - {nationname} {capitaltown} - Admin command to create a new nation, set capitol.
- rank - Command to set assistant/custom ranks in the nation.
- add {town} .. {town} - Invites/Adds a town to your nation.
- kick {town} .. {town} - Removes a town from your nation.
- delete {nation} - Deletes your nation.
- ally
  - add {nation} .. {nation} - Add a nation to your nation's ally list.
  - remove {nation} .. {nation} - Removes a nation from your nation's ally list.
- enemy
  - add {nation} .. {nation} - Add a nation to your nation's enemy list.
  - remove {nation} .. {nation} - Removes a nation from your nation's enemy list.
- rank {add|remove} {playername} {rankname} - Grants or removes a rank to a resident of the nation.
- set
  - king {resident} - King command to change the king of the nation.
  - captial {town} - Sets the capitol and king of the nation.
  - taxes {$} - Sets nationtax applied to the towns within the nation.
  - name {name} - Sets the nation's name.
  - title {name} {titlegoeshere} - King command to add a Title to a member of the nation.
  - surname {name} {surnamegoeshere} - King command to add a Suffix to a member of the nation.
  - tag {upto4character} - Sets the nation's tag, which is sometimes used on that chat line.
  - clear - Clears the tag set for the nation.
- toggle
  - neutral - Sets whether your nation will pay daily to be neutral during towny war.

Permissions

To change permissions for the whole town, type /t set perm <permission type> <permission group> [on/off].

For example, to let residents build everywhere inside your town, type /t set perm build resident on.

Trusting

If you want someone to have full permissions to your town, you can add them to the town trust list. /town trust
Similarly if you want to give someone full permissions to a plot that you own, add them to the plot trust list. /plot trust
Trust is powerful, so be careful who you give it to. Don't give it to people you don't know well.

Plots

A plot can not have multiple types set at the same time.
Set plot type with the command /plot set <plot type>.

Plot Types

Default: The default plot type. It has no special properties. Useful for personal builds, such as homes.
Shop: Required in order to create player shops.
Arena: Enables PvP inside the plot. This is the only place where residents of the same town can fight each other.
Farm: Allows residents to harvest and replant crops inside the plot, but not place or break any other types of blocks. See /towny allowedblocks for a full list. It also allows residents to breed and kill animals inside the plot.
Embassy: This allows any player to buy the plot, regardless of what town they may belong to. Embassies are used to establish a presence in other parts of the world, just like embassies in real life. Owning an embassy and changing its plot type will still keep you as the owner. For example, this is useful when creating shops in different towns.
Jail: Can host jail cells, which imprisoned residents. See the Jail Guide for more information.
Bank: Required to use town bank commands (/t deposit and /t withdraw).

Outlaws Attackers/Assailants

We strongly recommend you outlaw any and all attackers and assailants.

/t outlaw add {name}

In doing so, assailants will be unable to accept teleportation requests to bring in help, and they will be unable to teleport away when in your claims (preventing them from escaping near-death).
Additionally, once they step into your claims and territories a 15 minute countdown begins, after the 15 minutes they will be teleported out of your town, and its claims/territories, and into the nether; this helps to prevent them from camping inside your claims for more than 25% of Forced PVP.

Town Levels

Town levels are determined by the number of residents in your town. As your town grows, you unlock more privileges, land, and bonuses.

Town Key Progression Points Table:

What changes as you level up?

More Plots: Each level increases your maximum town blocks (land you can claim).
Arena Plots: You can build more arenas.
Resource Production: Higher levels boost your resource output.
Mayor Titles: Your mayor’s title changes to reflect your town’s status.
Outposts: You unlock the ability to create outposts at level 1.
Buy Bonus: Increases the number of bonus plots you can purchase.

Nation Levels

Nation levels are based on the number of towns in your nation (not residents). As your nation grows, you unlock more bonuses and privileges.

Nation Key Progression Points Table:

What changes as you level up?

Town Block Bonus: More towns = more bonus plots for all towns in the nation.

Outposts: Higher levels allow more outposts for the nation and its capital.

King Titles: The nation leader’s title changes to reflect the nation’s status.

Nation Zone Size: Expands the area of influence around the nation.

Upkeep Discount: Larger nations get discounts on town upkeep.

Nation Zones

You may or may not be familiar with the Towny feature known as Nation Zones. Nation Zones are a buffer zone outside of a town's claims that is neither under the control of the town owner or apart of the wilderness.

Instead, the buffer zone grants full permission and accessibility to members of the corresponding town's nation but no permissions to a non-member of the nation.

For example, lets say I am a member of the town Vujica, which is a member of the nation Northumbria; the capital of Northumbria is Wessex. Although Wessex is the capital of my nation, I may not have access to physically affecting Wessex in any way; I may not be able to break, build, or use in Wessex as although my nation's capital, its still not my town. BUT-right outside of each of Wessex's border townblocks is a bufferzone maybe 4 chunks long that I can break, build, and use in; I have full permission and access to this Nation Zone as a member of Wessex's nation Northumbria, but non-nation members cannot affect this zone (it is protected against these people).

This feature provides a common zone of interest between each town within a nation, as well as a buffer zone to griefing. Nation citizens can now go to a nation zone outside of a town, within their nation, and feel free to express comradery, partnership, and patriotism by creating builds that expand upon the town's vision and the nations theme. Conversely, if you are not a builder, you can express the same shared partnership maybe by simply leaving gifts or small monuments!

Last edit by: Logic @ 2025-05-31 10:47:35 am EST

NextEarning Money