Wiki赞助.jpg
  • 欢迎来到Minecraft插件百科!请在注册后加入百科编辑
  • 对百科编辑一脸懵逼?帮助:快速入门带您快速熟悉百科编辑!
  • 插件百科企鹅群:223812289

Difference between revisions of "Towny"

From Minecraft插件百科
Jump to: navigation, search
m
(搬运自 http://palmergames.com/towny/)
Line 1: Line 1:
 
{{待翻译}}
 
{{待翻译}}
 +
 
== 介绍 ==
 
== 介绍 ==
 
Towny Advanced is a versatile, player-controlled land management plugin for use with Bukkit/Tekkit/Spigot/Libigot. Towny offers solutions for pvp, griefing, chat, inflated economies and monsters to minecraft server admins. Towny allows players to work together and against each other as they see fit.
 
Towny Advanced is a versatile, player-controlled land management plugin for use with Bukkit/Tekkit/Spigot/Libigot. Towny offers solutions for pvp, griefing, chat, inflated economies and monsters to minecraft server admins. Towny allows players to work together and against each other as they see fit.
Line 49: Line 50:
  
  
Here are instructions to install Towny for the first time. There are a few steps so follow them all carefully.<br />
+
:Here are instructions to install Towny for the first time. There are a few steps so follow them all carefully.<br />
  
'''Step One – Preparing your server.'''<br />
+
:'''Step One – Preparing your server.'''<br />
  
#Stop your server completely.
+
:#Stop your server completely.
#Download the following and copy to your Plugins folder (Place .jar files in the plugins folder, not the actual .zip):
+
:#Download the following and copy to your Plugins folder (Place .jar files in the plugins folder, not the actual .zip):
::*Download Towny Advanced.zip (Includes Towny, TownyChat and Questioner.)
+
:::*Download Towny Advanced.zip (Includes Towny, TownyChat and Questioner.)
::**Towny.jar is required at all times,
+
:::**Towny.jar is required at all times,
::**TownyChat.jar is required if you want to have Towny modify chatting in any way. (Adding prefixes and suffixes from your permissions plugin to chat, adding town/nation/world to chat, adding chat channels.)
+
:::**TownyChat.jar is required if you want to have Towny modify chatting in any way. (Adding prefixes and suffixes from your permissions plugin to chat, adding town/nation/world to chat, adding chat channels.)
::**Questioner.jar is required if you want players to receive invites to towns, instead of being added automatically.
+
:::**Questioner.jar is required if you want players to receive invites to towns, instead of being added automatically.
::*If you use any economy plugin other than iConomy 5.01 you will be required to download Register.jar or Vault and put it in your plugins folder.
+
:::*If you use any economy plugin other than iConomy 5.01 you will be required to download Register.jar or Vault and put it in your plugins folder.
::**If your economy plugin is supported by Vault, do not use Register.jar, instead use only Vault.
+
:::**If your economy plugin is supported by Vault, do not use Register.jar, instead use only Vault.
#Start your server.
+
:#Start your server.
#Stop your server.
+
:#Stop your server.
  
 
=== Towny 升级向导 ===
 
=== Towny 升级向导 ===
  
Here are instructions for performing a Towny Upgrade from a previous version:
+
:Here are instructions for performing a Towny Upgrade from a previous version:
 +
 
 +
:'''Towny Upgrade Instructions'''
 +
 
 +
:*Stop your server completely.
 +
:*Backup your entire server!
 +
:*Download Towny_Advanced.zip and extract the 4 .jar files into your plugins folder (Register is not required if your server already uses Vault.jar).
 +
:*Start your server.
 +
:*Stop your server.
 +
:*Upgrade from pre-0.79.0.0
 +
:**The chat section of config.yml has been move to a new file, channels.yml. Edit the new channels.yml to your liking.
 +
:*Upgrade from pre-0.82.0.0
 +
:::*Towny has had TownyPerms added. This new file located at townysettingstownyperms.yml will be generated when you first start your server using Towny 0.82.0.0 or higher.
 +
:::*TownyPerms adds town/nation ranks so server admins can specify what each rank can do (nomads, residents, mayors, kings, etc) Admins can also create custom ranks with custom permission sets. Any existing players set as assistants will lose their rank and need to have it re-assigned.
 +
:*Start your server.
 +
 
 +
=== Towny 的工作方式 ===
 +
 
 +
Use this page to learn how Towny works, how various settings affect the gameplay, what you can do to customize Towny to your liking.
 +
 
 +
----
 +
==== <big>The Hierarchy</big> ====
 +
 
 +
===== Nomads =====
 +
 
 +
:Nomads are simply players who are not part of any town. They are landless and their permission nodes are configurable via TownyPerms.yml. Nomads can purchase Embassy plots if they have been given towny.command.plot.claim in the Townyperms.yml
 +
 
 +
===== Residents =====
 +
 
 +
:Every person who joins your server can become a resident (the are given the towny.town.resident permission node in townyperms.yml’s nomad section.) Residents have their own command /resident which used by itself outputs a Resident Screen, displaying Money, Town, Plots owned and Friends.
 +
 
 +
:Residents can join towns or choose to start a town of their own. Residents can also be put into one town automatically when they join the server for the first time by setting default_town_name: '' in config.yml.
 +
 
 +
:Residents who join towns can claim plots that the Mayor of the town has set for sale. When a resident owns 1 or more plots, they will see a new line on their Resident Screen, showing plots owned and a perm line showing the plot perms given on all plots that resident owns.
 +
 
 +
:Residents have their permission nodes configurable via TownyPerms.yml.
 +
 
 +
===== Towns =====
 +
 
 +
:A town is a collection of residents (or just one resident) with one resident as the mayor. A town also has a bank which the mayor can withdraw from. A mayor can also have assistants who have the same powers as him/herself. Towns can have taxes that will be taken at the end of each day interval.
 +
 
 +
:Towns usually grow outwards from their home block, the townblock the mayor stood in during town creation. Townblocks need to be claimed beside other townblocks, unless the mayor claims an outpost in the wilderness.
 +
 
 +
===== Mayors =====
 +
 
 +
:Mayors run towns and with the help of their assistants, manage a town and its residents. Mayors have their permission nodes configurable via TownyPerms.yml.
 +
 
 +
:Mayors can decide which ranks their residents fall into, in their town. This can be a Town Assistant or any other custom ranks created by the server admin in the townyperms.yml file. Mayors can see the available ranks using ‘/town ranklist’ command. Players are ranked using ‘/town rank {add|remove} {playername} {rankname}’. A player can have more than one rank assigned, allowing admins to create diverse town-roles such as bankers, builders, inviters for the mayor to choose for their trusted residents.
 +
 
 +
:It is not possible to run two towns unless you are also an admin. An admin can do the following to manage two or more towns:
 +
 
 +
  Example: Admin Bob
 +
  Admin Bob wants to have a server-town, and his own town. Bob would start by creating his Server Town and setting up taxes, plotprices, permissions. This sort of town should not give residents, allies or outsiders permissions in the   
 +
  Server Town.
 +
  When Bob finished making his town the way he wants he uses /townyadmin set mayor {townname} npc to place a fake 'npc' resident as mayor of the Server Town.
 +
  Then Bob leaves Server Town and creates his own town. Using the /townyadmin set mayor {townname} npc command Bob can flip back and forth between towns.
 +
  Bob doesn't have to leave his town to add players to the Server Town though! He can use /townyadmin town {townname} add {playername}  to add players to the Server Town or set default_town_name: 'Server_Town' in config.yml.
 +
  Bob can also add the NPC town into a nation using /ta nation {nation} add {town}.
 +
 
 +
===== Nations =====
 +
 
 +
:A nation is a collection of towns (or just one town) with one town as the capital. The mayor of that capital is the king. A nation can join the war event, as well as ally other nations. A nation also has it’s own bank. It can also tax the towns that belong to it.
 +
 
 +
:Two nations can decide to join in an alliance, which allows them to be protected from friendly fire, help on each others plots (if the plot’s perm line allows allies,) and to help each other in war.
 +
 
 +
:As of 0.91.0.0, you may restrict nation alliances to be 2-way only. So that Nation A cannot consider Nation B an ally unless the Nation B also considers Nation A an ally. You may turn this setting on in the config: war.disallow_one_way_alliance, which defaults to false.
 +
 
 +
:Also, as of 0.91.0.0, you may restrict who can create, join and maintain a nation by requiring a minimum number of residents. See the Global Town Settings section of the config.yml.
 +
 
 +
===== Kings =====
 +
 
 +
:Kings lead Nations and are the mayor of the capital city. Kings have their permission nodes configurable via TownyPerms.yml.
 +
 
 +
:Kings can decide which ranks their residents fall into, in their nation. This can be a Nation Assistant or any other custom ranks created by the server admin in the townyperms.yml file. Kings can see the available ranks using ‘/nation ranklist’ command. Players are ranked using ‘/nation rank {add|remove} {playername} {rankname}’. A player can have more than one rank assigned, allowing admins to create diverse nation-roles such as bankers, inviters for the king to choose for their trusted residents.
 +
 
 +
:Kings have the ability to set titles (prefixes) and surnames (postfixes) to the residents of the towns they have in their nation. This is done with:
 +
 
 +
:*/nation set title {name} titlegoeshere
 +
:*/nation set surname {name} surnamegoeshere
 +
:Typing the commands with nothing after the player’s name resets the title or surname to blank.
 +
 
 +
===== Configuring Townyperms.yml and the Roles of the Ranks Within =====
 +
 
 +
:New to Towny 0.82.0.0 and onwards towny has a new configuration file, TownyPerms.yml, located in the towny\settings\ folder.
 +
 
 +
:This system pushes permissions directly to Bukkit and works along side all other perms plugins. It allows you to define sets of permissions based upon a players status (nomad/resident/mayor/king). You can also assign additional permissions based upon any assigned town/nation ranks (assistant/vip etc). This system is not limited to Towny permission nodes. You can assign any permissions for any plugins in it’s groups.
 +
 
 +
:This file allows admins to decide what each player-rank can do. Some ranks are assigned automatically:
 +
 
 +
::*Players without towns are Nomads.
 +
::*Players in towns are Residents.
 +
::*Owners of towns are Mayors.
 +
::*Owners of nations are Kings.
 +
 
 +
:Some ranks are assigned by Mayors or Kings, and supplement the ranks the players already have:
 +
 
 +
::*Mayors can make a resident a Town Assistant.
 +
::*Kings can make a resident a Nation Assistant.
 +
::*Mayors and kings can grant admin-created ranks, allowing for diverse customization.
 +
:::*A player can attain many Supplemental ranks from their mayor or king, allowing for diverse nation/town-roles.
 +
:::*Examples of this would be town-builders, town-bankers, nation-bankers, town-inviters, etc.
 +
 
 +
:A resident of a town can see the ranks within their town using ‘/town ranklist’. A mayor can use ‘/town rank {add|remove} {playername} {rankname}’ to give a player a new rank within their town. A king can use ‘/nation rank {add|remove} {playername} {rankname}’ to give a player a new rank within their nation.
 +
 
 +
===== Configuring Mayor and King Titles, Town and Nation Names =====
 +
 
 +
:Towny gives you the ability to customize the naming scheme applied to Mayors, Kings, Towns, Capital Cities and Nations.
 +
 
 +
:This is done with two sections in the config.yml
 +
 
 +
::*town_level:
 +
::**The basic layout of the townLevel lines are as follows:
 +
 
 +
    -  upkeepModifier: 1.0
 +
        namePostfix: ' (Settlement)'
 +
        mayorPrefix: 'Hermit '
 +
        mayorPostfix: ''
 +
        townBlockLimit: 16
 +
        namePrefix: ''
 +
        numresidents: 1
 +
    -  upkeepModifier: 1.0
 +
        namePostfix: ' (Hamlet)'
 +
        mayorPrefix: 'Chief '
 +
        mayorPostfix: ''
 +
        townBlockLimit: 32
 +
        namePrefix: ''
 +
        numResidents: 2
 +
 
 +
:*These are read as follows:
 +
:*upkeepModifier: 1.0 – Use a higher multiplier to increase the upkeep as towns get more residents (unless you use town_plotbased_upkeep:true in which case it is based off of plot-count rather than resident-count.)
 +
:*namePostfix: ‘ (Settlement)’ – This is added to the end of the town name.
 +
:*mayorPrefix: ‘Hermit ‘ – This is added to the front of the mayor’s name.
 +
:*mayorPostfix: ” – This is added to the end of the mayor’s name.
 +
:*townBlockLimit: 16 – This decides how many townblocks a town gets, it is only used if town_block_ratio: ‘0’ is set in the config.yml.
 +
:*namePrefix: ” – This is added to the front of the town name.
 +
:*numresidents: 1 – This is how many residents a town needs to have in order to attain the prefixes/postfixes of the townlevel.
 +
:*The two levels above are for towns of 1 and 2 residents. When a town is created the mayor’s new town has (Settlement) added to the end of his townname and he is given the prefix of Hermit. When the mayor gets a second resident his town becomes Townname (Hamlet) and he receives the prefix of Chief.
 +
:*nation_level:
 +
:**The basic layout of the nationLevel lines are as follows:
 +
 
 +
        -  capitalPostfix: ''
 +
            upkeepModifier: 1.0
 +
            namePostfix: ' (Nation)'
 +
            kingPrefix: 'Count '
 +
            townBlockLimitBonus: 10
 +
            namePrefix: 'Federation of '
 +
            numResidents: 10
 +
            capitalPrefix: ''
 +
            kingPostfix: ''
 +
            nationTownUpkeepModifier: 1.0
 +
        -  capitalPostfix: ''
 +
            upkeepModifier: 1.0
 +
            namePostfix: ' (Nation)'
 +
            kingPrefix: 'Duke '
 +
            townBlockLimitBonus: 20
 +
            namePrefix: 'Dominion of '
 +
            numResidents: 20
 +
            capitalPrefix: ''
 +
            kingPostfix: ''
 +
            nationTownUpkeepModifier: 1.0
 +
 
 +
:*These are read as follows:
 +
:*capitolPostfix: ” – This is added to the end of the capital city of the nation.
 +
:*upkeepModifier: 1.0 – Use a higher multiplier to increase the upkeep as nations get more residents (unless you use town_plotbased_upkeep:true in which case it is based off of plot-count rather than resident-count.)
 +
:*namePostfix: ‘ (Nation)’ – This is added to the end of the nation name.
 +
:*kingPrefix: ‘Count ‘ – This is added to the front of the nation-leader.
 +
:*townBlockLimitBonus: 10 – This is the number of bonus townblocks given to a town when they join a nation.
 +
:*namePrefix: ‘Federation of ‘ – This is added to the front of the nation name.
 +
:*numResidents: 10 – This is how many residents a nation must have to receive the prefixes and postfixes of the nation level.
 +
:*capitalPrefix: ” – This is added to the front of the capital city of the nation.
 +
:*kingPostfix: ” – This is added to the end of the nation-leader’s name.
 +
:*nationTownUpkeepModifier: 1.0 – Joining a nation will lower/raise how much town upkeep your town pays. This multiplier is calculated after all other multipliers have their effect on the town upkeep cost. When set at 1.0, there is no :*change to upkeep.
 +
 
 +
----
 +
==== <big>How Towns Grow</big> ====
 +
 
 +
===== Starting a Town =====
 +
 
 +
:Mayors start towns using the command /town new {townname}. The townblock they are standing in will be the home block for the town, the exact spot/position will be the spawn point for the town.<br />
 +
 
 +
:More townblocks can be claimed using /town claim. These townblocks need to be directly adjacent to already claimed townblocks.
 +
 
 +
===== Joining Towns =====
 +
 
 +
:There are two ways to join towns, the first is by being invited by a Mayor or a Town assistant. The second it by joining an open town.
 +
 
 +
:Mayors and assistants can add players to their town with the command /town add {playername}. If the server has Questioner.jar and using_questioner: true in the Towny config.yml then the player will receive a prompt to either /accept or /deny the invitation.
 +
 
 +
:Mayors can set their towns to open using /town toggle open. A player who isn’t in a town already can use the command /town join {townname} to join open towns.
 +
 
 +
:When residents join towns they increase the number of townblocks accessible to the mayor for claiming.
 +
 
 +
----
 +
==== Plot System of Land Ownership ====
 +
 
 +
===== Town Blocks =====
 +
 
 +
:Towny provides a server admin a hands-off approach to block-protection. Block protection is broken down into plots of land, called townblocks, which by default are 16x16x128 (the full height of the world.)
 +
:Townblocks are claimed by town mayors who can then sell/give individual plots to their town’s residents.
  
'''Towny Upgrade Instructions'''
+
===== Town Block Size =====
  
Stop your server completely.
+
:You change the townblock size in config.yml at town_block_size: 16. Changing this value is suggested only when you first install Towny.
Backup your entire server!
+
:Doing so after entering data will shift things unwantedly. Using smaller value will allow higher precision,at the cost of more work setting up. Also, extremely small values will render the caching done useless.
Download Towny_Advanced.zip and extract the 4 .jar files into your plugins folder (Register is not required if your server already uses Vault.jar).
+
:Each cell is (town_block_size x town_block_size x 128) in size, with 128 being from bedrock to clouds.
Start your server.
 
Stop your server.
 
Upgrade from pre-0.79.0.0
 
The chat section of config.yml has been move to a new file, channels.yml. Edit the new channels.yml to your liking.
 
Upgrade from pre-0.82.0.0
 
Towny has had TownyPerms added. This new file located at townysettingstownyperms.yml will be generated when you first start your server using Towny 0.82.0.0 or higher.
 
TownyPerms adds town/nation ranks so server admins can specify what each rank can do (nomads, residents, mayors, kings, etc) Admins can also create custom ranks with custom permission sets. Any existing players set as assistants will lose their rank and need to have it re-assigned.
 
Start your server.
 

Revision as of 15:25, 9 August 2016

Icon-info.png
本页面已存在其他语言的内容,请协助翻译为本地化的中文。
  • 点击此处开始翻译。
  • 如本模板出现在原文存档页面,请注意更新主页面后,仍需要去除此处该模板
  • 如当前页面已经没有需要翻译的内容,请删去待翻译模板
  • 有标题的大篇幅文章,如果短时间内无法全部翻译,请先把所有的标题翻译出来,以便
  • 之后的贡献者选择与翻译章节内容。


介绍

Towny Advanced is a versatile, player-controlled land management plugin for use with Bukkit/Tekkit/Spigot/Libigot. Towny offers solutions for pvp, griefing, chat, inflated economies and monsters to minecraft server admins. Towny allows players to work together and against each other as they see fit.

特性

Towny includes a wide variety of features to offer instant enhancements to your traditional Minecraft server.

  • Allows players to own and manage land based on a pre-set grid layout.
    • Players join towns and purchase plots of land.
    • Players decide who can build, destroy, use “switchs” and use items on every plot they control.
    • Towns can join together into nations, further structuring a server into teams.
    • Towns grant protection from monsters, pvp, fire, explosions and greifing.
  • Wilderness Rules (Optional)
    • Area between towns is wilderness, with its own build permissions.
    • Limit players’ interaction with the wild to just harvest-able blocks, keeping the wild pristine.
    • Roll-back tnt, creeper, wither explosions, dragon damage and endermen block-moving.
    • Block explosions and fire.
  • PVP Enhancements
    • Server with a strong PVP aspect will find Towny’s grouping of players to be invaluable.
    • Prevent friendly-fire. (Optional)
    • Nations split players into larger teams.
    • Nations can declare other nations to be allies or enemies, further splitting players into even larger teams.
    • PVP can be turned on/off in wilderness, towns and worlds. (Optional)
  • Teleporting/Warping and Spawning (Optional)
    • Players can spawn to their town upon death.
    • Players can spawn to their town or a town that is within their nation/allied with their nation.
    • Use of beds can be limited to personally-owned land and players can spawn there.
  • Customized modified chat. (Optional)
    • Colours, group prefixes and suffixes, nation, town, towny titles.
    • Channels for general, local, town, nation, moderator, admin and custom channels.
    • Anti-spam feature.
  • Shop plugin support. (Optional)
    • Limit shops to special Shop Plots, enhancing realism.
  • Economy plugin interaction. (Optional)
    • Supports all economy plugins.
    • Charge money for plots, towns, nations.
    • Flexible tax system.
    • Upkeep to remove money from the economy, stopping rampant inflation.
  • All Permissions Plugins supported. (Optional)
    • Perms 2/3, GroupManager, BukkitPermissions, bPermissions, PermissionsEx, etc.
  • Multiworld Support
    • Flexible settings for every world.
    • Enable/disable Towny in as many worlds as you like.

重要信息

Towny 安装指南

Here are instructions to install Towny for the first time. There are a few steps so follow them all carefully.
Step One – Preparing your server.
  1. Stop your server completely.
  2. Download the following and copy to your Plugins folder (Place .jar files in the plugins folder, not the actual .zip):
  • Download Towny Advanced.zip (Includes Towny, TownyChat and Questioner.)
    • Towny.jar is required at all times,
    • TownyChat.jar is required if you want to have Towny modify chatting in any way. (Adding prefixes and suffixes from your permissions plugin to chat, adding town/nation/world to chat, adding chat channels.)
    • Questioner.jar is required if you want players to receive invites to towns, instead of being added automatically.
  • If you use any economy plugin other than iConomy 5.01 you will be required to download Register.jar or Vault and put it in your plugins folder.
    • If your economy plugin is supported by Vault, do not use Register.jar, instead use only Vault.
  1. Start your server.
  2. Stop your server.

Towny 升级向导

Here are instructions for performing a Towny Upgrade from a previous version:
Towny Upgrade Instructions
  • Stop your server completely.
  • Backup your entire server!
  • Download Towny_Advanced.zip and extract the 4 .jar files into your plugins folder (Register is not required if your server already uses Vault.jar).
  • Start your server.
  • Stop your server.
  • Upgrade from pre-0.79.0.0
    • The chat section of config.yml has been move to a new file, channels.yml. Edit the new channels.yml to your liking.
  • Upgrade from pre-0.82.0.0
  • Towny has had TownyPerms added. This new file located at townysettingstownyperms.yml will be generated when you first start your server using Towny 0.82.0.0 or higher.
  • TownyPerms adds town/nation ranks so server admins can specify what each rank can do (nomads, residents, mayors, kings, etc) Admins can also create custom ranks with custom permission sets. Any existing players set as assistants will lose their rank and need to have it re-assigned.
  • Start your server.

Towny 的工作方式

Use this page to learn how Towny works, how various settings affect the gameplay, what you can do to customize Towny to your liking.


The Hierarchy

Nomads
Nomads are simply players who are not part of any town. They are landless and their permission nodes are configurable via TownyPerms.yml. Nomads can purchase Embassy plots if they have been given towny.command.plot.claim in the Townyperms.yml
Residents
Every person who joins your server can become a resident (the are given the towny.town.resident permission node in townyperms.yml’s nomad section.) Residents have their own command /resident which used by itself outputs a Resident Screen, displaying Money, Town, Plots owned and Friends.
Residents can join towns or choose to start a town of their own. Residents can also be put into one town automatically when they join the server for the first time by setting default_town_name: in config.yml.
Residents who join towns can claim plots that the Mayor of the town has set for sale. When a resident owns 1 or more plots, they will see a new line on their Resident Screen, showing plots owned and a perm line showing the plot perms given on all plots that resident owns.
Residents have their permission nodes configurable via TownyPerms.yml.
Towns
A town is a collection of residents (or just one resident) with one resident as the mayor. A town also has a bank which the mayor can withdraw from. A mayor can also have assistants who have the same powers as him/herself. Towns can have taxes that will be taken at the end of each day interval.
Towns usually grow outwards from their home block, the townblock the mayor stood in during town creation. Townblocks need to be claimed beside other townblocks, unless the mayor claims an outpost in the wilderness.
Mayors
Mayors run towns and with the help of their assistants, manage a town and its residents. Mayors have their permission nodes configurable via TownyPerms.yml.
Mayors can decide which ranks their residents fall into, in their town. This can be a Town Assistant or any other custom ranks created by the server admin in the townyperms.yml file. Mayors can see the available ranks using ‘/town ranklist’ command. Players are ranked using ‘/town rank {add|remove} {playername} {rankname}’. A player can have more than one rank assigned, allowing admins to create diverse town-roles such as bankers, builders, inviters for the mayor to choose for their trusted residents.
It is not possible to run two towns unless you are also an admin. An admin can do the following to manage two or more towns:
 Example: Admin Bob
 Admin Bob wants to have a server-town, and his own town. Bob would start by creating his Server Town and setting up taxes, plotprices, permissions. This sort of town should not give residents, allies or outsiders permissions in the     
 Server Town.
 When Bob finished making his town the way he wants he uses /townyadmin set mayor {townname} npc to place a fake 'npc' resident as mayor of the Server Town.
 Then Bob leaves Server Town and creates his own town. Using the /townyadmin set mayor {townname} npc command Bob can flip back and forth between towns.
 Bob doesn't have to leave his town to add players to the Server Town though! He can use /townyadmin town {townname} add {playername}  to add players to the Server Town or set default_town_name: 'Server_Town' in config.yml.
 Bob can also add the NPC town into a nation using /ta nation {nation} add {town}.
Nations
A nation is a collection of towns (or just one town) with one town as the capital. The mayor of that capital is the king. A nation can join the war event, as well as ally other nations. A nation also has it’s own bank. It can also tax the towns that belong to it.
Two nations can decide to join in an alliance, which allows them to be protected from friendly fire, help on each others plots (if the plot’s perm line allows allies,) and to help each other in war.
As of 0.91.0.0, you may restrict nation alliances to be 2-way only. So that Nation A cannot consider Nation B an ally unless the Nation B also considers Nation A an ally. You may turn this setting on in the config: war.disallow_one_way_alliance, which defaults to false.
Also, as of 0.91.0.0, you may restrict who can create, join and maintain a nation by requiring a minimum number of residents. See the Global Town Settings section of the config.yml.
Kings
Kings lead Nations and are the mayor of the capital city. Kings have their permission nodes configurable via TownyPerms.yml.
Kings can decide which ranks their residents fall into, in their nation. This can be a Nation Assistant or any other custom ranks created by the server admin in the townyperms.yml file. Kings can see the available ranks using ‘/nation ranklist’ command. Players are ranked using ‘/nation rank {add|remove} {playername} {rankname}’. A player can have more than one rank assigned, allowing admins to create diverse nation-roles such as bankers, inviters for the king to choose for their trusted residents.
Kings have the ability to set titles (prefixes) and surnames (postfixes) to the residents of the towns they have in their nation. This is done with:
  • /nation set title {name} titlegoeshere
  • /nation set surname {name} surnamegoeshere
Typing the commands with nothing after the player’s name resets the title or surname to blank.
Configuring Townyperms.yml and the Roles of the Ranks Within
New to Towny 0.82.0.0 and onwards towny has a new configuration file, TownyPerms.yml, located in the towny\settings\ folder.
This system pushes permissions directly to Bukkit and works along side all other perms plugins. It allows you to define sets of permissions based upon a players status (nomad/resident/mayor/king). You can also assign additional permissions based upon any assigned town/nation ranks (assistant/vip etc). This system is not limited to Towny permission nodes. You can assign any permissions for any plugins in it’s groups.
This file allows admins to decide what each player-rank can do. Some ranks are assigned automatically:
  • Players without towns are Nomads.
  • Players in towns are Residents.
  • Owners of towns are Mayors.
  • Owners of nations are Kings.
Some ranks are assigned by Mayors or Kings, and supplement the ranks the players already have:
  • Mayors can make a resident a Town Assistant.
  • Kings can make a resident a Nation Assistant.
  • Mayors and kings can grant admin-created ranks, allowing for diverse customization.
  • A player can attain many Supplemental ranks from their mayor or king, allowing for diverse nation/town-roles.
  • Examples of this would be town-builders, town-bankers, nation-bankers, town-inviters, etc.
A resident of a town can see the ranks within their town using ‘/town ranklist’. A mayor can use ‘/town rank {add|remove} {playername} {rankname}’ to give a player a new rank within their town. A king can use ‘/nation rank {add|remove} {playername} {rankname}’ to give a player a new rank within their nation.
Configuring Mayor and King Titles, Town and Nation Names
Towny gives you the ability to customize the naming scheme applied to Mayors, Kings, Towns, Capital Cities and Nations.
This is done with two sections in the config.yml
  • town_level:
    • The basic layout of the townLevel lines are as follows:
    -   upkeepModifier: 1.0
        namePostfix: ' (Settlement)'
        mayorPrefix: 'Hermit '
        mayorPostfix: 
        townBlockLimit: 16
        namePrefix: 
        numresidents: 1
    -   upkeepModifier: 1.0
        namePostfix: ' (Hamlet)'
        mayorPrefix: 'Chief '
        mayorPostfix: 
        townBlockLimit: 32
        namePrefix: 
        numResidents: 2
  • These are read as follows:
  • upkeepModifier: 1.0 – Use a higher multiplier to increase the upkeep as towns get more residents (unless you use town_plotbased_upkeep:true in which case it is based off of plot-count rather than resident-count.)
  • namePostfix: ‘ (Settlement)’ – This is added to the end of the town name.
  • mayorPrefix: ‘Hermit ‘ – This is added to the front of the mayor’s name.
  • mayorPostfix: ” – This is added to the end of the mayor’s name.
  • townBlockLimit: 16 – This decides how many townblocks a town gets, it is only used if town_block_ratio: ‘0’ is set in the config.yml.
  • namePrefix: ” – This is added to the front of the town name.
  • numresidents: 1 – This is how many residents a town needs to have in order to attain the prefixes/postfixes of the townlevel.
  • The two levels above are for towns of 1 and 2 residents. When a town is created the mayor’s new town has (Settlement) added to the end of his townname and he is given the prefix of Hermit. When the mayor gets a second resident his town becomes Townname (Hamlet) and he receives the prefix of Chief.
  • nation_level:
    • The basic layout of the nationLevel lines are as follows:
        -   capitalPostfix: 
            upkeepModifier: 1.0
            namePostfix: ' (Nation)'
            kingPrefix: 'Count '
            townBlockLimitBonus: 10
            namePrefix: 'Federation of '
            numResidents: 10
            capitalPrefix: 
            kingPostfix: 
            nationTownUpkeepModifier: 1.0
        -   capitalPostfix: 
            upkeepModifier: 1.0
            namePostfix: ' (Nation)'
            kingPrefix: 'Duke '
            townBlockLimitBonus: 20
            namePrefix: 'Dominion of '
            numResidents: 20
            capitalPrefix: 
            kingPostfix: 
            nationTownUpkeepModifier: 1.0
  • These are read as follows:
  • capitolPostfix: ” – This is added to the end of the capital city of the nation.
  • upkeepModifier: 1.0 – Use a higher multiplier to increase the upkeep as nations get more residents (unless you use town_plotbased_upkeep:true in which case it is based off of plot-count rather than resident-count.)
  • namePostfix: ‘ (Nation)’ – This is added to the end of the nation name.
  • kingPrefix: ‘Count ‘ – This is added to the front of the nation-leader.
  • townBlockLimitBonus: 10 – This is the number of bonus townblocks given to a town when they join a nation.
  • namePrefix: ‘Federation of ‘ – This is added to the front of the nation name.
  • numResidents: 10 – This is how many residents a nation must have to receive the prefixes and postfixes of the nation level.
  • capitalPrefix: ” – This is added to the front of the capital city of the nation.
  • kingPostfix: ” – This is added to the end of the nation-leader’s name.
  • nationTownUpkeepModifier: 1.0 – Joining a nation will lower/raise how much town upkeep your town pays. This multiplier is calculated after all other multipliers have their effect on the town upkeep cost. When set at 1.0, there is no :*change to upkeep.

How Towns Grow

Starting a Town
Mayors start towns using the command /town new {townname}. The townblock they are standing in will be the home block for the town, the exact spot/position will be the spawn point for the town.
More townblocks can be claimed using /town claim. These townblocks need to be directly adjacent to already claimed townblocks.
Joining Towns
There are two ways to join towns, the first is by being invited by a Mayor or a Town assistant. The second it by joining an open town.
Mayors and assistants can add players to their town with the command /town add {playername}. If the server has Questioner.jar and using_questioner: true in the Towny config.yml then the player will receive a prompt to either /accept or /deny the invitation.
Mayors can set their towns to open using /town toggle open. A player who isn’t in a town already can use the command /town join {townname} to join open towns.
When residents join towns they increase the number of townblocks accessible to the mayor for claiming.

Plot System of Land Ownership

Town Blocks
Towny provides a server admin a hands-off approach to block-protection. Block protection is broken down into plots of land, called townblocks, which by default are 16x16x128 (the full height of the world.)
Townblocks are claimed by town mayors who can then sell/give individual plots to their town’s residents.
Town Block Size
You change the townblock size in config.yml at town_block_size: 16. Changing this value is suggested only when you first install Towny.
Doing so after entering data will shift things unwantedly. Using smaller value will allow higher precision,at the cost of more work setting up. Also, extremely small values will render the caching done useless.
Each cell is (town_block_size x town_block_size x 128) in size, with 128 being from bedrock to clouds.