Sueta

HorseTravel | An RPG Fast-Travel

1.3.1

Fast-Travel system with an RPG feel

·Plugin

What is HorseTravel?
HorseTravel is a fast-travel system for servers with a medieval RPG feel.

What does it do?
The plugin provides a way for server owners to scatter TravelPoints across the map and players will be able to travel between those points on a horse. Each TravelPoint consists of two locations, a station and a teleport. Stations are basically the endpoints of a journey, where players get on and off the horses, while teleports are locations where the horse teleports to and from another location.
TL;DR Player gets on a horse, horse runs from station to teleport, teleports to destination teleport, runs to station and dismounts the player.

Features

  • Easily give ability to travel between predefined points in your server
  • Configurable blindness during travel for smoother teleport
  • Configurable colorable departure and arrival messages
  • Configurable colorable message prefix
  • Automatic update checks
  • Display TravelPoints on dynmap

How to use?
YouTube

Manual

1) Set up your TravelPoint locations. For each TravelPoint both station and teleport have to be in the same world or that point will not be loaded. Note: When departing the horse will run from station to teleport and vice-versa when arriving so those points should not be far away from eachother!
All messages support colors with "&" symbol. To disable blindness set duration to -1

# Do NOT change this value! HorseTravel will probably misparse your config!
# This does not necessarily correspond to plugin version
# -----------------
config_version: 1.3
# -----------------
# Should HorseTravel automatically check for updates
update_checks: true
horsespeed: 1.5
# Prefix for departure and arrival messages. Supports &4colors
message_prefix: ''
travelpoints:
  someplace:
    # Both worlds have to be the same
    # Format: world, x, y, z
    station: world,-200,64,61
    teleport: world,-200,64,57
    # Supports &4colors
    # Disabled if empty
    arrival_message: ''
    departure_message: ''
    # Duration: How many seconds should effect last
    # Delay: after how many seconds should blindness start
    # Effect disabled if duration: -1
    blindness:
      duration: 3
      delay: 2
  someotherplace:
    station: world,-200,64,61
    teleport: world,-200,64,57
    arrival_message: ''
    departure_message: ''
    blindness:
      duration: -1
      delay: 2

2) Set up player interaction. Currently HorseTravel is designed to only provide the function layer, while point selection was meant to be handled by other plugins, such as BossShop to provide a convenient way for owners to add their own conditions however they like.

3) Make your player-interaction use the command /horsetravel spawn <playerName> <originTravelPointID> <destinationTravelPointID>

4) Enjoy!

Permissions:

  • horsetravel.admin - Allows player use all HorseTravel commands
  • horsetravel.use - Allows player on the horse
  • horsetravel.updatenote - Notifies player upon an update

Commands:

  • /horsetravel - Main command, displays plugin version
    Aliases: [ht]
  • /ht help - Lists all available commands
    Aliases: [?]
    Client only
  • /ht help [command] - Displays info about specified command
    Client only
  • /ht list - Lists all loaded TravelPoints
    Aliases: [lst]
    Client only
  • /ht spawn <player> <origin> <destination> - Initiates travel
    Aliases: [spwn]
    Requires <player> to have permission horsetravel.use
    Console only
  • /ht travelpoint <id> - Displays info about specified TravelPoint
    Aliases: [tp, get, gettp]
    Client only
  • /ht reload - Reloads config
    Aliases: [rld]

Found bugs?
Please report them here.

Suggestions?
I'm always open to suggestions and constructive criticism. You can send suggestions as a PM or in the discussion section.

Planned features

  • Multilanguage support maybe?
  • Display TravelPoints on DynMap
  • Configurable departure messages
  • Configurable arrival messages
  • Apply blindness for a smooth transition
  • Update checker

Metrics
HorseTravel collects the following metrics:

  • Your server's randomly generated UUID
  • The amount of players on your server
  • The online mode of your server
  • The bukkit version of your server
  • The java version of your system (e.g. Java 8)
  • The name of your OS (e.g. Windows)
  • The version of your OS
  • The architecture of your OS (e.g. amd64)
  • The system cores of your OS (e.g. 8)
  • bStats-supported plugins
  • Plugin version of bStats-supported plugins

If you like this plugin then consider leaving it a rating. Seeing people enjoying HorseTravel helps me keep motivated to provide you with updates :)

Similar projects

Plugin →