Waypoint is an easy teleportation point management and home location
management plugin. You can create teleportation points to go back to later
as well as share privately with other users. You can also create public warps that only certain groups of users can access.

Waypoint's Features:

Add/delete waypoints for later access

List all of your waypoints simply

Share your points privately with other users

Points are private, and only accessable by you, unless shared

Multiworld support

Permissions/SuperPerms/OP support with strict nodes.

Home location management

Home location is automatically set to the bed you last exited (only if enabled in config.)

Create and manage public warps

Control which groups of users can access these warps

Save/Load the spawn points for all of your worlds

Selective showing of warps (you only see what you can access.)

Teleport easily between worlds

Create and import other worlds

Create and teleportation signs to travel to warps or world spawnpoints

/wp invite <player> <point> -- send an online player an invite to your point

/wp accept <point> -- accept an invite to a point

/wp decline <point> -- decline an invite to a point

/wp list -- list of all of your points

/home -- teleport to your home

/home set -- set your current location to your home

/spawn [world] -- teleport to the world's spawn point

/spawnadmin <save|load> [world] -- save or load the spawn point of the specified world

/spawnadmin set -- set the spawn point of your current world

/warp [warpname] -- teleport to the specified warp, if you have access

/warp add <warpname> -- create a public warp with the default permissions

/warp del <warpname> -- delete a warp you own

/warp set <warpname> <owner|permission|or a custom value> <newvalue> -- set property values in the warp's metadata

/warp list -- list all warps that *YOU* have access to

/warpadmin <set|del> <warp> [key] [value]

/tp <player> [target] -- teleport to another player, or teleport one player to another.

/tphere <player> -- ejects the target from a vehicle (if applicable) and teleports that player to you.

/tploc <x,y,z> -- teleport to a set of coordinates.

/world [worldname|create|import|list] -- displays what world you are in and your current position, or if given a worldname, teleports you to that worlds spawn.

Installation and Configuration:
Download the jar file and drop it into your minecraft server's plugins/
folder and reload/restart the server. The configuration will be
automatically created for you.

Teleportation Signs:
To create a teleportation sign, you must format it like this:

Code (Text):

Line 1: [WP:WARP] or [WP:WORLD]

Line 2: world name or warp name

Line 3: (optional) description # maybe economy cost at some point soon

Line 4: (optional) description

It is case insensitive btw.

Configuration options:
'set_home_at_bed': set this to true if you want your home to be reset
whatever bed you get out of.
'autoupdate': check for updates and download upgraded jars automatically
'warp.groups': permission groups for warps
'warp.string': message sent to user after teleporting to a warp, %w is warpname, %p is playername
'limits': self-explanatory.

Permissions Nodes: (should each be self-explanatory)

waypoint.basic.add

waypoint.basic.delete

waypoint.basic.teleport

waypoint.basic.invite

waypoint.basic.invite.accept

waypoint.basic.invite.decline

waypoint.basic.list

waypoint.debug.config_node_test << debugging *ONLY*

waypoint.home -- you *must* add this if you want to be able to use home commands

waypoint.home.set

waypoint.home.set_on_bed_leave

waypoint.admin.spawn

waypoint.admin.spawn.set

waypoint.admin.spawn.save

waypoint.admin.spawn.load

waypoint.admin.warp

waypoint.admin.world.create

waypoint.admin.world.import

waypoint.teleport.teleport -- for general teleportation actions

waypoint.teleport.location -- for coordinate-based teleportation

waypoint.teleport.here -- for teleporting players to you

waypoint.spawn -- you *must* add this if you want to be able to use spawn commands

waypoint.warp -- you *must* add this if you want to be able to use warps

waypoint.world -- you *must* add this if you want to be able to use /world

Permissions Setup:Here is a sample Permissions 2.7.4 configfile with Waypoint's nodes already set up, and a user set up to give an example. Change it to your liking.

