2014-04-06 04:33:05 +02:00
|
|
|
Compiling
|
|
|
|
|
=========
|
|
|
|
|
|
|
|
|
|
You can (most easily) compile WorldEdit using one of the build scripts.
|
|
|
|
|
|
|
|
|
|
* **Maven** is for compiling **API**, **Bukkit**, and **Spout** versions
|
|
|
|
|
* **Gradle** is for the **Forge** version
|
|
|
|
|
|
2014-04-23 22:37:42 +02:00
|
|
|
WorldEdit is written and targetted for Java 6, but you can use newer
|
|
|
|
|
versions of Java to compile WorldEdit, though the compiler will give
|
|
|
|
|
you warnings. However, if you plan on compiling for Forge, you have
|
|
|
|
|
no choice in the matter and you **must** use Java 7 (make sure that it
|
|
|
|
|
is set as your 'default' Java too, if you have multiple versions).
|
2014-04-06 04:33:05 +02:00
|
|
|
|
2014-04-23 22:37:42 +02:00
|
|
|
The Java Development Kit is required, so install the latest version
|
|
|
|
|
either from Oracle's website or, if you're a Linux/BSD user, you
|
|
|
|
|
can also try using OpenJDK.
|
2014-04-06 04:33:05 +02:00
|
|
|
|
2014-04-23 22:37:42 +02:00
|
|
|
* [Get Oracle JDK 7 and 8](http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html)
|
|
|
|
|
* [Get Oracle JDK 6](http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html)
|
2014-04-06 04:33:05 +02:00
|
|
|
|
|
|
|
|
Dependencies
|
|
|
|
|
------------
|
|
|
|
|
|
2014-04-23 22:37:42 +02:00
|
|
|
WorldEdit requires several other dependencies, but thankfully, the build
|
|
|
|
|
scripts provided will automatically download these for you. If, for some
|
2014-04-06 04:33:05 +02:00
|
|
|
reason, compilation fails due to a missing dependency, please notify us.
|
|
|
|
|
|
|
|
|
|
Maven
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
**Don't have Maven?** [Download Maven](http://maven.apache.org/download.cgi)
|
|
|
|
|
from the Maven website.
|
|
|
|
|
|
|
|
|
|
From WorldEdit's directory, execute the following command to compile a
|
|
|
|
|
Bukkit version:
|
|
|
|
|
|
|
|
|
|
mvn clean package
|
|
|
|
|
|
|
|
|
|
Once done, the *target/* folder will contain a .jar file and release .zip
|
|
|
|
|
files.
|
|
|
|
|
|
|
|
|
|
### Other Variations
|
|
|
|
|
|
2014-04-23 22:37:42 +02:00
|
|
|
By default, the *Bukkit* profile is enabled, but you can disable it
|
|
|
|
|
and enable other profiles.
|
|
|
|
|
|
2014-04-06 04:33:05 +02:00
|
|
|
* `mvn clean package -P !bukkit` for just the API
|
2014-04-06 10:51:49 +02:00
|
|
|
* `mvn clean package -P !bukkit -P spout` for the Spout version
|
2014-04-06 04:33:05 +02:00
|
|
|
|
|
|
|
|
Gradle
|
|
|
|
|
------
|
|
|
|
|
|
|
|
|
|
**Note:** As mentioned previously, you need Java 7 (a recent version) to
|
|
|
|
|
execute the following steps successfully. Your `JAVA_HOME` environment
|
|
|
|
|
variable needs to be set to the path of JDK 7+.
|
|
|
|
|
|
|
|
|
|
**Don't have Gradle?** Replace `gradle` with `gradlew` below, which will
|
|
|
|
|
automatically download a copy of Gradle for you.
|
|
|
|
|
|
|
|
|
|
From WorldEdit's directory, clean the cache first with the following
|
|
|
|
|
command:
|
|
|
|
|
|
|
|
|
|
gradle cleancache --refresh-dependencies
|
|
|
|
|
|
|
|
|
|
Build WorldEdit for Forge with:
|
|
|
|
|
|
2014-10-12 21:27:51 +02:00
|
|
|
gradle setupDecompWorkspace
|
2014-04-06 04:33:05 +02:00
|
|
|
gradle build
|
|
|
|
|
|
|
|
|
|
Once complete, you will find the release .jar in the folder *build/libs*.
|
|
|
|
|
|
|
|
|
|
### Other Tasks
|
|
|
|
|
|
2014-10-12 21:27:51 +02:00
|
|
|
* `gradle idea` will generate an [IntelliJ IDEA](http://www.jetbrains.com/idea/) workspace
|
|
|
|
|
* `gradle eclipse` will generate an [Eclipse](https://www.eclipse.org/downloads/) workspace
|
