Joining a Town
To join a town you can-
receive an invite with /t invite [playerName]. You can accept the incoming invite with /accept [town name].
view publicly open and joinable 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 with /vote
Create 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 $1 per amount of claim chunks your town has.
Upkeep will be withdrawn from your town bank daily. If you have insufficient funds to pay this daily minimum, your town will fall into 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 can join using /t invite accept <town name>.
Alternatively, they can use /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. /towny 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-
f3+g.
/chunkview | cv - Places blocks on the chunk boarder of the chunk you are in without using f3+g.
/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 bonus claim chunk limit increases by 50.
You can spend money to increase your claim limit using /t buy bonus.
Joining a nation will also increase your claim limit.
Commands & 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
/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
/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
/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
/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
/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).
Outlaw 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.