<< Thanks Pr0Failure

World Access
As of about 1.6.1, I added a few new things that implement a whole "world access" type schema of features. Players will NEVER be able to access a world unless they have the "waypoint.world.access.<worldname>" or "waypoint.world.access.*" permissions. I will add a configuration option to disable this, but for now, it's always on. If you want to effectively disable it without a config option and your permissions system supports inheritance, simply place the "waypoint.world.access.*" node at the lowest level and it should filter up through everything that inherits that or its children. I only added this because I felt it would be handy in the case of servers wanting to prevent griefing in creative worlds, but leaving whitelisting off, and just spawning all new users in the spawn world, but not letting them traverse your minecraft universe of worlds. There will be a config option to turn this off soon. By the way, if you didn't catch the gist of what I was really saying, this prevents ALL teleporting between worlds (only if you don't have the permissions for that world) no matter what you use to teleport. This catches events at a low level and checks each user's permissions as they change worlds. But enough about this.

Bugs and Errors
If you get a "An internal error has occurred" message when you use a command, * PROVIDE A TRACEBACK PLEASE. * (hint: a traceback is the error code in the server console that shows the error and its callers)
And for those of you that didn't read this text, maybe this image will catch your attention:

Split commands apart into categories (much cleaner for anyone who works through the code)

(Supposedly) Fixed NPE from LoadWorlds during plugin load.

Version 1.5:

Rewrote the configuration loader and put it in its own class

Restructured config storage

Added new warp limitations

Added an autoupdater

Version 1.4.5

Fixed warp permission loading and detection

Version 1.4.4

Fixed the internal errors spewed on /warp set

Version 1.4.1

Removed some unneeded imports

Removed some unused variables

Now using String.format in checkperms

Version 1.4

Added warp management

Restructured most of the config file formatting.

Homes-per-world (you can have one home per world now.)

Added spawn management

Added backup/restore of world spawn points

Version 1.3

Added home support

Fixed configuration node bugs

Version 1.1

Added invite support

Version 1.0

Wrote all base code

And some thanks.
Definitely got some big thanks here, especially to Pr0Failure, who been testing the crap out of this, even during its magical beta stages. And some more thanks to all of you that put up with me not being around for weeks on end due to school. And thanks to others who at one point sent in a pull request to fix something I had missed. I love you all, you're a very supportive community Also, some big thanks to Ctark who's been following this like crazy and even digging through my messy code to find nodes to help others while I'm not around Again, THANK YOU ALL <3

Seriously, or should that be a joke ? Whats that "compatibility layer plugin"?
It just doesnt work, it always says i dont have permissions but i actually have the '*' permissions so i have everything... That suck :/

Click to expand...

If you downloaded the PEX.zip there should be a jar that's just called Permissions, which is the compatibility layer that Waypoint connects to.

I have this problem that resets your home position I set my home in my house using /home set, but when I restart my server it resets so I have to set my home again, also it does the same for warps so I have to reset them as well, I'm not sure what to do. Do you have any ideas?

I have this problem that resets your home position I set my home in my house using /home set, but when I restart my server it resets so I have to set my home again, also it does the same for warps so I have to reset them as well, I'm not sure what to do. Do you have any ideas?

Hey miyoko, I'm getting a 502 bad gateway when trying to get to your experimental builds that you've posted here. Trying to do some fiddling on my server for testing, and I'd like to try a couple of experimental builds.

At our server Waypoints don't work with the latest recommended Build of Bukkit 1938 1.1-R4. It says in Game "internal Error occured...." and the Server log says:
org.bukkit.command.CommandException: Unhandled exception executing command 'warp' in plugin Waypoint v1.6.5
at org.bukkit.command.PluginCommand.execute(PluginCommand.java:42)
at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:168)
at org.bukkit.craftbukkit.CraftServer.dispatchCommand(CraftServer.java:402)
at net.minecraft.server.NetServerHandler.handleCommand(NetServerHandler.java:784)
at net.minecraft.server.NetServerHandler.chat(NetServerHandler.java:744)
at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:732)
at net.minecraft.server.Packet3Chat.handle(Packet3Chat.java:33)
at net.minecraft.server.NetworkManager.b(NetworkManager.java:226)
at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:100)
at net.minecraft.server.NetworkListenThread.a(NetworkListenThread.java:78)
at net.minecraft.server.MinecraftServer.w(MinecraftServer.java:537)
at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:435)
at net.minecraft.server.ThreadServerApplication.run(SourceFile:465)
Caused by: java.lang.ClassCastException: java.lang.Boolean cannot be cast to java.lang.String
at me.pirogoeth.Waypoint.Core.Warps.PlayerToWarp(Warps.java:110)
at me.pirogoeth.Waypoint.Commands.Warp.run(Warp.java:241)
at me.pirogoeth.Waypoint.Waypoint.onCommand(Waypoint.java:194)
at org.bukkit.command.PluginCommand.execute(PluginCommand.java:40)
... 12 more

