Building

Are you interested in developing? 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:

Software	Required	Recommended
Java	6.0	6.0
Maven	2.2	3.0
Git	1.6	1.7

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) 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 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!