Towny

什么是Towny（简介）

Towny的基础取决于世界如何被分割成块。
Minecraft 服务器被分成 16x16x384 的块部分。384 是从基岩地板到天空中的云层的高度，因此Towny忽略高度并专注于 x 和 z 平面。网格方块的默认大小为 16x16，类似于块大小。因此，声明一个城镇街区Towny将采取块大小来进行取样。在这里，通过游戏内按F3+G可换出关于MC区块显示的调试功能，以便分析你能够通过Towny获得哪个区块的许可。

Towny Wiki

该Wiki翻译并基于 Towny Wiki ，若有错误请及时指出改正

• Wiki完善过程中将不定期重启服务器以测试插件

  层次结构

  游牧民族

  游牧民族是未加入任何城镇的玩家。他们没有固定领地，其权限节点可通过TownyPerms.yml配置。若在Townyperms.yml中开启权限，游牧民族可购买大使馆地块，并默认拥有权限节点towny.command.plot.claimtowny.townless。

  居民

  每个加入服务器的玩家均可成为城镇居民（默认在townyperms.yml的游牧民族部分授予towny.town.resident权限节点）。通过/resident命令可查看居民状态界面，显示金钱、所属城镇、拥有地块及好友。居民可加入现有城镇或创建自己的城镇。

  配置自动加入城镇

  在config.yml中设置 default_town_name: '城镇名'，以使新玩家首次登录时自动加入指定城镇。

  权限与地块

• 居民可购买镇长挂牌出售的地块。
• 拥有地块的居民会在地块详情中看到默认权限设置。

• 居民权限由TownyPerms.yml中towns.default部分配置。

  城镇

  城镇是由居民（至少1人）组成的群体，由一名市长管理。城镇拥有金库，可设置税收、扩展领地，并可通过/t new {城镇名}创建。

  核心功能

• 地块扩展：城镇从“家园地块”（创建时市长所在位置）向外扩展，需相邻地块或使用/t claim outpost建立前哨。
• 居民上限：在config.yml中通过global_town_settings.max_residents_per_town设置，默认无限制。
• 出售城镇：自Towny 0.99.6.0起，使用/t forsale [$金额]挂牌出售，玩家用/t buytown [城镇名]购买，通过/t notforsale取消出售。

• 查看城镇列表：使用/town list。

  元数据支持（Towny 0.95.1.0+）：可为城镇存储元数据（详见图文指南）。

  市长

  市长负责城镇管理，权限由TownyPerms.yml配置。可执行以下操作：

• 为居民分配头衔（如管理员或自定义等级），使用/town ranklist查看可用等级，/town rank {add|remove} {玩家名} {等级名}调整。
• 设定城镇税收及税率。

• 管理多个城镇（需管理员权限）：
  创建NPC城镇：/ta town new {城镇名} npc
  设置NPC市长：/townyadmin set mayor {城镇名} npc
  添加居民至NPC城镇：/ta town {城镇名} add {玩家名}

  头衔设置（Towny 0.95.1.0+）:

  /town set title {玩家名} 头衔内容
  /town set surname {玩家名} 后缀内容

  逃犯

  基础机制

  自 Towny 0.92.0.0 起，城镇（默认由市长或特定职位成员）可标记其他玩家为逃犯。逃犯可以是任何玩家（无论是否隶属于城镇或国家）。

  操作指令：

  /town outlaw [add/remove] [玩家名]
  权限节点：towny.command.town.outlaw

  生效规则

• 成员驱逐：若被标记玩家属于本城镇，会被立即驱逐。
• 开放城镇限制：设为「开放加入」的城镇（通过/town join自由加入）可利用逃犯名单阻止目标自由加入。

• 公开城镇传送封锁：逃犯无法传送至公开城镇的出生点（若被目标城镇标记）。

  玩家提示

• 进入警告：逃犯进入标记其身份的城镇时，会收到屏幕中央的警告提示。

• 在线通知：玩家被设为逃犯时若在线，会在聊天栏收到通知。

  入狱机制

  逃犯在标记城镇内死亡时，可被监禁（需满足以下条件）：

• 启用 config.yml 中的 jail.is_jailing_attacking_outlaws: true。
• 执行击杀的玩家需拥有权限节点 towny.outlaw.jailer（默认仅市长、助理、Sheriff）。

