Towny is a plugin that allows players to create and join towns. Each town is run by a mayor who may have assistants to help with town duties. Towny protects areas through a land claim system that claims by chunk (16x16 area). Players that join towns will have their own plot or residence that they can build on within the town. Each town has an upkeep cost that must be met to keep the town standing.
Towny provides land claims based on the Minecraft chunk system. Each claimed plot is one chunk, 16 by 16 blocks, protected from bedrock to buildlimit. You can see chunks in-game by pressing the F3 and G keys at the same time. If you are on a laptop, or are using a smaller keyboard pressing F3 might also require the use of an Fn key.
When claiming land as a mayor or a town plot as a resident, this is the smallest unit of land that can be dealt in.
This section of the guide is for players that are joining or have joined an established town (i.e., you are a resident of the town).
Towns may impose additional rules that residents must abide by, as long as these additional rules are not in conflict with Vestria's Server Rules. These rules must be made clear to you when you join a town and displayed in an accessible location. If you do not abide by the town's rules, you may be evicted from the town without notice. If you are evicted for breaking a town rule, you will be allowed to retrieve any of your belongings.
Towns can also institute a tax for residents to collect funds for town upkeep and expansion. This tax is collected automatically, and will be taken from your balance once a day.
To join a town, you must first be invited by the mayor or one of their assistants. Once you've been invited, you can join the town by running /accept in-game.
If you've received invitations to join multiple towns at the same time, you can specify which invitation you'd like to accept to avoid joining the wrong town by accident. To do this, simply add the town name to the
/accept command, by running /accept NameOfTown in-game, and you'll join the town you want to join.
Leaving a town is simple as well. Just run /town leave in-game to leave your current town.
Make sure to remove all your belongings from a town before leaving, as you will immediately lose access to your plot when you leave your town.
You can see information about the town you're currently in using the
/town command. Just run /town in-game to see information about your current town, or if you're visiting another town you can run /town here in-game, while standing in that town, to see information about that town.
Once you've joined a town, you'll need a place to stay. You can claim a plot with the
/plot claim command. The player that invited you to join the town, will usually offer you a plot at the same time. Once you've reached your plot, simply stand inside it and run /plot claim in-game. This will claim the plot for you.
If your plot is more than one chunk in size, you will have to stand in each chunk and run /plot claim in-game, otherwise you will only own part of your plot. See above for help with identifying chunks.
When you're moving, or if you've accidentally claimed the wrong plot, you can unclaim a plot using the
/plot unclaim command. The process is the same as claiming a plot, just stand in the chunk you want to unclaim and run /plot unclaim in-game.
/plot set perm,
By default only you and town staff will be able to build on your plot. To allow other people to build on your land you can set plot permissions using the
/plot set perm command.
To use this command you first have to specify which group of players you wish to set a permission for. The available groups are:
friend: anyone on your Towny friends list
town: anyone in your town
ally: anyone in your nation or in nations allied with your nation
outsider: anyone not in your nation or in a nation allied with your nation
Once you've decided who you're going to be setting a permission for, you have to decide what permission to give that group. You can choose between:
build: allows that group to place blocks in your plot
destroy: allows that group to break blocks in your plot
switch: allows that group to use items such as doors and chests in your plot
itemuse: allows that group to use leads, minecarts, and similar items in your plot
switchpermission does not override LWC protections, as long as your chests are locked using LWC they will still be protected.
Once you've decided who to give what permission to, all you have to do is run /plot set perm who what on in-game, while standing in the plot you'd like to set the permission for, to enable the permission for that group. To deny a permission instead just replace
off: /plot set perm who what off.
You can also omit either
what from the
/plot set perm command, to respectively set or deny the permission for all groups, or set or deny all permissions for the group.
You can also omit both
what from the
/plot set perm command, to set or deny all permissions for all groups.
To check what permissions are currently set on a plot, you can use the
/plot perm command. While standing in the plot, run /plot perm in-game and you'll be able to see the permissions for that plot in chat.
You can also set permissions for all your owned plots using the
/resident set permcommand, as this functions nearly identically to setting permissions on a plot level it is not explained in detail here.
The permissions you set using the
/resident set permcommand will apply to all your owned plots, unless overridden on a plot level. Make sure you know this is what you want to do.
Managing your friends list can be done with the
/resident friend command.
To see who's currently on your list, just run /resident friend list in-game.
To add someone to your friends list, run /resident friend add YourFriend in-game to add YourFriend to your friends list.
To remove YourFriend from the list again, run /resident friend remove YourFriend in-game.
Each town gets access to their own private chat channel. You can access it using the
/tc command. To switch to the chat channel (any message you send, will be sent to that chat channel), run /tc in-game and just chat normally. You can either run /tc again, or /g to switch back to the global chat. If you just want to send a single message to the town chat without switching, run /tc your message, this will keep you in your current chat channel and just send this single message to town chat.
While some chat related rules are relaxed in town chat, for example you're allowed to speak any language in town chat, all Vestria Server Rules still apply.
Please make sure you're familiar with the Vestria Server Rules, and ask for clarification if you're unsure.
Just because it wasn't said in global chat doesn't mean you didn't say it.
If you break any Vestria Server Rules, you can and will be held responsible for your actions.
This section of the guide is for players that are creating and running their own town (i.e., you are the mayor of a town).
Creating and running a town is subject to a few rules.
Make sure to familiarize yourself with these Town Rules.
As a mayor you're allowed to set town rules that residents of your town must abide by. These rules cannot be in opposition with server rules (i.e., you cannot allow something that is disallowed in the server rules, nor can you reduce waiting periods related to resident eviction or protection removal).
You must post these rules in a location easily accessible by your residents and Vestria Server Staff, as well as inform every resident that you invite to your town about your town rules and where to find them.
When you make a change to your town rules, you must notify all your residents of the changes to the town rules. From the moment you provide the notice to your residents, they have a 48 hour grace period to make sure they are in compliance with your new town rules.
It is your responsibility as a mayor to ensure every town member receives notice of town rules changes, and that you can provide documentation for this notice being sent.
If a town member breaks town rules, you can evict them without notice. You must allow the player to retrieve all of their belongings.
Owning a town requires paying upkeep to the server. Your upkeep cost goes up with the amount of residents you have and gets taken out of your town bank every day. It's important to keep enough funds in your town bank to survive for a couple of days, since your town will fall if you run out of funds.
Every town member can deposit funds into your town bank, but only the mayor can withdraw from the town bank.
Run /town deposit amount in-game to deposit
amount of funds into the town bank.
Run /town withdraw amount in-game to withdraw
amount of funds from the town bank.
Make sure to leave enough funds in the town bank at all times to make it through a couple of days. You never know when you won't be able to get online due to unforeseen circumstances.
To see who has deposited and withdrawn money from the town bank you can use the
/town bankhistory command. Run /town bankhistory in-game to get a list of transactions.
Taxes are a way for you as a mayor to gather funds from your residents for town upkeep and expansion. When you set up taxes through the Towny plugin, the taxes will be automatically deducted from your residents balances and deposited into the town bank.
You can set up different taxes:
/town set taxes,
/town toggle taxpercent
Collecting taxes from your residents is easy, run /town set taxes amount in-game. This will start collecting a daily tax of
amount from each resident.
Alternatively you can enable tax based percentages by running /town toggle taxpercent in-game. Then use the
/town set taxes command to set a percent by running /town set taxes percent in-game.
/town set plottax,
/town set farmtax,
/town set embassytax,
/town set arenatax,
/town set shoptax
As a mayor you can also set up a tax per plot a resident owns, to enable this run /town set plottax amount in-game. This will collect taxes totalling
amount times the amount of plots they own from each resident every day.
The above command only sets the tax for normal plots, you can set a different tax for each plottype using the
/town set farmtax,
/town set embassytax,
/town set arenatax, and
/town set shoptax commands. These function identically to the normal
/town set plottax command, but each affect their respective plot type tax.
Aspiring mayors can create a new town with the
/town create command. As the town will be created where you are currently standing, make sure you are in the area you want your town to be.
Town creation costs $ 5,000.00 and you'll need some money left over for upkeep and claiming land.
Make sure you have adequate funds before creating a town as this cost is not refunded if you delete your town or if it falls due to insufficient funds.
Once you're ready to create your town, run /town create NameOfTown in-game and your town will be created (assuming you have the required funds of course).
If you no longer want to keep running your town, you can disband it using the
/town delete command. Simply run /town delete in-game and your town will be deleted.
To allow plots to be claimed by your residents you must set them for sale. To do this stand in the plot and run /plot forsale in-game. You can also specify a price if you would like to sell the plot to your residents, run /plot forsale amount in-game to allow the plot to be bought for
You can make plots unclaimable again by standing in them and running /plot notforsale in-game.
Towns have quite a few settings that can be changed using the
/town set command.
/town set homeblock command you can change the homeblock of your town. This is the chunk you claimed as the first land for your town by default, and where your town spawn is located. Just run /town set homeblock in-game while standing in the chunk you want to set as your homeblock.
/town set spawn command allows you to change the location where players teleport to when visiting your town, this must be within the homeblock. Just run /town set spawn in-game while standing where you want your new spawn to be.
You can change the name of your town as well, with the
/town set name command. Just run /town set name NewNameOfTown in-game to change the name of your town.
You can post announcements to your residents in your town board, with the
/town set board command. To set your message, run /town set board your message here in-game, players will be able to see your updated board using the
There are more settings you can change for your town that are not listed here, run /town set in-game to see a list of all settings you can change.
To expand your town you have to claim additional chunks, or plots, for residents to be able to build on.
This works the same as residents claiming plots from the town as described above. Just use the
/town claim and
/town unclaim commands instead of the
/plot claim and
/plot unclaim commands respectively.
Like towns as a whole, plots also have settings you can change as the mayor. The two main settings that can be changed are the plot name and plot type.
To set a name for your plot, run /plot set NameOfPlot in-game while standing in the plot you wish to change the name of. This can be useful for designating roads or other important town buildings.
To change the plot type of a plot, run /plot set type in-game, where type is one of:
reset: reset the plot to the default type
shop: designate the plot as a shop
arena: create an arena plot, pvp will always be enabled in these areas
embassy: allow players not in your town to claim this plot as an embassy for their town
wilds: allow residents to break certain blocks in the plot, this can be used to make tree farms
farm: allow residents to break and place farming related blocks within the plot, use this to create a town farm
Once again you can see all settings available for plots by running /plot set in-game.
After creating and setting up your town, you can invite, remove, and rank up residents.
To invite players to your town, run /town invite Player in-game to invite Player to your town.
To kick a player from your town, run /town kick Player in-game to remove Player from your town.
To see all residents currently a part of your town, run /town reslist in-game.
You can promote residents of your town to different ranks within your town with the
/town rank command. Available ranks are:
comayor: has the same permissions as the mayor
assistant: can claim land for the town, invite players, use all plot commands, and build and destroy on town owned land; can also assign the helper and vip rank
helper: can invite players to the town and set plots forsale and notforsale
vip: is exempt from town taxes
Run /town rank add Player rank in-game to add
rank to Player.
You can also remove ranks by running /town rank remove Player rank in-game to remove
rank from Player.
You can see which players have which ranks with the
/town ranklist command, just run /town ranklist in-game to see an overview of players in ranks.
/town set perm
Once again this works very similar to setting plot permissions for residents, explained above, just using the
/town set perm command instead of the
/plot set perm command. The
friend rank from there gets replaced with the
resident rank, which is anyone that is a resident of your town, and the
town rank gets replaced with the
nation rank, which is anyone that is a resident of your nation.
This section of the guide is for players that are creating and running their own nation (i.e., you are the king of a nation).
Nations may have up to 5 towns!
Similar to towns, nations are also required to pay upkeep to the server. This upkeep fee goes up the more residents are in a nation and is automatically withdrawn from the nation bank once a day. Just like towns, nations too will fall should they run out of funds. Make sure to keep your nation bank topped up enough to make it through a few days!
Every nation member can deposit funds into your nation bank, but only the king can withdraw from the nation bank.
Run /nation deposit amount in-game to deposit
amount of funds into the nation bank.
Run /nation withdraw amount in-game to withdraw
amount of funds from the nation bank.
Make sure to leave enough funds in the nation bank at all times to make it through a couple of days. You never know when you won't be able to get online due to unforeseen circumstances.
To see who has deposited and withdrawn money from the nation bank you can use the
/nation bankhistory command. Run /nation bankhistory in-game to get a list of transactions.
/nation set taxes
Nations can tax their member towns, similar to how towns can tax their residents. Nation Kings can set up taxes by running /nation set taxes amount in-game, this will withdraw
amount from each member towns bank and deposit it into the nation bank every day.
Aspiring kings can create a new nation, once they meet the requirements, with the
/nation create command.
Nation creation costs $ 250,000.00 and you'll need some money left over for upkeep.
Make sure you have adequate funds before creating a nation as this cost is not refunded if you delete your nation or if it falls due to insufficient funds.
Once you're ready to create your nation, run /nation create NameOfNation in-game and your nation will be created (assuming you have the required funds of course).
If you no longer want to keep running your nation, you can disband it using the
/nation delete command. Simply run /nation delete in-game and your nation will be deleted.
Just like towns, nations also have settings you can change as the king.
Some settings will be similar or the same as the above town settings, just using the
/nation set command instead of the
/town set command.
Once again you can see a list of all available settings by running /nation set in-game.
After creating and setting up your nation, you can invite and remove member towns, and rank up residents within your nation.
To invite a town to your nation, run /nation invite NameOfTown in-game to invite NameofTown to your nation.
To kick a town from your nation, run /nation kick NameOfTown in-game to remove NameOfTown from your nation.
To see all towns currently a part of your town, run /nation townlist in-game.
You can promote residents of your nation to different ranks within your nation with the
/nation rank command. Available ranks are:
Run /nation rank add Player rank in-game to add
rank to Player.
You can also remove ranks by running /nation rank remove Player rank in-game to remove
rank from Player.
You can see which players have which ranks with the
nation ranklist command, just run /nation ranklist in-game to see an overview of players in ranks.
To quickly see prices related to towny features, you can use the
/towny prices commands. Just run /towny prices in-game to see the cost for creating a town and nation, claiming plots and outposts, the daily town and nation upkeep, as well as the plot taxes set for your town.