Revert b6ca99f93ec44942887655279cc13ee40b9b77a9 ... a3353464d466cd170ffb24ce0f9b19c91c474be2
FernFerret
parent
a485280945
commit
8c6872ab3e
|
|
@ -0,0 +1,43 @@
|
|||
Are you [[interested in developing|How can I help#wiki-pullrequest]]? Do you just want your own local copy of Multiverse? Look no further - this page aims to describe how to build any Multiverse plugin from scratch, regardless of your reason.
|
||||
|
||||
---
|
||||
|
||||
## Requirements
|
||||
|
||||
In order to get the Multiverse source and build a plugin, your system must already have the following software:
|
||||
|
||||
<table>
|
||||
<tr><th>Software</th><th>Required</th><th>Recommended</th></tr>
|
||||
<tr><td><a href="http://java.com/">Java</a></td><td>5.0</td><td>6.0</td></tr>
|
||||
<tr><td><a href="http://maven.apache.org/">Maven</a></td><td>2.2</td><td>3.0</td></tr>
|
||||
<tr><td><a href="http://git-scm.com/">Git</a></td><td>1.6</td><td>1.7</td></tr>
|
||||
</table>
|
||||
|
||||
Windows users will likely have to download installers for each from the respective sites; Linux users can likely find these packages in their distribution's package manager. For Mac users, source-based installers (or alternative package managers like [Homebrew](http://mxcl.github.com/homebrew/)) are the preferred method.
|
||||
|
||||
---
|
||||
|
||||
## Git the source
|
||||
|
||||
Once you have all the prerequisites installed, go ahead and fetch the source from GitHub:
|
||||
|
||||
$ git clone git://github.com/Multiverse/Multiverse-Core.git
|
||||
|
||||
(Note that in this command, and from this point on, you can replace `Core` with the name of any other Multiverse plugin - `Portals`, `NetherPortals`, etc. - to build that plugin.)
|
||||
|
||||
Once you have the source cloned, everything should be ready. However, if you want to go back to commits before [443d62580ba24c4f225ffca0067bc914cf7f5a6b](https://github.com/Multiverse/Multiverse-Core/commit/443d62580ba24c4f225ffca0067bc914cf7f5a6b) you'll need to fetch some of the Git submodules that the Multiverse project uses. Move into the cloned directory, then update your submodules:
|
||||
|
||||
$ cd Multiverse-Core
|
||||
$ git submodule update --init --recursive
|
||||
|
||||
After that operation completes, you should have the complete source tree checked out for your preferred Multiverse plugin.
|
||||
|
||||
---
|
||||
|
||||
## Build the plugin
|
||||
|
||||
Once the source is cloned, building is easy. Simply run Maven to fetch all the other dependencies for Multiverse, run the tests, and generate a JAR file with your plugin:
|
||||
|
||||
$ mvn install
|
||||
|
||||
The final plugin will be in the `target` folder. Enjoy!
|
||||
|
|
@ -0,0 +1,145 @@
|
|||
## <a name="about" href="#wiki-about">•</a>About this page
|
||||
Here you will find a list of __open source__ generator plugins. If there is no source, the plugin will not be listed. Github is preferred for code hosting. Do not put JAR downloads here.
|
||||
|
||||
You may add your plugin using the BukkitFullOfMoon template, but be warned, if you don't post the source, your entry will be deleted.
|
||||
|
||||
These are listed in _alphabetical_ order.
|
||||
|
||||
---
|
||||
|
||||
## <a name="howto" href="#wiki-howto">•</a>How to use generator plugins with Multiverse
|
||||
|
||||
1. Place the generator's jar in your plugins folder.
|
||||
1. Start your server
|
||||
1. Use the generator command. This will verify that the generator loaded properly. You should see its name appear:
|
||||
```
|
||||
/mv gens
|
||||
--- Loaded Generator Plugins ---
|
||||
CleanroomGenerator SkylandsPlus
|
||||
```
|
||||
4. Then simply use the create command to create the world with a generator.
|
||||
```
|
||||
/mv create skyworld2 normal -g CleanroomGenerator
|
||||
Starting creation of world 'skyworld2'...
|
||||
Complete!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
##[Banana Image To Map](http://forums.bukkit.org/threads/22623/)
|
||||
__Description__: Turn any image into a world! (With custom generator features like stone mushrooms and random torches!)
|
||||
|
||||
__Author__: [codename-B](https://github.com/codename-B)
|
||||
|
||||
__Github Wiki__: Someone should bug [codename-B](https://github.com/codename-B) to create a wiki :)
|
||||
|
||||
__Source__: [https://github.com/codename-B/BananaImageToMap](https://github.com/codename-B/BananaImageToMap)
|
||||
|
||||
__bukkit.org Thread__: http://forums.bukkit.org/threads/22623/
|
||||
|
||||
---
|
||||
|
||||
##[BananaGen](http://forums.bukkit.org/threads/30579/)
|
||||
|
||||
__Description__: Long description coming soon!
|
||||
|
||||
__Author__: [BananaCode](https://github.com/BananaCode)
|
||||
|
||||
__Github Wiki__: [Wiki](https://github.com/BananaCode/BananaGen/wiki)
|
||||
|
||||
__Source__: https://github.com/BananaCode/BananaGen
|
||||
|
||||
__bukkit.org Thread__: http://forums.bukkit.org/threads/30579/
|
||||
|
||||
---
|
||||
|
||||
##[BananaSpace](http://forums.bukkit.org/threads/32546/)
|
||||
|
||||
__Description__: Space worlds.
|
||||
|
||||
__Author__: [BananaCode](https://github.com/iffa)
|
||||
|
||||
__Github Wiki__: [Wiki](https://github.com/iffa/BananaSpace/wiki)
|
||||
|
||||
__Source__: https://github.com/iffa/BananaSpace
|
||||
|
||||
__bukkit.org Thread__: http://forums.bukkit.org/threads/32546/
|
||||
|
||||
---
|
||||
|
||||
##BukkitFullOfMoon
|
||||
__Description__: Generates a moon made of sponge with cool little US flags.
|
||||
|
||||
__Author__: [Dinnerbone](https://github.com/Dinnerbone)
|
||||
|
||||
__Source__: [https://github.com/Dinnerbone/BukkitFullOfMoon](https://github.com/Dinnerbone/BukkitFullOfMoon)
|
||||
|
||||
__bukkit.org Thread__: N/A
|
||||
|
||||
---
|
||||
|
||||
##[Cleanroom Generator](http://forums.bukkit.org/threads/24791/)
|
||||
__Description__: Generates a nice flat landscape for building anything you could want!
|
||||
|
||||
__Author__: [NVX](https://github.com/NVX)
|
||||
|
||||
__Github Wiki__: [Wiki](https://github.com/nvx/CleanroomGenerator/wiki)
|
||||
|
||||
__Source__: https://github.com/nvx/CleanroomGenerator
|
||||
|
||||
__bukkit.org Thread__: http://forums.bukkit.org/threads/24791/
|
||||
|
||||
---
|
||||
|
||||
##[Null Terrain](http://forums.bukkit.org/threads/27362/)
|
||||
__Description__: Generates an empty landscape! Look mum, no terrain! Useful for space areas and voids.
|
||||
|
||||
__Author__: [Elizacat](https://github.com/Elizacat)
|
||||
|
||||
__Github Wiki__: What wiki? **whistles innocently**
|
||||
|
||||
__Source__: https://github.com/Elizacat/NullTerrain
|
||||
|
||||
__bukkit.org Thread__: http://forums.bukkit.org/threads/27362/
|
||||
|
||||
---
|
||||
|
||||
##[PermaWorldGenerator](http://dev.bukkit.org/server-mods/permaworldgenerator/)
|
||||
|
||||
__Description__: Permanent world generator plugin for Bukkit.
|
||||
|
||||
__Author__: [DjDCH](https://github.com/DjDCH)
|
||||
|
||||
__Github Wiki__: Someone should bug [DjDCH](https://github.com/DjDCH) to create a wiki. :)
|
||||
|
||||
__Source__: https://github.com/DjDCH/PermaWorldGenerator
|
||||
|
||||
__Bukkit Dev__: http://dev.bukkit.org/server-mods/permaworldgenerator/
|
||||
|
||||
---
|
||||
|
||||
##[Phoenix Terrain Mod](http://forums.bukkit.org/threads/28520/)
|
||||
|
||||
__Description__: Phoenix Terrain Mod is a mod based off of Bucyruss's BiomeTerrainMod. It basically allows you to customize Minecraft's terrain generation to control ore spawns, terrain types, biome size, basically everything.
|
||||
|
||||
__Author__: [Wicth](https://github.com/Wickth)
|
||||
|
||||
__Github Wiki__: Someone should bug [Wicth](https://github.com/Wickth) to create a wiki :)
|
||||
|
||||
__Source__: https://github.com/Wickth/PTMBukkit/
|
||||
|
||||
__bukkit.org Thread__: http://forums.bukkit.org/threads/28520/
|
||||
|
||||
---
|
||||
|
||||
##[OneHundredGenerator](http://dev.bukkit.org/server-mods/onehundredgenerator/)
|
||||
|
||||
__Description__: Minecraft 1.0.0 world generator plugin for Bukkit.
|
||||
|
||||
__Author__: [DjDCH](https://github.com/DjDCH)
|
||||
|
||||
__Github Wiki__: Someone should bug [DjDCH](https://github.com/DjDCH) to create a wiki. :)
|
||||
|
||||
__Source__: https://github.com/DjDCH/OneHundredGenerator
|
||||
|
||||
__Bukkit Dev__: http://dev.bukkit.org/server-mods/onehundredgenerator/
|
||||
|
|
@ -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="exact" href="#wiki-exact">•</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)**
|
||||
Loading…
Reference in New Issue