WorldEdit/COMPILING.md

Compiling
=========

You can compile WorldEdit as long as you have some version of Java greater than or equal to 8 installed. Gradle will download JDK 8 specifically if needed,
but it needs some version of Java to bootstrap from.

Note that if you have JRE 8 installed, Gradle will currently attempt to use that to compile, which will not work. It is easiest to uninstall JRE 8 and
replace it with JDK 8.

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

* `worldedit-core` contains the WorldEdit API
* `worldedit-bukkit` is the Bukkit plugin
* `worldedit-sponge` is the Sponge plugin
* `worldedit-forge` is the Forge mod
* `worldedit-fabric` is the Fabric mod

## To compile...

### On Windows

1. Shift + right click the folder with WorldEdit's files and click "Open command prompt".
2. `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 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 Sponge in **worldedit-sponge/build/libs**
* WorldEdit for Forge in **worldedit-forge/build/libs**
* WorldEdit for Fabric in **worldedit-fabric/build/libs**

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

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

## Other commands

* `gradlew idea` will generate an [IntelliJ IDEA](http://www.jetbrains.com/idea/) module for each folder.
* `gradlew eclipse` will generate an [Eclipse](https://www.eclipse.org/downloads/) project for each folder.
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00			`Compiling`
			`=========`

Update so many dependencies, merge Forge/Fabric for final jar (#1651) * Update so many dependencies, merge Forge/Fabric for final * Clean up contrib docs for Gradle change * Fix setting compat flags while using toolchain * Fix deprecation in doc printer * Restore proper forge JAR name * Add dist classifier for mod jar * Properly relocate new bStats * Fix jar used from fabric * Fix fabric bom * Dup the shaded classes for consistency * Sync Forge/Fabric log4j versions, de-dup * Downgrade both log4j. This will work * Update some plugins as well * Drop the fabric force stuff * Use duplicate strategy to directly merge jar 2021-01-25 18:14:09 +08:00			`You can compile WorldEdit as long as you have some version of Java greater than or equal to 8 installed. Gradle will download JDK 8 specifically if needed,`
			`but it needs some version of Java to bootstrap from.`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Note catch about toolchain system 2021-04-07 03:58:38 +08:00			`Note that if you have JRE 8 installed, Gradle will currently attempt to use that to compile, which will not work. It is easiest to uninstall JRE 8 and`
			`replace it with JDK 8.`

Update some notes in the compiling doc 2016-12-03 12:21:03 +08:00			`The build process uses Gradle, which you do not need to download. WorldEdit is a multi-module project with four modules:`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Update some notes in the compiling doc 2016-12-03 12:21:03 +08:00			* `worldedit-core` contains the WorldEdit API
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-bukkit` is the Bukkit plugin
Update some notes in the compiling doc 2016-12-03 12:21:03 +08:00			* `worldedit-sponge` is the Sponge plugin
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-forge` is the Forge mod
Add fabric to the compiling.md (#1353) 2020-05-31 12:33:35 +08:00			* `worldedit-fabric` is the Fabric 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".`
Remove mentions of setupDecompWorkspace in COMPILING.md. This task is no longer needed or used. Fixes WORLDEDIT-3886. 2019-05-05 09:00:00 +08:00			2. `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`)
Remove mentions of setupDecompWorkspace in COMPILING.md. This task is no longer needed or used. Fixes WORLDEDIT-3886. 2019-05-05 09:00:00 +08:00			2. `./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`
Update some notes in the compiling doc 2016-12-03 12:21:03 +08:00			`* WorldEdit for Sponge in worldedit-sponge/build/libs`
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 for Forge in worldedit-forge/build/libs`
Add fabric to the compiling.md (#1353) 2020-05-31 12:33:35 +08:00			`* WorldEdit for Fabric in worldedit-fabric/build/libs`
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Fix classifier in compile guide 2016-12-01 20:55:39 +08:00			If you want to use WorldEdit, use the `-dist` version.
Updated Forge compilation to ForgeGradle. 2014-04-06 10:33:05 +08:00
Fix classifier in compile guide 2016-12-01 20:55:39 +08:00			`(The -dist 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
Update some notes in the compiling doc 2016-12-03 12:21:03 +08:00			* `gradlew idea` will generate an [IntelliJ IDEA](http://www.jetbrains.com/idea/) module for each folder.
			* `gradlew eclipse` will generate an [Eclipse](https://www.eclipse.org/downloads/) project for each folder.