WorldEdit/README.md

80 lines
4.3 KiB
Markdown
Raw Normal View History

2020-10-23 19:43:43 +08:00
<h1>
<img src="worldedit-logo.svg" alt="WorldEdit" width="400" />
</h1>
2018-09-30 12:00:08 +08:00
**A Minecraft Map Editor... that runs in-game!**
2018-09-30 12:00:08 +08:00
* With selections, schematics, copy and paste, brushes, and scripting!
* Use it in creative, survival in single player or on your server.
* Use it on your Minecraft server to fix grieving and mistakes.
2018-09-30 12:00:08 +08:00
Java Edition required. WorldEdit is compatible with Forge, Fabric, Bukkit, Spigot, Paper, and Sponge.
2018-09-30 12:00:08 +08:00
## Download WorldEdit
This place contains the Java code for WorldEdit, but if you want to just use WorldEdit, get the mod or plugin from these pages:
* For the mod: https://www.curseforge.com/minecraft/mc-mods/worldedit
* For the server plugin: https://dev.bukkit.org/projects/worldedit
Edit the Code
2018-09-30 12:00:08 +08:00
---------
2020-10-03 14:58:05 +08:00
Want to add new features to WorldEdit or fix bugs yourself? You can get the game running, with WorldEdit, from the code here, without any additional outside steps, by doing the following *four* things:
2020-10-03 14:58:05 +08:00
1. Download WorldEdit's source code and put it somewhere. We recommend you use something called Git if you already know how to use it, but [you can also just download a .zip file](https://github.com/EngineHub/WorldEdit/archive/master.zip). (If you plan on contributing the changes, you will need to figure out Git.)
2. Install the [Java Development Kit (JDK) v8](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html) and restart your computer for safe measure. You absolutely need version 8 of the JDK, even if you have other versions installed.
3. Open terminal / command prompt / bash and navigate to the directory where you put the source code.
4. Run **one** of these following commands:
* Mac OS X / Linux: `./gradlew :worldedit-fabric:runClient`
* Windows - Command Prompt: `gradlew :worldedit-fabric:runClient`
* Windows - PowerShell: `.\gradlew :worldedit-fabric:runClient`
2020-10-03 14:58:05 +08:00
🎉 That's it. 🎉 It takes a long time to actually transform WorldEdit into a mod. If it succeeds, **the Minecraft game will open and you can create a single player world with WorldEdit**.
2020-10-03 14:58:05 +08:00
When you make changes to the code, you have to restart the game by re-running the command for your changes to take effect. If there are errors in your Java syntax, the command will fail.
| Got an error? |
| :----------------------------------------------------------- |
2020-10-03 15:02:30 +08:00
| If you get a `Type javax.tools.JavaCompiler not present` error, you need to edit your environmental variables and add a new `JAVA_HOME` variable. The value of the variable needs to be the path to where JDK 8 was installed. |
For additional information about compiling WorldEdit, see [COMPILING.md](COMPILING.md).
2018-09-30 12:00:08 +08:00
2020-10-03 14:58:05 +08:00
### Using a Java IDE
To edit WorldEdit in a Java IDE, follow these steps:
1. Download and install [IntelliJ IDEA Community Edition](https://www.jetbrains.com/idea/download/).
2. In the IDE, open the folder that you saved WorldEdit's code in. This creates a new project in IDEA.
That's pretty much it.
If you want to be able to run the game also, follow these instructions:
1. Go to Run -> Edit Configurations.
2. Add a Gradle task:
1. Choose `worldedit-fabric` for the project.
2. For the tasks, type in `runClient`
3. Click OK
4. Under the Run menu again, go to "Debug [your new task]".
2020-10-03 15:02:30 +08:00
### Speeding up the Edit-Test-Edit-Test Cycle
It's a little annoying have to restart the game to test your changes. The best way to reduce the time is to run the server instead (using `runServer` instead of `runClient`) and then reconnect to the server after restarting it.
Submitting Your Changes
2018-09-30 12:00:08 +08:00
------------
2020-10-03 14:58:05 +08:00
WorldEdit is open source (specifically licensed under GPL v3), so note that your contributions will also be open source. The best way to submit a change is to create a fork on GitHub, put your changes there, and then create a "pull request" on our WorldEdit repository.
2018-09-30 12:00:08 +08:00
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for important guidelines to follow.
Links
-----
2020-06-28 07:54:22 +08:00
* [Visit our website](https://enginehub.org/)
2019-06-05 06:31:19 +08:00
* [Discord](https://discord.gg/enginehub)
2020-06-28 07:54:22 +08:00
* [Issue tracker](https://github.com/EngineHub/WorldEdit/issues)
* [Continuous integration](https://builds.enginehub.org) [![Build Status](https://ci.enginehub.org/app/rest/builds/buildType:bt10,branch:master/statusIcon.svg)](https://ci.enginehub.org/viewType.html?buildTypeId=bt10&guest=1)
* [End-user documentation](https://worldedit.enginehub.org/en/latest/)