Waypoints
Use the links above to navigate amongst the modules of waypoints
Waypoints
A Minecraft Plugin
Source code available at Sessional's GitHub Repository
Overview
Waypoints is a Minecraft mod to aid in the rapid traversing of large spread out worlds. It is designed to run easily with a large assortments of other plugins in the fact that each local command runs under the same command, for example ‘/waypoints go’ to execute a go command. This will prevent most and hopefully all command interferences with a wide array of plugins.
History
Development of waypoints started a little while after I began to play Minecraft. I found I had a tendency to wander far away from every other player, including my friends. While this was awesome at first, it eventually became tedious to meet up and share items with other people. The server I played on had access to a teleport command, but this command was long with requiring both names. I have nothing against the command, aside from the fact that 12 character names are annoying to type correctly often. I began building in my own little place and found that while it was great, for people to come visit me and see what I had built was a chore. This was mirrored in me visiting them to see what they had. Thus, waypoints was thought out.
Waypoints had to be designed to work with the “Permissions” mod, but to test it on my local environment it had to work with no permissions because I didn’t quite understand how to modify them. Simply, the plugin just confused me. I had to save it in a format that would be easy to fix because I didn’t quite know what bugs I was going to run into and there was a large chance I might have to hand fix the save files. Writing the code for the config file was largely clumped out of the tutorial on the wiki, and it worked, so why change it.
Philosophy
Waypoints is developed to meet players desires to make certain aspects of Minecraft that some may find undesirable such as trekking to and from friends houses in large, spread out, worlds less time consuming. As a mod developer and an avid gamer, I understand that what I want isn’t always what most people want and as such, suggestions are welcome, certain ones may not be added quickly, and I do apologize, but it becomes difficult to modify not well thought out code. As I write code I find myself rewriting it a lot because of poor planning. This comes largely from being self taught and impatient. Fixing and working around bugs is important to make sure that the user experience isn’t a nightmare which certainly may happen with updates. Testing is not always easy on a local server by a single user.Player Commands
Player commands all begin with “/waypoints” or “/wps” to avoid conflicts with other plugins and because of this it can get tedious, but I feel the gain is more important than the possible negative interaction with commands.
Go
Supported in 2.0
Parameters in <> are required.Parameters in [] are optional.
A parameter split with a | is an alias, either one can be used (but only one at a time)
Commands
/wps go <name>Permissions
/waypoints go <name>
waypoints.goExamples
/wps go home
Teleports the player to the waypoint called home
Return
Supported in 2.0
Parameters in <> are required.
Parameters in [] are optional.
A parameter split with a | is an alias, either one can be used (but only one at a time)
Commands
/wps returnPermissions
/waypoints return
waypoints.returnExamples
/wps return
Teleports the player to location before the last go command
Create
Supported in 2.0
Parameters in <> are required.
Parameters in [] are optional.
A parameter split with a | is an alias, either one can be used (but only one at a time)
Commands
/wps <add|create> <name> [world] [x] [y] [z]Permissions
/waypoints <add|create> <name> [world] [x] [y] [z]
Any of the following permissions will allow the use of this commandExamples
waypoints.add
waypoints.create
/wps add home
Creates a waypoint called home at current location
/wps create home homeWorld 0 0 0
Creates a waypoint called home at x:0 y:0 z:0
Delete
Supported in 2.0
Parameters in <> are required.
Parameters in [] are optional.
A parameter split with a | is an alias, either one can be used (but only one at a time)
Commands
/wps <delete|remove> <name>Permissions
/waypoints <delete|remove> <name>
Any of the following permissions will allow the use of this commandExamples
waypoints.delete
waypoints.remove
/wps delete home
Deletes the waypoint called home
/wps remove home
Deletes the waypoint called home
List
Supported in 2.0
Parameters in <> are required.Parameters in [] are optional.
A parameter split with a | is an alias, either one can be used (but only one at a time)
Commands
/wps list [world <world name> |page <#>]Permissions
/waypoints list [world <world name> |page <#>]
waypoints.listExamples
/wps list
Lists all waypoints that exist
/wps list world homeworld
Lists all waypoints that exist on the world homeworld
/wps list page 2
Lists waypoints in a page format starting on page two
Update
Supported in 2.4
Parameters in <> are required.Parameters in [] are optional.
A parameter split with a | is an alias, either one can be used (but only one at a time)
Commands
/wps <update|set> <waypointName> <cost>Permissions
/wps <update|set> <waypointName> <worldName> <x> <y> <z>
/wps <update|set> <waypointName> <worldName> <x> <y> <z> <cost>
waypoints.setExamples
waypoints.update
/wps set home 2
Sets the cost of teleporting home to be 2 levels by default
Console Commands
Create
Supported in 2.1
Waypoints^^1^^ create(add)^^2^^ <waypoint name>^^3^^ <world> <x> <y> <z>
Usage: waypoints create aaa
Notes: Will create a waypoint at the given location. Waypoints are saved upon creation of a new one.
Delete
Supported in 2.1
waypoints delete(remove) < waypoint name>
Usage: waypoints delete aaa
Notes: Deletes the waypoint aaa from the list of waypoints. Waypoints is saved immediately upon deletion.
List
Supported in 2.1
waypoints list [page] [#]
waypoints list [world] [world name]
Usage: waypoints list
waypoints list page 1
waypoints list world world
Notes: Will list the waypoints you specified. If you use page it will list waypoints (9*page number - 1) through (9*page number).if you use world it will list all waypoints on the given world.
Sick i love this plugin
Thanks. :)
If there is anything else you'd like to see implemented let me know!
@13rjverhe
As far as I'm aware it is still working.
Do you have a list of mods you are using? I'm not sure what this "manload" thing is, nothing I've worked with as far as I know.
does this plugin not work with CraftBukkit 1.4.7? I keep getting an error: "All commands are locked due to an internal error. Check the Log and then try a /manuload"
I checked the log, and didn't understand it one bit.
I looked in my cmd window, and all i see is
"23:08:54 [WARNING] Unexpected exception while parsing console command "manload"
org.bukkit.command.CommandException Unhandled exception executing command 'manl
oad' in plugin GroupManager v2.0 (2.10.1) (Phoenix)"
when i try to do a manload
Any help is much appreciated.
@slugsshell
A countdown? What for?
Would you like there to be a delay in the teleportation?
Wow thanks for this great plugin!
Can you please add a countdown being printed in chat and (321..) cool-down option to all teleporter commands.
Thanks,
slugsshell
Thx man i apperciate it :) (im a bad speller :P)
@MeAlnamerFamily
Sorry about the slow responses.
In the config.yml which is located in /plugins/Waypoints/config.yml set bukkit permissions to true and it should begin to work the way you desire!
Also, if it's not loading properly this file will not show up, which is what I was experiencing, I have updated this file to allow it to remain loading. Let me know about anything else you have that you need help with.
The plugin permissions node is default even if i try adding - before the permission it still lets them use it???
@MeAlnamerFamily
Yes. There is permissions nodes - to enable the use for only your staff make sure to assign the permissions node to the specified player.
I don't have an example of how to apply a permission using a file, but the permissions nodes are listed under the Player Commands section.
5.* contains each command the player can use, these are the permissions nodes to apply for your staff players.
I want the waypoints for only my staff to use is there anyway i can do it
@dakaratekid11
This sounds to me like you client never finished syncing up. If you relog this problem should fix. Also - after waiting for a bit it should fix too, the duration it will take to sync depends upon your server hardware and the connection between you and it.
If this doesn't work, let me know and we can work on figuring it out.
@Sessional
Hi,
After teleporting around a few times I turned invisible completely to myself. Although others could still see me, I couldnt see them, only their name.
Please Help
dakaratekid11
@BodhiBob As far as I'm aware it is still working. The server that I play on still uses it and functions.
Still working?
Oh my gosh. This is A MUST HAVE FOR ANY SERVER. Thank you so much. Keep up the great work.
@Sessional
Sessional... I CAN post the feedback here, but I'd much rather just give you crap when you hop in TeamSpeak. ;-) Keep up the great work, you know we love the plugin. :-)
Very Nice Plugin Keep up the good work.
I would love some feedback! I am attempting to get this working with the latest builds of craftbukkit and may be breaking things! Let me know about any problems and ill work with ya to solve them!
I would really appreciate some feed back, and even some error messages if you have them. I'm struggling to get this thing working with the latest bukkit dev builds and need your help to pin down the problems. If you have any errors please do let me know so I can get them fixed for you asap.