Hello miyoko! Congrats to such a great plugin, been searching ages to get a hold of something like that for my server

I have 2 questions though - first one, is this the same plugin that is listed at BukkitDev under this: http://dev.bukkit.org/server-mods/waypoint/
... if so, it has been marked as abandoned and has 2 different owners, so I'm a bit confused here :-P

Second question - I'm using Multiverse for multiple worlds management and Waypoint seems to be forcing SURVIVAL gamemode on teleport on its own, even though Multiverse has a different gamemode set for my creative world. It also seem to override Multiverse's "/mv tp" command by its own "/tp" command, since calling "/mv tp" twice in a row with timeout set in Waypoint's config gives me a cooldown message.

Is there any permission or config option that would help me retain gamemode set for my administrators (they're all in creative mode all the time)? The don't have the option to change it back on their own you see... :-D

ok so im new to the plugins thing, and I placed this into my server, but nobody exept for me is allowed to do anything. I cant tp them to me, they cant /home, or /spawn. It says they don't have permission. How do I cange that?

Hey miyoko, I'm getting a 502 bad gateway when trying to get to your experimental builds that you've posted here. Trying to do some fiddling on my server for testing, and I'd like to try a couple of experimental builds.

Click to expand...

I didn't realise that Integrity was down. It should be back up and working now.

At our server Waypoints don't work with the latest recommended Build of Bukkit 1938 1.1-R4. It says in Game "internal Error occured...." and the Server log says:
org.bukkit.command.CommandException: Unhandled exception executing command 'warp' in plugin Waypoint v1.6.5
at org.bukkit.command.PluginCommand.execute(PluginCommand.java:42)
at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:168)
at org.bukkit.craftbukkit.CraftServer.dispatchCommand(CraftServer.java:402)
at net.minecraft.server.NetServerHandler.handleCommand(NetServerHandler.java:784)
at net.minecraft.server.NetServerHandler.chat(NetServerHandler.java:744)
at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:732)
at net.minecraft.server.Packet3Chat.handle(Packet3Chat.java:33)
at net.minecraft.server.NetworkManager.b(NetworkManager.java:226)
at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:100)
at net.minecraft.server.NetworkListenThread.a(NetworkListenThread.java:78)
at net.minecraft.server.MinecraftServer.w(MinecraftServer.java:537)
at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:435)
at net.minecraft.server.ThreadServerApplication.run(SourceFile:465)
Caused by: java.lang.ClassCastException: java.lang.Boolean cannot be cast to java.lang.String
at me.pirogoeth.Waypoint.Core.Warps.PlayerToWarp(Warps.java:110)
at me.pirogoeth.Waypoint.Commands.Warp.run(Warp.java:241)
at me.pirogoeth.Waypoint.Waypoint.onCommand(Waypoint.java:194)
at org.bukkit.command.PluginCommand.execute(PluginCommand.java:40)
... 12 more

