FastTravelSigns

FTSign

FastTravelSigns: Simple Exploration/RPG-Friendly Warping

Source Code: Github

Mirror and dev-builds: Mirror

Tired of warp plugins that give your users access to a full range of public warp points as soon as they're given a certain permission? Want to encourage your users to explore rather than teleporting everywhere? Want to make them work a bit for their instant transportation? FastTravelSigns may be for you!

This plugin provides a means to create special [FastTravel] signs in your world, which your users may find and 'activate' by left-clicking them. At that point they may Fast Travel to them anytime. The idea here is that they have to get to a place before they may warp to it, similar to fast travelling in games like Oblivion and Skyrim (or even the Fly move in Pokemon!).

Features include:

  • Very simple setup - most extra features are optional and it works great out of the box!
  • SuperPerms/Bukkit Permissions support (Tested with PermissionsEX. See "Permissions" section below).
  • Configurable cooldown between uses, and warmup before teleporting
  • "Always on" automatic warp signs that will always be available to all players - Automatic signs are marked green on your list of available points!
  • Economy support (Requires Vault)
  • Signs are fully protected against removal by unprivileged users
  • Growing list of handy administrative abilities
  • You are now added to a sign if you enter a specific range
  • Notifies admins if an update is availabile
  • You can choose your destination in an inventory menu
  • Uses the new UUID system

Installation

You know the drill. Download FastTravel.jar and drop it into your plugins directory. If you wish to use the Economy support to charge your users for FastTravelling, also make sure you have installed Vault.

Run once to generate a default config. The config.yml contains the following options:

  • cooldown: Number of seconds between uses of FastTravel. Default is 0 (no cooldown).
  • warmup: Will make users wait this number of seconds before they are teleported. Default is 0 (no warmup).
  • economy.enabled: Enables or disables economy support. Default is false (disabled). Set to true to enable.
  • economy.default-price: Sets the default price for newly-created signs, if economy support is enabled (will be ignored otherwise). Default is 0 (free).

rmh4209 has made a handy Youtube video demonstrating installation and usage.

Usage

See the Usage page.

Permissions

The following permissions can be given to control the use of the plugin. (Default is OP access for all permissions.)

  • fasttravelsigns.use: Allows use of the /ft command to list travel points and to actually travel.
  • fasttravelsigns.multiworld: Allows fast-travelling to points located in other worlds than the one the player is currently in.
  • fasttravelsigns.create: User may create FastTravel signs (unauthorized ones are removed).
  • fasttravelsigns.remove.own: User may remove FastTravel signs they created.
  • fasttravelsigns.remove.all: User may remove all FastTravel signs, including ones they did not create.
  • fasttravelsigns.list: Use the /ftlist command to list all FastTravel signs.
  • fasttravelsigns.price: Use the /ftprice command to set the price to travel to a FastTravel point.
  • fasttravelsigns.delete: Use the /ftdelete <point> command to delete it.
  • fasttravelsigns.auto: Use the /ftauto <point> command to toggle whether or not it is "automatic", that is, "always on" and available to all players.
  • fasttravelsigns.setpoint: Use the /ftsetpoint <point> command to set an alternate teleportation point for the sign.
  • fasttravelsigns.reload: Use the /ftreload command to reload configuration and sign database.
  • fasttravelsigns.overrides.cooldown: Allows user to bypass the cooldown setting if > 0.
  • fasttravelsigns.overrides.allpoints: Allows user to teleport to every existing fast travel point, multiworld or not.
  • fasttravelsigns.overrides.price: Allows user to bypass any costs for using fast travel.
  • fasttravelsigns.overrides.warmup: Allows user to bypass the warmup setting if > 0.
  • fasttravelsigns.clear: Allows user to clear all players from a sign.
  • fasttravelsigns.remove: Allows user to remove a player from a sign.
  • fasttravelsigns.setrange: Allows user to set the range of a sign.
  • fasttravelsigns.save: Allows user to save the database.
  • fasttravelsigns.update: Update notification will be shown on login.
  • fasttravelsigns.menu: Allows the use of inventory menus /ftmenu.

Known Issues

  • There is no way to move a FastTravel sign itself without removing it at the moment. You may set an alternative teleport point using /ftsetpoint, however.
  • Removing the block underneath or attached to a sign may result in the sign floating in midair.
  • Occasionally a sign might be placed in such a way that users end up teleported to the ground below the sign. This does not have any obvious cause I can find yet. (Possibly fixed as of v0.4)
  • If the sign is placed on a wall above ground level in a room, you may end up teleported to the room (or roof) above. This is a workaround for now.

