WorldEdit/COMPILING.md

Compiling
=========

You can compile WorldEdit as long as you have the [Java Development Kit (JDK)](http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html) for Java 7 or newer. You only need one version of JDK installed.

The build process uses Gradle, which you do *not* need to download. WorldEdit is a multi-module project with three modules:

* `worldedit-core` contains WorldEdit
* `worldedit-bukkit` is the Bukkit plugin
* `worldedit-forge` is the Forge mod

## To compile...

### On Windows

1. Shift + right click the folder with WorldEdit's files and click "Open command prompt".
2. `gradlew clean setupDevWorkspace`
3. `gradlew build`

### On Linux, BSD, or Mac OS X

1. In your terminal, navigate to the folder with WorldEdit's files (`cd /folder/of/worldedit/files`)
2. `./gradlew clean setupDevWorkspace`
3. `./gradlew build`

## Then you will find...

You will find:

* The core WorldEdit API in **worldedit-core/build/libs**
* WorldEdit for Bukkit in **worldedit-bukkit/build/libs**
* WorldEdit for Forge in **worldedit-forge/build/libs**

If you want to use WorldEdit, use the `-shadow` version.

(The -shadow version includes WorldEdit + necessary libraries.)

## Other commands

* `gradlew idea` will generate an [IntelliJ IDEA](http://www.jetbrains.com/idea/) module for the Forge module.
* `gradlew eclipse` will generate an [Eclipse](https://www.eclipse.org/downloads/) project for the Forge version.
* Use `setupCIWorkspace` instead of `setupDevWorkspace` if you are doing this on a CI server.

Note: Rather than `setupDevWorkspace`, `setupDecompWorkspace` would you give better decompiled code for developing the Forge mod, but it is currently incompatible with multi-module projects like WorldEdit.
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00			`Compiling`
			`=========`

Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`You can compile WorldEdit as long as you have the [Java Development Kit (JDK)](http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html) for Java 7 or newer. You only need one version of JDK installed.`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`The build process uses Gradle, which you do not need to download. WorldEdit is a multi-module project with three modules:`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			* `worldedit-core` contains WorldEdit
			* `worldedit-bukkit` is the Bukkit plugin
			* `worldedit-forge` is the Forge mod
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`## To compile...`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`### On Windows`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`1. Shift + right click the folder with WorldEdit's files and click "Open command prompt".`
Tell people to use setupDevWorkspace rather than setupDecompWorkspace 2015-01-11 09:16:02 +08:00			2. `gradlew clean setupDevWorkspace`
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			3. `gradlew build`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`### On Linux, BSD, or Mac OS X`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			1. In your terminal, navigate to the folder with WorldEdit's files (`cd /folder/of/worldedit/files`)
			2. `./gradlew clean setupDevWorkspace`
			3. `./gradlew build`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`## Then you will find...`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`You will find:`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`* The core WorldEdit API in worldedit-core/build/libs`
			`* WorldEdit for Bukkit in worldedit-bukkit/build/libs`
			`* WorldEdit for Forge in worldedit-forge/build/libs`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			If you want to use WorldEdit, use the `-shadow` version.
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`(The -shadow version includes WorldEdit + necessary libraries.)`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			`## Other commands`
Made COMPILING.md easier to understand 2014-04-24 04:37:42 +08:00
Switch to Gradle. Use git log --follow for history. This converts the project into a multi-module Gradle build. By default, Git does not show history past a rename, so use git log --follow to see further history. 2014-11-15 03:27:39 +08:00			* `gradlew idea` will generate an [IntelliJ IDEA](http://www.jetbrains.com/idea/) module for the Forge module.
			* `gradlew eclipse` will generate an [Eclipse](https://www.eclipse.org/downloads/) project for the Forge version.
			* Use `setupCIWorkspace` instead of `setupDevWorkspace` if you are doing this on a CI server.
Tell people to use setupDevWorkspace rather than setupDecompWorkspace 2015-01-11 09:16:02 +08:00
			Note: Rather than `setupDevWorkspace`, `setupDecompWorkspace` would you give better decompiled code for developing the Forge mod, but it is currently incompatible with multi-module projects like WorldEdit.