Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!

TownyWaypoints

Configurable plot types for Towny that players can teleport between.

TownyWaypoints

townywaypoints

Configurable plot types for Towny that players can teleport between.
Requires Paper or a fork of it. Supports Folia. It will not work on Bukkit or Spigot.

Traveling

Players can travel between different waypoints with /twp travel <town> <waypoint> <plot name>
When 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.

Config

Default config:

# This is the current version. Please do not edit.
version: '1.4'
# The language file you wish to use.
language: en_US.yml

waypoints:

  ############################################################
  # +------------------------------------------------------+ #
  # |                       Economy                        | #
  # +------------------------------------------------------+ #
  ############################################################

  economy:

    # 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.
    # Disabled with value of -1
    split: '0.5'

  ############################################################
  # +------------------------------------------------------+ #
  # |                   Restrictions                       | #
  # +------------------------------------------------------+ #
  ############################################################

  restrictions:

    # The maximum number of blocks a player can travel between waypoints.
    # Disabled with value of -1
    max_distance: '2700'

    # The amount of seconds a player must wait between waypoint travels.
    cooldown: '300'

    # If true players can only teleport from one waypoint type to another.
    peer_to_peer: 'true'

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.
waypoints.restrictions.cooldown is the amount of time in seconds a player must way between waypoint travels.
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.

The `waypoints.yml` file

In waypoints.yml you define different types of waypoints.

stable:
  name: "stable"
  mapKey: 'S' # A single character to be shown on the /towny map and /towny map hud.
  cost: 4500.0 # Cost to create the waypoint.
  travel_cost: 450 # Cost to travel to waypoint.
  max: 1 # Max number of plots of this type allowed per town.
  travel_with_vehicle: true # If true, player's vehicle will travel with the player.
  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
  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.
    - FOREST
    - PLAINS
    - SUNFLOWER_PLAINS
    - TAIGA
    - BIRCH_FOREST
    - SAVANNA
    - WINDSWEPT_FOREST
    - WINDSWEPT_SAVANNA
    - FLOWER_FOREST
seaport:
  name: "seaport"
  mapKey: 'P' # A single character to be shown on the /towny map and /towny map hud.
  cost: 2500.0 # Cost to create the waypoint.
  travel_cost: 250 # Cost to travel to waypoint.
  max: 1 # Max number of plots of this type allowed per town.
  travel_with_vehicle: false # If true, player's vehicle will travel with the player.
  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
  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.
    - COLD_OCEAN
    - DEEP_COLD_OCEAN
    - DEEP_OCEAN
    - LUKEWARM_OCEAN
    - OCEAN
    - WARM_OCEAN

A waypoints.yml like this means two plot types will be available to players, stables and seaports.

Stables

Have a map key of S
Cost $4500 to create
Cost $450 to travel to
Are limited to 2 per town
Can be created only by players with the townywaypoints.landpoint.stable permission
Can be created in most land biomes

Seaports

Have a map key of P
Cost $2500 to create
Cost $250 to travel to
Are limited to 2 per town
Can be created by all players
Can only be created in beach and ocean biomes

A player designates a plot as a waypoint by doing /plot set <waypoint type name>.
They can change things about the waypoint with /twp set <open> [value].
Waypoints travel can be open to everyone or limited to allies, nation members, town members, or noone (closed) with /twp set open <status>.
The 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.

Permission nodes

townywaypoints.admin Allows use of the reload command and disables all permission checks.
Towny's towny.command.town.set.spawn permission node is needed for a player to set the spawn of a waypoint.
Towny's towny.command.town.toggle.public permission node is needed for a player to set the open status of a waypoint.