To-Do

  • Add the ability to move points
  • Customizable messages/language files
  • Better teleportation algorithm (smarter player placement on arrival)
  • Inventory menus to choose destination(since v0.9)
  • Port to Sponge once released

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of oneill011990 oneill011990 Oct 11, 2014 at 12:56 UTC - 0 likes

    @EdwinaHeron: Go

    Make sure you are op or have the permission you need (see list above, to create it's fasttravelsigns.create). Otherwise I need the server log about this error since I never had this problem before.

  • Avatar of EdwinaHeron EdwinaHeron Oct 10, 2014 at 22:25 UTC - 0 likes

    I know I'm skipping something obvious here. Would you please explain it to me like I'm a 5 yr old?

    I installed it fine on my server. I went to put my first sign down and got.

    "you do not have permission to create travel points"

    I know this is really lame, but would someone please help me out? Thanks

  • Avatar of craftycreeper craftycreeper Sep 04, 2014 at 15:00 UTC - 0 likes

    @oneill011990: Go

    For what it's worth, I no longer have interest in Bukkit development, and I endorse oneill011990's takeover of this project so long as my copyright notices are preserved in the code where appropriate.

    BFAK:freefish,70092,9ac7d121241a646181ded18d99b51e5d5ca03bde60743ccaab03e26e8a45193f

  • Avatar of oneill011990 oneill011990 Aug 22, 2014 at 21:05 UTC - 0 likes

    Forked this project and started to update it. See here for source: https://github.com/oneill011990/FastTravel

    if you want to download (for 1.7.9-R0.2) it you might want to check my Jenkins or you compile it on your own (shouldn't be to difficult with maven). DLs: http://germanspacebuild.de:8080/job/FastTravelSgins/

    This is all legit since this project is under the MIT License.

    Last edited Aug 22, 2014 by oneill011990
  • Avatar of xphoenixxx xphoenixxx Apr 09, 2014 at 11:44 UTC - 0 likes

    Phaibooty - Think it happens when you have more than a certain number of signs, like 64 or 128.. probably just the wrong integer type in the source, plugin otherwise still seems to work under 1.7*

  • Avatar of Phaibooty Phaibooty Oct 07, 2013 at 18:48 UTC - 0 likes

    Getting issues in 1.6.4 signs reset? or just disappear?

  • Avatar of xphoenixxx xphoenixxx Aug 19, 2013 at 02:55 UTC - 0 likes

    FYI - everyone, this still works on 1.6.2.

  • Avatar of xphoenixxx xphoenixxx Nov 10, 2012 at 01:25 UTC - 0 likes

    I did find 1 other glitch as a side effect of all the multiverse wierdness from update -
    if a world is delayed from loading for any reason, for instance a buggy generator engine (*cough* terrain *cough* control *cough*) - it seems to de-link all the fast travel points on that world, requiring them to be re-created.

    Frankly I can't think of anyway to fix that, short of a persistent sign database per world, and that means console errors if someone tries to travel to an offline world. *shrug* most of my navigation plugins bar essentials warp have a similar issue.

    I suppose you could have a database that only writes their coords, but doesnt actually use them.. that means at least an admin can look up and /tppos back there to redo the sign.

    Or at the very least set it so that a previously created sign, even if de-linked reactivates if you right click it, saving the need to break/recreate

    Oh I almost forgot - is there a way to display extra pages of known points?  we have more than a page of them at the moment, and i think i am not seeing some?

    All good otherwise.  Even the long distance warp issue seems to have improved slightly after a few bukkit dev updates.

    Last edited Nov 10, 2012 by xphoenixxx
  • Avatar of craftycreeper craftycreeper Nov 08, 2012 at 21:34 UTC - 0 likes

    @gabriel11798: Go

    I avoided this for a reason - doing this would require a hook into player movement events, which are much more costly to your server speed than click events. I want to keep this plugin as light on server load as possible. But thanks for the suggestion!

  • Avatar of craftycreeper craftycreeper Nov 08, 2012 at 20:45 UTC - 0 likes

    @xphoenixxx: Go

    Thanks for the update. This might actually be the real solution to the weird teleportation problem. If I get time/motivation I'll see about adding a fix for that.

Facts

Date created
Aug 27, 2011
Categories
Last update
Dec 19, 2014
Development stage
Release
Language
  • enUS
License
MIT License
Curse link
FastTravelSigns
Downloads
6,160
Recent files

Authors

Relationships

Optional dependency
Vault