QuickTravel
- QUICKTRAVEL - THE RPG WARP PLUGIN -
Bringing RPG/MMO inspired fast travel warp systems to Minecraft!
So intuitive and easy to use, you'll wonder how you got by without it.
Now supports iConomy 4,5,6, BOSEconomy 6&7, EssentialsEconony, 3Co, and more!
Introduction to QuickTravel
QuickTravel was created to introduce an RPG travel system long missing from Minecraft. Inspired by systems used in various well-established RPGs and MMOs, QuickTravel allows you to easily warp between preset locations - if you've discovered them already. Jam-packed with customisation options, you can allow users to warp from anywhere, to charge them to warp, to allow users to warp without having to discover the locations first, to have sound and visual FX played when a user warps, and more!
Core Features
- QuickTravel brings an RPG travel system to your server, and is inspired by RPGs and MMOs like The Elder Scrolls and World of Warcraft.
- Intuitive and easy to use! The only command your users need to remember is /qt!
- Easy to set up! QuickTravel automatically sets the default values, and automatically sets prices for warps for you based on distance! All you need to do is drop QuickTravel into your plugins folder and get going!
- Customisable! Want to set it so users can warp from anywhere, not just QT locations? No problem! Want your users to have to discover an area before they can warp there? Done! Want to only allow specific players/groups to use certain warp points? You got it! It's all doable in QuickTravel!
- Economy support through Vault! Charge your users to warp, either using our built-in price calculation feature, or by setting the prices yourself!
Quick Start Guide
- Download QuickTravel.jar and place it in your servers' plugins folder, and restart your server. A default config.yml will be generated in plugins/QuickTravel. For basic usage, you do not need to change this.
- Give yourself the qt.admin.* permission so you can start making warp locations (QTs), and then login to your Minecraft server.
- Build a platform for your first QT. You can build it out of whatever you like, so get creative!
- Stand where you want your QT to be, and type /qt create <name>, replacing <name> with the desired name for your QT. NO SPACES ALLOWED, and the name MUST contain letters (caps are fine). Numbers are allowed, so long as there are letters also.
And you're done! You have set up your first QT. Go repeat the last 2 steps to build another QT somewhere else, and you can start warping between them! Go ahead and give the permission qt.user to anyone else you want to be able to use the QTs.
This guide only shows how to set up a very basic radius QTs with default settings. For cuboid QTs or more advanced features, check the Wiki.
Configuration
Support
If you need help, you can create a ticket or post on the forum.
Downloads
Download v0.7.1 (for CB 1.2.3-R3.0)
Source @ GitHub
Known Issues
None! Found one? Create a ticket or let me know on the forum!
Planned Changes
Listed by priority:
- Add 'permissions-override' option in config.yml. When set to true, if the player has the permission for a QT, they can warp to and from it regardless of whether they have discovered it or it's enabled status. - Planned for next release.
- Add optional warm-up and cool-down timers. - Planned for next release.
- Add 'qt.free' permission. Users with the permission will not be charged to use QTs. - Planned for next release.
- Add multipliers for individual worlds, and individual warps. - Planned for next release.
- Revamp the '/qt list' command.
- Add '/qt cfg' command so that admins can update the config.yml in-game.
- Add dynmap functionality. If dynmap is running, QTs will be displayed on the map as markers. Options to enable/disable function and hide specific QTs from the map.
- Add '/qt delete' command to allow admins to delete QTs from in-game rather than having to edit the locations.yml.
Hey guys! Sorry it has been quite a while now. Hasn't it? Things have been hectic here. As some of you may be aware, QuickTravel is designed to be a part of a custom suite of a plugins I am coding from scratch to make Minecraft a more MMORPG kind of place. With that in mind, QuickTravel is the first one from this suite I started working on, to see what I could do, to show off some possibilities to the admins and players on my server, etc. Since coding version 0.7a, we've started trying to plan out the development of the plugin suite, and that means QuickTravel has been on the back-burner as of late, but fret not! I will endeavour to make sure it works with new releases of Bukkit, and as time passes the planned features and ideas will be coded in, albeit slightly more slowly than I originally planned.
Another part of the reason for this slow down in development is I am just one guy, this is my first plugin, and at times real life gets in the way, and at other times, you just need a long break from coding! It is fun for a while but it can become quite a chore when you wake up from nightmares of lines of code chasing you down a dark alley...
One question though to the users of v0.7a - how are you finding the safety checks? Do they work well? Are they tiresome? Are they not fully featured enough? Or are you simply wondering what I'm talking about when it comes to safety checks?
@leezallen At present, no there is no cooldown or warm-up system in place, as this still a Beta plugin. If you look in the Planned Changes section though, you'll see I definitely do want to implement this, as an optional feature. The idea for the QuickTravel plugin is flexibility, being able to do what you want and be used by any server admin and still get it to work in an individual way. Also, thanks for the nice feedback! How are you finding the safety checks? :)
@Storm75x I have little experience working with Towny or other plugins, although recently started having a bash at that with DynMap. I will see how feasible it is to code your request, but for the time being, the answer is 'Maybe, we'll see, eventually, perhaps.'
Is there cooldown for this.... I would like to set it so that players cannot chain teleport!!
Just want to say thankyou for a great plugin. I used to use the MemoryStone plugin before R5 and when searching for alternatives come across this...... Have been using it on my server for a few days now and have nothing but good feedback!
Can you create an add-on like this please? :) http://forums.bukkit.org/threads/quicktravel-towny.70244/
Can't find it anywhere.
Anyone looking for a build compatible with CB 1.2.5-R0.1 can download the latest v0.7a alpha build here. Be aware however that this build also includes a couple of unfinished features:
The safety checks for warps need testing and comments. In v0.7a the only checks made are for lava, falling, or suffocation. These checks are mostly an anti-grief repellent to make it so that if people attempt to grief your arrival spots, QT will protect the player. More checks to come later.
@Naterdoo
It's an interesting concept, but not something that I think can be done right now, not without writing a huge extra block of code to figure out whether you're near enemies. Currently there is no way to detect whether you're fighting or near to enemies, so this would be a massive undertaking, and may not even be possible at present.
It would be possible (and is planned) to add warm-up timers, so that once you pay for a warp it takes n amount of seconds before it actually warps you (where 'n' equals to amount of time the admin specifies), that would make it less easy to exploit QT during fights. The only other way at this time that I can think of is quite simply, if your health is below a certain amount, stop player from warping, however that would affect all players, not just ones that are fighting currently. I also do not believe most server admins would want that so it is unlikely I would add it to QT, but perhaps I'd be willing to code an add-on plugin for just that.
I could in theory spend a long time making a massive amount of code to figure out whether you're in battle and all of this kind of thing, however QuickTravel is a warp plugin, not a battle plugin, and thus will not be made to incorporate battle logistics into it, as QuickTravel is the first part of a full suite of MMORPG plugins I am building, each focusing on one core element of the MMORPG game style. If I bog down QT too much and make it too overcomplicated and handling things besides just travel/warp, it will conflict with other plugins, and not just other plugins in general, but other plugins within the suite it is designed for, and this would be a problem. However, if and when I make a plugin that focuses on battle, I will make sure to have some kind of link between it and QuickTravel to disable players from using QT when in a fight (if server admin wants it that way).
Absolutely perfect. Just what we were looking for :)
I have a suggestion. Maybe you could make it to where the players cannot use /qt when they are in battle or near enemies. I'm going to have a PvP server and I don't want people to warp when they are low on health.
EDIT: Or maybe someone can direct me to a plugin that removes commands during battle?
@evilspoons
As I said, in v0.5 when you were ops you could use it without permissions, in 0.6 I changed that, but I will consider changing it back for future versions, so whether permissions will be required or not for the final version is still to be decided. Remember this is still BETA, not a finished product :)
I personally use bPermissions, find it very easy to use, but I imagine PermissionsEx shouldn't be too problematic.
As for what permissions are required for usage and things like that, making that easy to understand for new users, again, that's still on the to-do list, for when this is ready for final release. At the moment it is still in beta development.
You could try creating one and then doing /qt cuboid -b just to find out whether it works that way rather than asking ;). You'll find it does. The reason for having a /qt cuboid -a is so you can make the point (-a) after having converted to a cuboid. It was simpler before but then it was a simpler, less customisable version of the plugin. With more features it becomes more necessary to have all the steps worked out and obvious. Also 'range' was a misnomer with how you set up cuboids before. They're really just the opposite corners of the cuboid shape. 'range' isn't really clear and was an early development term while I was still drawing up the concept.
There will at some point be a full, extremely thorough and easy to understand Wiki guide (at the moment it just covers the basic concepts, but this is still early development do not forget) that talks through absolutely all the points of QuickTravel, as well as some videos on how to set up various different travel styles on your server, to make it as clear and easy as possible. Just remember this is the early version of the plugin you're using so things will be altered from time to time, but those alterations may not be permanent, just bear with the changes as my whole aim is to get this as simple and easy to use before final release, so trying different methods to see what works best is just a part of the process :).
@evilspoons
At present, the only way to allow access to the /qt (and by association, /qt create etc) command is with permissions. I can enable ops to have access to /qt, but that means for your players to be able to use /qt, they must all be ops, and would have access to all commands. It is highly recommended instead that you use a simple permissions system like bPermissions, very easy to set up.
On next release I will consider going back to giving ops access to all QT commands. I removed this as I didn't see much call for it. As I said though, your players will need to be ops to be able to use /qt if you have no permissions system, and this is quite risky. I will see what I can do about this in future releases, perhaps I will make two command systems, one for servers with permissions and one for those without. Complicated but feasible.
So, how's everyone finding v0.6? It has changed a fair bit since the last release, and I would like to make sure that the system is easy to use and intuitive :)
Also, I've been told that v0.6 works with the dev builds for CraftBukkit 1.2.4-R0.1. I have not however tested this myself yet, and wouldn't recommend updating to a development build, but if you already have and are waiting for a version of QuickTravel that works with 1.2.4, v0.6 should work without problems.
@Naterdoo
Glad you like it, Naterdoo! v0.6 will be out soon and bring with a LOT more customisation, feature tweaks and more efficient/optimised code, so keep an eye out! :)
v0.6 is almost upon us! Just finishing up the last change to this update, and re-writing the documentation to include all the new features and changes, and it'll be done. Expect release tomorrow, or tonight if you're lucky! :)
Thanks again to all of those who have made use of QuickTravel or shown support/encouragement for it so far, as this is my first plugin I'm very happy with how well received it is by the community :)
Wow, I love this. The discovering locations is what makes this mod stand out from all the other warp plugins. This is just what I need for my server!
@toady1985
Grrrr.... lol. That feature I asked for is the last thing I need for my server... and because it's a key thing I can't create it without it. xD
Apologies for the long way for v0.6, I've been pretty busy, but have been working on it! It's nearly there, and should be ready in the next couple of days.
@IAreKyleW00t
My most recent GitHub change was a few days ago, I haven't pushed all the latest changes yet. The command structure has changed even more since then... Will push a GitHub update soon when it's complete.
@toady1985
Yeah, a lot of them would just be easier to get it done, since a few are just minor changes. I noticed your change in structure (on GitHub, if you did recently change it...?). Either you did change it, or I'm just crazy. xD I'll send you a PM telling you some other suggestions I have.. lol.
@darkmyre
As IAreKyleW00t says, it only works within the same world, HOWEVER, I am adding a feature in the next update that allows you to make all or only specific QT points work across multiple worlds, with an added 'world tax' to increase prices between worlds.
@IAreKyleW00t
Indeed, this update is taking a while because I am completely restructuring my code and making the commands a lot more flexible. Usually I just put out a release after doing a couple bits here or there, but all the changes I have planned for the next update should really be done all together. I have the feature you requested most of the way done, by the way :)
@darkmyre
It will only work within the same worlds.
Eg: If you have a Town in the Nether, you can only see that town and /qt to it if your in the Nether. Same way for normal worlds.
and @toady1985 (spelled it right this time), I can see your getting a lot done. :D For fun I tried to do the thing I suggested.... it didn't work out too well. Perhaps I should try working with something a tad easier first.. lol.