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.
/accept, /town leaveTo 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.
/townYou 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.
/plot claim, /plot unclaimOnce 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, /plot perm, /resident friendBy 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 listtown: anyone in your townally: anyone in your nation or in nations allied with your nationoutsider: anyone not in your nation or in a nation allied with your nationOnce 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 plotdestroy: allows that group to break blocks in your plotswitch: allows that group to use items such as doors and chests in your plotitemuse: allows that group to use leads, minecarts, and similar items in your plotGiving the
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 on with off: /plot set perm who what off.
You can also omit either who or 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 who and 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.
/tcEach 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.
/town deposit, /town withdrawEvery 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.
/town bankhistoryTo 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 taxpercentCollecting 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 shoptaxAs 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.
/town create, /town deleteAspiring 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.
/plot forsale, /plot notforsaleTo 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 amount.
You can make plots unclaimable again by standing in them and running /plot notforsale in-game.
/town setTowns have quite a few settings that can be changed using the /town set command.
With the /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.
The /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 /town command.
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.
/town claim, /town unclaimTo 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.
/plot setLike 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 typeshop: designate the plot as a shoparena: create an arena plot, pvp will always be enabled in these areasembassy: allow players not in your town to claim this plot as an embassy for their townwilds: allow residents to break certain blocks in the plot, this can be used to make tree farmsfarm: allow residents to break and place farming related blocks within the plot, use this to create a town farmOnce again you can see all settings available for plots by running /plot set in-game.
/town invite, /town kick, /town reslist, /town rank, /town ranklistAfter 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 mayorassistant: 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 rankbuilder: can build, destroy and switch in town owned landhelper: can invite players to the town and set plots forsale and notforsalevip: is exempt from town taxessherrif: can add people to the town jail (with towny jails being disabled, this rank is just a tag)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 permOnce 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!
/nation deposit, /nation withdrawEvery 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.
/nation bankhistoryTo 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 taxesNations 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.
/nation create, /nation deleteAspiring 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.
/nation setJust 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.
/nation invite, /nation kick, /nation townlist, /nation rank, /nation ranklistAfter 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:
assistanthelperRun /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.
/towny pricesTo 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.