• 城镇需拥有至少一个监狱地块（Jail Plot）。

  逃犯名单查询

• 查本城镇：/town outlawlist
• 查任意城镇：/town outlawlist {城镇名}

• 查个人状态：/res outlawlist [玩家名]（省略玩家名则查询自身）

  传送驱逐（Towny 0.96.4.0+）

  功能设定：

• 禁止逃犯进入标记城镇（默认允许）：将 allow_outlaws_to_enter_town: false 加入 config.yml。

• 传送延迟：通过 outlaw_teleport_warmup 设置时间（0 秒为瞬移，单位：秒）。

  场景示例：

  outlaw_teleport_warmup: 5 时，逃犯进入后 5 秒强制传送离开。

  国家

  国家由多个城镇（或单个城镇）组成，首都城镇的市长即为国家领袖。国家可参与战争、结盟、征税，并拥有独立金库。

  核心机制

  同盟与限制：

• 同盟需双向确认（默认关闭，通过war.disallow_one_way_alliance: true启用）。

• 可设置最小居民数限制以创建或加入国家（详见config.yml的Global Town Settings）。

  国家传送点：

• 使用/nation spawn传送（若国家设为“公开”，非敌对方可访问）。

• 配置global_nation_settings.capital_spawn: true强制将传送点设于首都。

  邻近限制（Towny 0.100.1.0+）：

• 在config.yml的Global Nation Settings中设置城镇与首都或同盟城镇的最大距离限制。

  制裁城镇（Towny 0.100.1.0+）：

• 阻止目标城镇加入本国或使用国家传送：/nation sanctiontown [城镇名]

  区域控制（NationZone）

  启用条件：

• 配置global_nation_settings.nationzone.enable: true。

• 国家领土外围区域，仅本国成员可建造/破坏。

  操作指令：

• 市长开关国家区域：/t toggle nationzone
• 管理员调整大小：/ta town set nationzoneoverride #

• 战争期间自动关闭：global_nation_settings.nationzone.war_disables: true

  扩展机制：

• 国家人口增长可扩大区域范围（配置NationLevels）。

• 首都额外加成：配置global_nation_settings.nationzone.capital_bonus开启。

  附属规则：

• 无国家城镇的人口上限：global_town_settings.maximum_number_residents_without_nation（默认0无限制）。

  国家领导人

  国家领导人即首都城镇的市长，由国家成员城镇组成的最高管理者，其权限通过 TownyPerms.yml 配置。

  权限与等级管理

  居民等级分配：

• 查看可用等级：/nation ranklist

• 调整玩家等级：/nation rank {add|remove} {玩家名} {等级名}
  （支持自定义等级，例：银行家、邀请官等，由管理员在 townyperms.yml 预设。）

  特性：

• 一个玩家可拥有多个等级，便于职责细分。

• 默认包含「国家助理（Nation Assistant）」等级。

  头衔与后缀设置

  国家领导人可为境内所有城镇居民设置前缀（头衔）和后缀

  指令格式：

  /nation set title {玩家名} 头衔内容
  /nation set surname {玩家名} 后缀内容

  重置方法：

  留空指令末尾内容（例：/nation set title Steve 重置为无头衔）。

  操作示例

• 设置头衔：
  /nation set title Alex [联邦骑士] → 显示为 [联邦骑士] Alex
• 设置后缀：
  /nation set surname Bob (荣耀公民) → 显示为 Bob (荣耀公民)

• 清空后缀：
  /nation set surname Bob → 恢复为 Bob

  配置市长与国家领导人头衔、城镇及国家名称

  Towny 允许自定义市长、国家领导人、城镇、首都及国家的命名格式，通过编辑 config.yml 中的以下两个模块实现：

  城镇等级系统（town_level）

  根据城镇人口数量动态调整城镇名称、市长前缀/后缀，并配置地块数、维护费用等属性。
  详细参数参考前文 town_level配置说明 。

  国家等级系统（nation_level）

  根据国家人口（或城镇数量）动态调整国家名称、领导人前缀/后缀、首都名称格式及国家加成效果。
  详细参数参考前文 nation_level配置说明 。

  注意事项：

• 修改后需重启服务器或重载 Towny 配置（/ta reload）生效。
• 预留空值（如 namePrefix: ''）表示不使用前缀/后缀。

