Maren's Waypoints
Maren's Waypoints is a portal management system which aims to unify what is normally separate plugins for portals, homes/warps, and spawns under an intuitive self-linking menu not unlike the waypoint system in Diablo 2. Focus is on providing players fun and easy ways to navigate the server's maps without ruining the Minecraft adventuring experience through instant gratification.
Compatible with Bukkit versions 1.7.x and beyond.
Using a waypoint is as simple as walking over any waypoint location (a single block) to open the waypoint directory and clicking on the destination. Server-defined waypoints can link to Spawn, Bed, all server-defined waypoints that a player has access, and the player's home waypoints. Home waypoints can travel between Spawn, Bed, and other home waypoints.
Once clicking on a destination, the player will be frozen in place and cannot pickup/drop items or pass commands. After a few seconds of techno-babble (or whatever you want it to be, as all messages can be edited in the config.yml) the player will be zapped to their destination, and will be free to move once again.
Home Waypoints
Home waypoints are player-defined locations that will show up in the waypoint directory. A player can have up to a configurable limit of home waypoints (three by default); creating any new waypoints beyond this limit will overwrite the oldest entry.
To add a home waypoint, simply right-click with a clock renamed to the desired waypoint name while sneaking. It will be created where the player is standing (and with their facing), consuming the clock in the process.
To change the waypoint's icon in the directory, right-click on the block the waypoint was created over while sneaking. The item in the player's hand will be consumed, becoming the waypoint's new icon. Or if the item is a Written Book, its contents (up to the WP_DESC_MAX_LENGTH, which is configurable in config.yml) will become the waypoint's description in the directory.
Discovery Mode
Discovery mode allows a waypoint to be discovered by players who walk over its location. Discovered waypoints can be accessed without the access permission. This mode is disabled by default. "/wp discover" will cycle through three discovery modes for the selected waypoint:
- Server-wide will allow discovered waypoints to show up globally
- World-specific only allows discovered waypoint to show in its own world
- Disabled disables discovery mode
Waypoint Beacons
Waypoint Beacons provide remote teleportation functionality. As pictured above, the recipe to create one is a compass at the center of a crafting table surrounded by redstone.
To use, right-click while holding the beacon. Normally, the beacon can only travel between home waypoints, but it can be expanded to include server-defined waypoints with the appropriate permission.
Beacons are consumed upon use, unless the player has the permission "wp.beacon.unlimited". Additionally, players with this permission will always have a Waypoint Beacon in their inventory if BEACON_UNLIMITED_PERMANENT is set to true in config.yml. However, they will no longer be able to drop it; and cannot interact with it in any way when an inventory other than their own is open.
Administrators with the "wp.select" permission can also left-click with a beacon to quickly bring up the selection menu.
This item can be disabled from config.yml.
Respawns
Maren's Waypoints will also handle where your players spawn after they die. This feature can be enabled/disabled by setting "HANDLE_RESPAWNING" to true or false in config.yml. There are four modes available:
- Home - Players will respawn at their closest waypoint for their current world
- Bed - Players will respawn at their bed location
- Spawn - Players will respawn at their current world's spawn
- City - Players will respawn at the spawn waypoint of the CITY_WORLD_NAME in config.yml
Whenever a location is unavailable (like if the player has no home waypoints in current world or a bed location), the player will respawn at the location below it. The priority is as follows: Home > Bed > Spawn. On the City spawn mode, players will always revive at the specified world's spawn waypoint.
Additionally, if players have the permission node "wp.respawn", they will be able to right-click on their home waypoints with a Waypoint Beacon to set their respawn point. The block under the waypoint must be powered by redstone for the player to be able to set it as the respawn point, or for the player to revive at it. This requires both ENABLE_BEACON and HANDLE_RESPAWNING to be set to true.
Commands
Command | Permission | Description |
---|---|---|
/wp | Top command which returns plugin commands and a list of player's home waypoints | |
/wp add <name ...> | wp.add | Creates waypoint on player's position with specified name |
/wp desc <description ...> | wp.desc | Sets short lore message for selected waypoint |
/wp discover | wp.discover | Cycles through available discovery modes |
/wp icon <Material> | wp.icon | Sets display icon for selected waypoint to matched material:data |
/wp move | wp.move | Moves selected waypoint to player's position |
/wp reload | wp.reload | Reloads config; clears all players' selections |
/wp remove | wp.remove | Deletes selected waypoint |
/wp rename <name ...> | wp.rename | Renames selected waypoint to specified name |
/wp select (name ...) | wp.select | Console - without arguments, lists server-defined waypoints Player - without arguments, brings up menu for waypoint selection Both - selects specified server-defined waypoint |
/wp toggle | wp.toggle | Enables/disables selected waypoint |
/sethome <name ...> | wp.sethome | While not intended to be the player's means of creating home waypoints, it can be. The oldest home is automatically erased when the three waypoint limit has been reached |
/setspawn | wp.setspawn | Sets the spawn point for the current world |
Other Permissions
Permission | Children | Description |
---|---|---|
wp.* | wp.admin wp.player wp.reload wp.access.* wp.respawn | Grants all plugin permissions |
wp.player | Allows players to manage home waypoints through world interaction | |
wp.instant | Grants instant teleportation | |
wp.respawn | Allows players to use Waypoint Beacons to set their respawn point to home waypoints | |
wp.admin | wp.bypass wp.add wp.desc wp.icon wp.move wp.remove wp.rename wp.select wp.toggle wp.sethome wp.setspawn | Grants all commands except reload; allows player to select server-defined waypoints |
wp.access.* | wp.access.bed wp.access.spawn | Grants access to all waypoints |
wp.access.<name> | Grants access to waypoint specified in <name>. For access permissions, strip case and color, and replace spaces with underscores. Ex. A waypoint titled "&6The Nether" would have an access permission of "wp.access.the_nether" | |
wp.access.bed | Allows player to teleport to bed location (one-way trip) | |
wp.access.spawn | Allows player to teleport to current world's spawn from any waypoint. Spawn waypoint is accessible whether or not player has this permission | |
wp.bypass | Allows player to teleport to disabled waypoints | |
wp.beacon.* | wp.beacon.use wp.beacon.server wp.beacon.unlimited | Grants all beacon permissions |
wp.beacon.use | Allows players to use waypoint beacons | |
wp.beacon.server | Expands beacon accessible waypoints to include server-defined waypoints | |
wp.beacon.unlimited | Prevents beacon from being consumed upon use |
More Videos
Em Português
/lary mod add "&l3dragonking"
please add in the new version 1.8
Its a great plugin for my rpg server. Plz Keep it updated! :P
Btw is it possible that a player can open up the waypoint menu by doing a command? Could be usefull for donator perks or something.
Video Tutorial on the Plugin
http://youtu.be/RxuGrft6vvc
Credits Video: (AbsintoJ/Maren's Waypoints)
@CGamingAU
With the newest version, if you set BEACON_UNLIMITED_PERMANENT to true in config.yml, players with the "wp.beacon.unlimited" permission will always have one. However, these players will be unable to drop their beacons or move them in/out of chests. :)
@Marenwynn - Is there any Item ID# for it? because I wanna add it to a kit and then use the kit for everyone to have automatically.
@versimo
That's a good idea. :)
I dunno about selling waypoints to each other, as I need to think of a good, command-free way to do it. Maybe I'll put in a custom item that can copy a Waypoint into an item, which can be used to add a waypoint entry. But definitely some Vault support for having teleport prices.
I'll get to it, but probably not in next release...
Add economy support? Would be fun if people could sell teleports to each other.
@BlankMen02
Is ENABLE_BEACON set to true in config.yml? The permission node "wp.beacon.use" is also needed to use it.
For the second thing, I'm not really sure what you're asking... Are you referring to the Waypoint Beacon? I could add a config option that will add it to the player's inventory if they don't have it. :)
Hey I really do like this plugin and hope it gets really far into bukkit plugins. I only have two problems. One thing is when I right click the menu for the waypoints won't show up it worked automatically without me pressing anything but now it won't work at all. My second thing is that I want to know if I can make everyone who joins the game have the waypoints without crafting it. If this isn't available can you please try to make it for people who join my server to get to games quicker.
Hopefully you can respond to this. -XMCOblivionX
@ltjim007
Thanks for the positive review! :)
I like your production quality, so I really wish you went more in-depth, but would you mind if I put it on the plugin page to help give people a slight idea of what they're downloading?
It's also a lot easier to select waypoints by passing "/wp select" without arguments. ;)
This plugin works really well and is easy to setup and use. I have made a video tutorial on it as well: https://www.youtube.com/watch?v=7UyOgtNNA2o
@madtomic
Edit: I just tried it, and apparently it works without errors. Upgrade from 1.7.2-R0.3 > 1.7.9-R.02 worked fine as well. Going by the information from this thread, it should be compatible with all Bukkit versions from 1.7.x and beyond.
Does this work on cb1.7.2-r0.3?
@Ciryond
Thank you! I look forward to it! :)
Nice plugin ! I will made a french video tutorial
This is perfect.. finally a plug in that takes into account the players experience in the game.
So you are! Haha, that's turned an already fantastic plugin into one of utter perfection. Thanks! :D
@Jarada0077
I'm glad you like it! :)
Already a step ahead, though... version 1.1.0 has been pending for about a day, which includes what you're looking for in the Waypoint Beacon crafted item. Also new is the waypoint discovery mode, and the ability to enable/disable waypoints. ;)
Might take a few days for Bukkit to approve the file...
Oh. My. God. You are amazing! I signed up just so I could comment on this, this really is the BEST teleport plugin I have used and I've tried many. Thank you so much!!
My only desire is perhaps to allow people to use some kind of item or command to access the Waypoint directory for TP while not at another Waypoint for one way travel. Maybe to get back home or something. Other than that, this is too good...