Hello miyoko! Congrats to such a great plugin, been searching ages to get a hold of something like that for my server

I have 2 questions though - first one, is this the same plugin that is listed at BukkitDev under this: http://dev.bukkit.org/server-mods/waypoint/
... if so, it has been marked as abandoned and has 2 different owners, so I'm a bit confused here :-P

Second question - I'm using Multiverse for multiple worlds management and Waypoint seems to be forcing SURVIVAL gamemode on teleport on its own, even though Multiverse has a different gamemode set for my creative world. It also seem to override Multiverse's "/mv tp" command by its own "/tp" command, since calling "/mv tp" twice in a row with timeout set in Waypoint's config gives me a cooldown message.

Is there any permission or config option that would help me retain gamemode set for my administrators (they're all in creative mode all the time)? The don't have the option to change it back on their own you see... :-D

Thank you!

Click to expand...

The project page on bukkitdev is the same as this, I'm the author of both, I just go by different usernames
Waypoint's cooldown crap works for all teleport events that are called, so to disable that, just disable cooldowns in the config.

ok so im new to the plugins thing, and I placed this into my server, but nobody exept for me is allowed to do anything. I cant tp them to me, they cant /home, or /spawn. It says they don't have permission. How do I cange that?

I was getting the same error on 1.6.4 and at one point, one of the dev builds fixed the error and everything was fine (naturally i didn't back that one up). Since you added PEX support, I can't get permissions working. I'm running PEX 1.18 and the above version of Waypoint and 1.1-R4 of Bukkit. Here's the relevant information from the log (I think):

I don't know anything about Minecraft modding so I'm not sure if order is important here since Waypoint is loading before PEX. Reinstalling 1.6.4 allows the mod to work but obviously the error comes back.

The project page on bukkitdev is the same as this, I'm the author of both, I just go by different usernames
Waypoint's cooldown crap works for all teleport events that are called, so to disable that, just disable cooldowns in the config.

Click to expand...

how to disable cooldown in the config? ive removed the entry, i've set to enabled: false and i've changed the cd timer to 0 but I still get the Waypoin cooldown message on teleport. this is bad because i use /spectate to spectate first person wta plugin, and the plugin is teleporting you so you see what the player sees. every time it gives me the cooldown message, and it spams chat

Also, I installed bpermissions and set up the groups and users file and put it in the world folder, etc, other plugins detect bpermissions but the console says that waypoing detects no permissions and defaults to the OPs, what am I doing wrong? Does waypoint not support bpermissions?

Also, I installed bpermissions and set up the groups and users file and put it in the world folder, etc, other plugins detect bpermissions but the console says that waypoing detects no permissions and defaults to the OPs, what am I doing wrong? Does waypoint not support bpermissions?

how to disable cooldown in the config? ive removed the entry, i've set to enabled: false and i've changed the cd timer to 0 but I still get the Waypoin cooldown message on teleport. this is bad because i use /spectate to spectate first person wta plugin, and the plugin is teleporting you so you see what the player sees. every time it gives me the cooldown message, and it spams chat

so i downlaoded the jar file, placed it into my plugins folder and then started it. it then said"
[SEVER] coild not load 'plugins\waypoints.jar' in folder 'plugins'
it then goes on to list that it is an "invalid plug exception at" and then lists a bunch of urls. i tried to re download file and it displayed the same error. can someone help me? ive included a more detailed picture in a file.

ok i checked again with other plugins and its all of them that behave this way.
so im thinking that it is something to do with my bukkit server.
can anyone help me fix this?

Click to expand...

Shortly after server version 1943 most of my plugins stopped working with similar errors, including this one. I am stuck at version 1943 until I can find a solution. I'm sure it has to do with their "We're cleaning up the code" banner message at the top of this page (and every other page on this site for that matter).