# TownyWaypoints
可配置的城镇类型，供玩家在城镇之间传送。
需要 [Paper](https://github.com/PaperMC/Paper) 或其衍生版本。支持 [Folia](https://github.com/PaperMC/Folia)。 不适用于 Bukkit 或 Spigot。
### 传送
玩家可以使用 `/twp travel <城镇> <航点> <地块名称>` 在不同的航点之间传送。
传送时会使用城镇的预热机制，因此如果在城镇中设置了传送预热 / 移动或伤害取消，这些预热机制将在玩家尝试传送至航点时生效。
---
### 配置
默认配置：
```yaml
# 这是当前版本。请勿编辑。
version: '1.9'
# 您希望使用的语言文件。
language: en_US.yml
waypoints:
############################################################
# +------------------------------------------------------+ #
# | 经济 | #
# +------------------------------------------------------+ #
############################################################
economy:
# 将旅行成本中添加到城镇银行的百分比，剩余部分将转入国家。 如果没有国家，则100%转入城镇银行。
# 使用-1的值禁用
split: '0.5'
############################################################
# +------------------------------------------------------+ #
# | 限制 | #
# +------------------------------------------------------+ #
############################################################
restrictions:
# 玩家可以在航点之间旅行的最大块数。
# 使用-1的值禁用
max_distance: '2700'
# 玩家必须在航点旅行之间等待的最长时间（秒）。
cooldown: '300'
# 如果为真，玩家只能从同一种类型的航点传送至另一种类型的航点。 即，如果想传送至另一个稳定的航点，必须站在一个稳定的地块上。
peer_to_peer: 'true'
```
- `waypoints.restrictions.max_distance` 是玩家可以通过航点旅行的最大块数。玩家不可以传送至距离他们当前位置 `max_distance` 块以外的航点。
- `waypoints.restrictions.cooldown` 是玩家在航点旅行之间必须等待的时间（秒）。
- `waypoints.restrictions.peer_to_peer` 如果设置为 true，则意味着玩家必须站在相同类型的航点上才能传送至另一个航点，也就是说，如果我想传送至另一个稳定的航点，我必须站在一个稳定的地块上。
---
### `waypoints.yml` 文件
在 `waypoints.yml` 中，您可以定义不同类型的航点。
```yaml
stable:
name: "stable"
mapKey: 'S' # 在 /towny map 和 /towny map hud 上显示的单个字符。
cost: 4500.0 # 创建航点的成本。
travel_cost: 450 # 传送至航点的成本。
max: 1 # 每个城镇允许的此类类型的最大地块数。
travel_with_vehicle: true # 如果为真，玩家的载具将与玩家一起传送。
permission: townywaypoints.landpoint.stable # 设置地块为这种航点类型的所需的权限节点，如果没有设置权限，任何人都可创建此航点，请在 townyperms.yml 中授予。
# 玩家可以在航点之间旅行的最大块数。
# 如果为 -1，则使用全局值
max_distance: -1
allowed_biome_tags: # 此地块可以创建的生物群系标签列表。 优先于 allowed_biomes。
- minecraft:is_overworld
allowed_biomes: # 此地块类型可以创建的生物群系列表。 如果未提供，则该地块类型可以创建于任何生物群系。
- FOREST
- PLAINS
- SUNFLOWER_PLAINS
- TAIGA
- BIRCH_FOREST
- SAVANNA
- WINDSWEPT_FOREST
- WINDSWEPT_SAVANNA
- FLOWER_FOREST
seaport:
name: "seaport"
mapKey: 'P' # 在 /towny map 和 /towny map hud 上显示的单个字符。
cost: 2500.0 # 创建航点的成本。
travel_cost: 250 # 传送至航点的成本。
max: 1 # 每个城镇允许的此类类型的最大地块数。
travel_with_vehicle: false # 如果为真，玩家的载具将与玩家一起传送。
permission: townywaypoints.seapoint.seaport # 设置地块为这种航点类型的所需的权限节点，如果没有设置权限，任何人都可创建此航点，请在 townyperms.yml 中授予。
# 玩家可以在航点之间旅行的最大块数。
# 如果为 -1，则使用全局值
max_distance: 6000
allowed_biome_tags: # 此地块可以创建的生物群系标签列表。 优先于 allowed_biomes。
- minecraft:is_beach
allowed_biomes: # 此地块类型可以创建的生物群系列表。 如果未提供，则该地块类型可以创建于任何生物群系。
- COLD_OCEAN
- DEEP_COLD_OCEAN
- DEEP_OCEAN
- LUKEWARM_OCEAN
- OCEAN
- WARM_OCEAN
```
一个像这样的 `waypoints.yml` 文件意味着两种地块类型可供玩家使用，即稳定型和海港。
稳定型航点
- 地图标识符为 `S`
- 创建成本为 $4500
- 传送成本为 $450
- 每个城镇限制为 2 个
- 仅由具有 `townywaypoints.landpoint.stable` 权限的玩家可创建
- 可以在大多数陆地生物群系中创建
- 使用配置文件中的 2700 的最大距离
海港型航点
- 地图标识符为 `P`
- 创建成本为 $2500
- 传送成本为 $250
- 每个城镇限制为 2 个
- 所有人都可以创建
- 只能在海滩和海洋生物群系中创建
- 具有独立的 6000 最大距离，与配置文件中的不同
玩家可以通过执行 `/plot set <航点类型名称>` 将地块指定为航点。
他们可以使用 `/twp set open [值]` 更改航点上的事情。
可以使用 `/twp set open <状态>` 将航点旅行设置为对所有人开放或仅限于盟友、国家成员、城镇成员或无人（关闭）。
可以通过 `/twp set spawn` 更改玩家在乘坐航点时传送到的方块。航点的默认生成位置是玩家指定地块为航点时所站的位置。
---
### 权限节点
- `townywaypoints.admin` 允许使用重新加载命令并禁用所有权限检查。
- 玩家设置航点生成位置需要城镇的 `towny.command.town.set.spawn` 权限节点。
- 玩家设置航点开放状态需要城镇的 `towny.command.town.toggle.public` 权限节点。
---
### 翻译
如果您想帮助将 TownyWaypoints 翻译成可用语言或添加全新的语言，[我们正在 Crowdin](https://crowdin.com/project/townywaypoints)！
[](https://crowdin.com/project/townywaypoints)
---
### 链接
- [Hangar](https://hangar.papermc.io/ewof/TownyWaypoints)
- [Modrinth](https://modrinth.com/plugin/townywaypoints)
- [Github](https://github.com/ewof/TownyWaypoints)
---
灵感来自 [TownyPorts](https://github.com/darthpeti/TownyPorts/)