A Guide To Towns

VextraCraft uses Towny as a base of its town system. Towny is an amazing and incredibly stable plugin that lets you claim land for you and your friends to build on without having it griefed by others. The following is a modified version of the Towny tutorial following the VextraCraft rules and settings.

Town Creation
To create a town, type /t new , this costs $50.000 ingame dollars. This will create a town on the chunk you are standing on. For example, /t new London will create a town called 'London', centered on the chunk you are standing on. This chunk is called your homeblock and you will spawn there if you die.

Once you have created a town, you can view its information by typing /t . This displays important information such as:


 * Your town's residents and their ranks


 * Your town's size - in other words, how many chunks you have claimed and the claim limit


 * Your town's outposts and outpost limit


 * Your town tax


 * Your town bank balance

Inviting Other Players
You can invite other players to your town using /t add . They will need to do /accept  to join.

Claiming Land
Your town has a limit on how many chunks (townblocks) it can claim. Each resident increases this limit by 8 chunks. To claim a chunk for your town, type /t claim. It must be next to an existing claim. This will deduct $20.000 from your town bank. To deposit money in your town bank, type /t deposit . You can view chunk borders with /resident toggle constantplotborder.

You can also buy additional townblocks with /t buy bonus . Joining or creating a nation will also increase the townblock limit.

Outposts
If you need to claim land which is not adjacent to an existing claim, you must create an outpost through /t claim outpost. Outposts cost more than regular claims, and your town must be in a nation to create them. You can only have a maximum of two outposts.

Town Upkeep
Each townblock your town claims will increase your town upkeep by $25. Town upkeep is collected from your town bank every 24 hours in real life. If your town bank does not have enough money to pay the upkeep, it will be disbanded and can be griefed.

Plot Management
Claimed townblocks/chunks are called plots. Remember that they are simply claimed chunks, so all of them are 16x16 blocks.

Selling Plots
Plots can be sold and given to your residents. To put a plot for sale, type /plot forsale  while standing inside it. By default, the plot price will be set 0. Residents can then buy the plot by typing /plot claim. If the plot has a price, the amount paid will go to the town bank.

You can change the default price for newly set-for-sale plots with /town set plotprice .

Plot Permissions
The owner of a plot can control who can access it by typing /plot set perm [on/off] while standing inside it.

Groups are:


 * friend - players on your friend list. You can edit your friend list with /res friend.
 * resident - players from your town.
 * ally - players from your town, nation and allied nations.
 * outsider - players not from your town, nation or an allied nation.

Permissions are:


 * build - controls whether a group can build in your plot
 * destroy - controls whether a group can break blocks in your plot
 * switch - controls whether a group can use chests, hoppers, furnaces, doors, dispensers, etc.
 * itemuse - controls whether a group can place/destroy minecarts, use buckets and bone meal, etc.

For example, /plot set perm build ally on would allow players from your town, nation and allied nations to build in the plot you are standing in.

If you want to control permissions for all your owned plots, use /resident set perm [on/off]

Mayors can control permissions for all unowned plots with /town set perm [on/off].

Plot Types
Plots can be of different types, which have unique functions. You can change a plot's type by typing /plot set  while standing in it.


 * default - the default plot type. All plots are default when first claimed. Non-default plots can be made default again with /plot set reset.
 * shop - designates a player shop area. The plot will appear red on the map.
 * arena - arena plots have PvP and friendly fire enabled at all times.
 * embassy - if for sale, embassy plots can be bought by any player, even if they're not a resident of the town.
 * bank - designates a bank, which allows you to deposit and withdraw from your town and nation banks.
 * farm - designates a farm, where the only blocks that can be placed and destroyed are crops.
 * wilds - designates a semi-protected wilderness plot, where trees, flowers, mushrooms etc can be broken but all other blocks cannot.

Town Management
Mayors can control various aspects of their town, including tax rates and rank assignment.

General Commands

 * /town set name  - changes your town name.
 * /town set mayor  - allows you to transfer the mayorship of your town.
 * /town set board  - sets the town board, which is seen on the scoreboard and by players when logging in.
 * /town set homeblock - sets the homeblock of your town. Typing /town set spawn in a homeblock changes your town respawn point to where you are standing.
 * /town set tag  - sets your town tag, which will be shown in chat instead of your full town name.

Ranks
Mayors can assign ranks to residents to aid them in administrating their town with /t rank add .


 * comayor - has all the permissions of a mayor (including the ability to delete a town!). Give this rank with caution.
 * assistant - has the ability to invite and kick residents, manage plots they don't own and claim land.
 * builder - can build in any plot, even if they don't own it.
 * planner - has full access to plot management commands.
 * treasurer - has full control over taxes (explained later in this tutorial) and can withdraw from the town bank.

Taxation
Mayors and treasurers can set taxes to extract money from residents. They are collected every 24 hours in real-life and are automatically deposited in the town bank.

There are two modes of taxation. The default mode of taxation, flat taxes, takes a set amount of money from residents each day. If a resident cannot afford to pay the tax, they will be kicked from the town. The other mode of taxation, percentage taxes, takes a percentage of residents' money each day. If a resident is unable to pay a percentage tax, they will not ' be kicked from the town.

The percentage and flat tax can be set through /town set taxes ' . To switch between the two modes of taxation, type /town toggle taxpercent.

The following commands allow you to set taxes for different plot types:


 * /town set plottax – Set taxes collected from each resident daily, per plot that they own.
 * /town set shoptax – Set taxes collected from each resident daily, per shop plot that they own.
 * /town set embassytax – Set taxes collected from each resident daily, per embassy plot that they own.

Nations
Towns can form nations. Nations are political entities which multiple towns can be part of. Joining or creating a nation gives towns multiple benefits, including:


 * The ability to wage war against other nations.
 * The ability to claim outposts.
 * Bonus townblocks - the larger the nation, the larger the bonus.

Nation Creation
If a town has more than $20,000 in its bank, its mayor can create a nation by typing /n new . For example, typing /n new USA will create a nation called 'USA' and will take $20,000 from your town bank. The founding town will become the nation capital, and its mayor will become the nation leader ('king').

Inviting Towns to Nations
You can invite other towns to your nation by typing /n add . The mayor of the town will be sent a message informing him of the invite and how to accept it. A town must be within 300 chunks of the nation capital's homeblock to be invited.

You can privately talk with players in your nation by typing /nc to switch to nation chat. You can return to general chat by typing /g.

Nation Upkeep and Taxation
Nations have a daily upkeep of $1,000 which is taken from the nation bank. You can deposit nation

You can set taxes on your nation's towns by typing /n set taxes . Like town taxes, nation taxes are taken every 24 hours in real life and are deposited in the nation bank.

General Nation Commands

 * /nation set title '  '   - grants a nation member a title which will appear before their name in chat.  
 * /nation set surname '  '   - grants a nation member a surname which will appear after their name in chat.  
 * ' /nation set'  name  - changes the nation name.  
 * /nation set capital  - changes the nation's capital city and transfers nation leadership to its mayor.
 * /nation set king  - transfers nation leadership to a player in your nation.
 * /nation set tag  - sets your nation tag, which will be shown in chat instead of your full nation name.

Nation Ranks
Nation leaders can assign ranks to nation members. This can be done by typing /n rank add . Like town ranks, these give the rank holder special privileges.


 * coleader - has all the abilities of the nation leader, including the ability to delete the nation! Give with caution.
 * chancellor - can manage nation allies and enemies, invite and kick towns, grant titles and surnames and withdraw from the nation bank.
 * treasurer - can change the tax rate and withdraw from the town bank.