Revert c9ca6fbe57393b6eab90f58e233270948ce1d050^ ... c9ca6fbe57393b6eab90f58e233270948ce1d050

jaboy 2012-07-26 06:05:41 -07:00
parent c9ca6fbe57
commit dea4387b1f
1 changed files with 110 additions and 0 deletions

110
Destinations.md Normal file

@ -0,0 +1,110 @@
## Destination Types:
* [[World|Destinations#wiki-world]]
* [[Anchor|Destinations#wiki-anchor]]
* [[Exact|Destinations#wiki-exact]]
* [[Player|Destinations#wiki-player]]
* [[Cannon|Destinations#wiki-cannon]]
* [[Bed|Destinations#wiki-bed]]
* [[Portal - Requires MV-Portals|Destinations#wiki-portal]]
* [[OpenWarp - Requires OpenWarp|Destinations#wiki-openwarp]]
---
## <a name="world" href="#wiki-world"></a>World Destinations
`/mvtp world`
`/mvtp world:n`
`/mvtp w:world`
`/mvtp w:world:se`
**Permissions**
`multiverse.teleport.self.w`
`multiverse.teleport.other.w`
World destinations can be prefixed with a `w:` but it is not required. If no prefix is found for a destination, it is assumed to be a world. You can also add a direction to spawn a player in a world just like with portals.
---
## <a name="anchor" href="#wiki-anchor"></a>Anchor Destinations
`/mvtp a:myplace`
**Permissions**
`multiverse.teleport.self.a`
`multiverse.teleport.other.a`
Anchors should be used if you have a place you want to go frequently. Using the `/mv anchor NAME` command to first create an anchor, you can then use it in any command that takes a destination.
---
## <a name="exact" href="#wiki-exact"></a>Exact Destinations
`/mvtp e:world:0,0,0`
`/mvtp e:world:0,0,0:0:0`
**Permissions**
`multiverse.teleport.self.e`
`multiverse.teleport.other.e`
Exact destinations are useful if you know exactly where someone should spawn, but they're difficult to set, as that's a lot to type! Luckily, an easy way of setting an exact destination is by using: `/mvpm dest here` this will set the destination to an exact dest of your current location, __including where you are looking__. This is great if you want people to spawn looking at your awesome creations!
---
## <a name="player" href="#wiki-player"></a>Player Destinations
`/mvtp pl:fernferret`
**Permissions**
`multiverse.teleport.self.pl` (Note: This will do nothing, but it's included for completeness)
`multiverse.teleport.other.pl`
Player destinations are exactly what they sound like, they will always teleport you to a _specific_ player! If that player is not online, you will not teleport, or if you're using a portal, it will act as if it's inactive. If a player tries to teleport to themselves, nothing will happen.
---
## <a name="cannon" href="#wiki-cannon"></a>Cannon Destinations
`/mvtp cannon-2`
`/mvtp ca:world:x,y,z:pitch:yaw:speed`
**Permissions**
`multiverse.teleport.self.ca`
`multiverse.teleport.other.ca`
The thing you have to remember with Cannon Destinations is that __you will never see a cannon__. This basically creates an exact destination with a velocity. The reason it's a different dest type entirely is due to the fact that we have provided a convince method: `cannon-X` where X is a velocity.
---
## <a name="bed" href="#wiki-bed"></a>Bed Destinations
`/mvtp b:mybed`
**Permissions**
`multiverse.teleport.self.b`
`multiverse.teleport.other.b`
Takes a player to the bed they will spawn at if they die. This can only take players to their own beds at this time, not others' beds.
---
## <a name="portal" href="#wiki-portal"></a>Portal Destinations - _REQUIRES:_ [Multiverse-Portals](https://github.com/Multiverse/Multiverse-Portals/wiki/)
`/mvtp p:portal`
`/mvtp p:portal:n`
`/mvtp p:portal:sw`
**Permissions**
`multiverse.teleport.self.p`
`multiverse.teleport.other.p`
These are examples of the `PORTAL` destination type. Portal destination types are ONLY available if you have [Multiverse-Portals](https://github.com/Multiverse/Multiverse-Portals/wiki) installed. If you want players to face a different direction when being placed at the destination, you can add any of the following with a colon (as shown twice above) `n,e,s,w,ne,nw,se,sw`
### Special case
When you're *standing* inside a portal (let's say `PortalB`, if you want to set the destination of another (`PortalA`) to **the center of that portal facing the rounded direction**, you can simply use `/mvpm dest here`. This will set the destination of the selected *source* portal (`PortalA`) to the portal you're standing in *plus* the cardinal direction (`p:portal:se`). This makes it a snap to set the directions of portals without any lookups!
---
## <a name="openwarp" href="#wiki-openwarp"></a>OpenWarp Destinations - _REQUIRES:_ [OpenWarp Dev Builds](https://github.com/Pneumaticraft/OpenWarp/wiki/)
`/mvtp ow:WarpName`
**Permissions**
`multiverse.teleport.self.ow`
`multiverse.teleport.other.ow`
Yep, we've done it. This does _not_ mean we will provide support for __every__ warp plugin in this manner. This is code that has nothing to do with MV, but is OpenWarp using our API. Ask your Warp plugin author to talk to us about supporting their destinations or switch to OpenWarp.
Disclaimer: OpenWarp is authored by Multiverse committer @**[lithium3141](http://github.com/lithium3141)**