# TownyWaypoints<\/p>\n
<\/p>\n
Configurable plot types for Towny that players can teleport between.
\nRequires Paper or a fork of it. Supports Folia. It will not work on Bukkit or Spigot.<\/p>\n
### Traveling<\/p>\n
Players can travel between different waypoints with `\/twp travel —<\/p>\n ### Config<\/p>\n Default config:<\/p>\n “`yaml waypoints:<\/p>\n ############################################################ economy:<\/p>\n # The percentage of the travel cost that gets added to the waypoints town bank, the rest goes to the nation. If it has no nation then 100% goes to the town bank. ############################################################ restrictions:<\/p>\n # The maximum number of blocks a player can travel between waypoints. # The amount of seconds a player must wait between waypoint travels. # If true players can only teleport from one waypoint type to another. “`<\/p>\n – `waypoints.restrictions.max_distance` is the maximum number of blocks a player can travel via waypoints. A player cannot travel to a waypoint that is `max_distance` blocks away from their current location. —<\/p>\n ### The `waypoints.yml` file<\/p>\n In `waypoints.yml` you define different types of waypoints.<\/p>\n “`yaml A `waypoints.yml` like this means two plot types will be available to players, stables and seaports.<\/p>\n Stables Seaports A player designates a plot as a waypoint by doing `\/plot set —<\/p>\n ### Permission nodes<\/p>\n – `townywaypoints.admin` Allows use of the reload command and disables all permission checks. —<\/p>\n ### Translations<\/p>\n If you’d like to help translating TownyWaypoints into the available languages or add entirely new languages, we’re on Crowdin!<\/p>\n <\/p>\n —<\/p>\n ### Links<\/p>\n – Hangar —<\/p>\n Inspired by TownyPorts<\/p>\n","protected":false},"excerpt":{"rendered":" Configurable plot types for Towny that players can teleport between.<\/p>\n","protected":false},"featured_media":158730,"template":"","meta":{"_minecraft_slug":"townywaypoints","_minecraft_project_id":"alsDiPbN","_minecraft_author":"ewof","_minecraft_license":"AGPL-3.0-only","_minecraft_downloads":770,"_minecraft_follows":7,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"townywaypoints.zip","_minecraft_size_bytes":5759771,"_minecraft_version_count":16,"_minecraft_updated_at":"2026-05-16T09:20:32.109109Z","_minecraft_date_created":"2023-07-26T01:41:54.412300Z","_minecraft_date_modified":"2026-03-12T02:47:18.484129Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/townywaypoints","_minecraft_icon_attachment_id":158730,"_minecraft_imported_at":"2026-06-09T13:52:18+00:00","_minecraft_import_hash":"7ef0255e4c44030b795a44c5d9e08569","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,844,125,89,127,869,92],"mod_loader":[131,132],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-158729","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-economy","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-transportation","mod_category-utility","mod_loader-folia","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nWhen players teleport it uses Townys warmups, so if you have a teleport warmup in Towny \/ make movement or damage cancel the warmup those will apply when players attempt to travel to waypoints.<\/p>\n
\n# This is the current version. Please do not edit.
\nversion: ‘1.9’
\n# The language file you wish to use.
\nlanguage: en_US.yml<\/p>\n
\n # +——————————————————+ #
\n # | Economy | #
\n # +——————————————————+ #
\n ############################################################<\/p>\n
\n # Disabled with value of -1
\n split: ‘0.5’<\/p>\n
\n # +——————————————————+ #
\n # | Restrictions | #
\n # +——————————————————+ #
\n ############################################################<\/p>\n
\n # Disabled with value of -1
\n max_distance: ‘2700’<\/p>\n
\n cooldown: ‘300’<\/p>\n
\n peer_to_peer: ‘true’<\/p>\n
\n– `waypoints.restrictions.cooldown` is the amount of time in seconds a player must way between waypoint travels.
\n– `waypoints.restrictions.peer_to_peer` when set to true means that players must be standing in a waypoint of the same type to teleport to another waypoint, meaning I must be standing in a stable plot if I want to travel to another stable waypoint.<\/p>\n
\nstable:
\n name: “stable”
\n mapKey: ‘S’ # A single character to be shown on the \/towny map and \/towny map hud.
\n cost: 4500.0 # Cost to create the waypoint.
\n travel_cost: 450 # Cost to travel to waypoint.
\n max: 1 # Max number of plots of this type allowed per town.
\n travel_with_vehicle: true # If true, player’s vehicle will travel with the player.
\n permission: townywaypoints.landpoint.stable # Permission node required to set a plot to a type of this waypoint, if no permission is set anyone can create this waypoint, grant it in townyperms.yml
\n # The maximum number of blocks a player can travel between waypoints.
\n # Uses the global value if -1
\n max_distance: -1
\n allowed_biome_tags: # List of biome tags this plot can be created on. Takes priority over allowed_biomes.
\n – minecraft:is_overworld
\n allowed_biomes: # List of biomes this plot type can be created on. If it’s not provided the plot type can be created on any biome.
\n – FOREST
\n – PLAINS
\n – SUNFLOWER_PLAINS
\n – TAIGA
\n – BIRCH_FOREST
\n – SAVANNA
\n – WINDSWEPT_FOREST
\n – WINDSWEPT_SAVANNA
\n – FLOWER_FOREST
\nseaport:
\n name: “seaport”
\n mapKey: ‘P’ # A single character to be shown on the \/towny map and \/towny map hud.
\n cost: 2500.0 # Cost to create the waypoint.
\n travel_cost: 250 # Cost to travel to waypoint.
\n max: 1 # Max number of plots of this type allowed per town.
\n travel_with_vehicle: false # If true, player’s vehicle will travel with the player.
\n permission: townywaypoints.seapoint.seaport # Permission node required to set a plot to a type of this waypoint, if no permission is set anyone can create this waypoint, grant it in townyperms.yml
\n # The maximum number of blocks a player can travel between waypoints.
\n # Uses the global value if -1
\n max_distance: 6000
\n allowed_biome_tags: # List of biome tags this plot can be created on. Takes priority over allowed_biomes.
\n – minecraft:is_beach
\n allowed_biomes: # List of biomes this plot type can be created on. If it’s not provided the plot type can be created on any biome.
\n – COLD_OCEAN
\n – DEEP_COLD_OCEAN
\n – DEEP_OCEAN
\n – LUKEWARM_OCEAN
\n – OCEAN
\n – WARM_OCEAN
\n“`<\/p>\n
\n– Have a map key of `S`
\n– Cost $4500 to create
\n– Cost $450 to travel to
\n– Are limited to 2 per town
\n– Can be created only by players with the `townywaypoints.landpoint.stable` permission
\n– Can be created in most land biomes
\n– Use the max distance of 2700 from config.yml<\/p>\n
\n– Have a map key of `P`
\n– Cost $2500 to create
\n– Cost $250 to travel to
\n– Are limited to 2 per town
\n– Can be created by all players
\n– Can only be created in beach and ocean biomes
\n– Have their own max distance of 6000 seperate the one in config.yml<\/p>\n
\nThey can change things about the waypoint with `\/twp set
\nWaypoints travel can be open to everyone or limited to allies, nation members, town members, or noone (closed) with `\/twp set open
\nThe block a player gets teleported to on traveling to a waypoint can be changed with `\/twp set spawn` a waypoints default spawn is where the player was standing when they designated the plot as a waypoint.<\/p>\n
\n– Towny’s `towny.command.town.set.spawn` permission node is needed for a player to set the spawn of a waypoint.
\n– Towny’s `towny.command.town.toggle.public` permission node is needed for a player to set the open status of a waypoint.<\/p>\n
\n– Modrinth
\n– Github<\/p>\n