• 关键词 {townname}, {nationname} 等将自动替换为实际名称。

  配置城镇等级（town_level）与国家等级（nation_level）

  城镇等级（town_level）配置

  在 config.yml 中通过以下结构定义城镇等级规则（按居民数分级）：
  

  town_level:

  
  numResidents: 1
  namePrefix: ''
  namePostfix: ' (Settlement)'
  mayorPrefix: 'Hermit '
  mayorPostfix: ''
  townBlockBuyBonusLimit: 0
  townBlockLimit: 16
  upkeepModifier: 1.0
  townOutpostLimit: 0
  debtCapModifier: 1.0
  peacefulCostMultiplier: 1.0
  bankCapModifier: 1.0
  resourceProductionModifier: 1.0
  townBlockTypeLimits:

  • shop: 2

  • arena: 2

  参数解析：

  变量名称	描述	依赖配置项（需启用）
  numResidents	触发此等级的最低居民数量。	无
  namePrefix/namePostfix	城镇名称前/后缀（例：Townname (Settlement)）。	无
  mayorPrefix/mayorPostfix	市长名称前/后缀（例：Hermit MayorName）。	无
  townBlockBuyBonusLimit	使用 /town buy bonus 可购买的额外地块数上限。	town.max_purchased_blocks_uses_town_levels: true
  townBlockLimit	城镇可拥有的总地块数（覆盖 config.yml 的 town_block_ratio）。	town_block_ratio: '0'
  upkeepModifier	维护费倍数（居民增时费用提高，若配置 town_plotbased_upkeep: true 则以地块数计算）。	town_plotbased_upkeep_affected_by_town_level_modifier: true
  townOutpostLimit	可创建的前哨站数量。	limit_outposts_using_town_and_nation_levels: true
  debtCapModifier	债务上限倍数（结合 debt_cap.override 计算实际值，如 1.0 x 1000 = 1000）。	debt_cap_uses_town_levels: true
  peacefulCostMultiplier	城镇维持中立的费用倍数（乘以 economy.price_town_neutrality）。	无
  resourceProductionModifier	资源产出倍数（与插件 TownyResources 联动）。	需安装 TownyResources 插件
  bankCapModifier	银行存储上限倍数（乘以 economy.banks.town_bank_cap）。	无
  townBlockTypeLimits	限制某类地块的最大数量（例：shop:2 表示商店地块最多2个）。	无

  配置示例：

这个细致的系统允许玩家在游戏世界中以非常具有灵活性和战略性的方式管理和拥有土地，提供了多样化的玩法体验。

地块组管理（Plot Groups）

核心机制

地块组（Plot Groups）是一组具有相同属性（权限、类型、所有者）的地块，可作为一个整体进行操作（买卖、权限批量设置）。

操作命令

示例流程：

• 创建组并添加地块：
  /plot group add Downtown
• 开启持续添加模式：
  /res toggle plotgroup

• 行走至待添加地块自动入组，结束时关闭模式：
  /res toggle plotgroup

  注意事项

  权限依赖：

• 玩家需拥有 towny.command.plot.group 权限才能操作地块组。

  连续地块限制：

• 地块组成员无需严格相邻，但非连续地块可能影响功能性（如合并销售的实际效果）。

  行政区划分（Districts）

  核心机制

  行政区（Districts）是逻辑上的区域标记，用于命名城镇内的某个片区（如“商业区”、“住宅区”），允许内在地块属性差异（不同权限、所有者）。

  操作指令

  命令	功能描述	要求/限制
  /town district add {区名}	创建新行政区，包含相连的当前地块。	地块必须连续且未被划分
  /town district remove {区名}	删除指定行政区，地块恢复为普通地块状态。	仅市长或助理可操作
  /townymap	查看地图时，悬浮提示显示行政区名称。	无特殊限制

  功能优势

  标识性：

• 地图显示 (/towny map) 中标注行政区名称，提升区域辨识度（适用于建立「港口」、「工业区」等）。

  灵活性：

• 各地块权限和类型可独立设置，适合复杂城镇布局需求。

  限制条件

  物理联系：

• 行政区内所有地块必须互相连续，形如一个整体区域。

  名称唯一性：

• 同一城镇内不可重复命名行政区。