Note: If you accidentally omit --recursive option when cloning, you may
delete the repository and try again, or you may execute the following to fix the
situation:
git submodule update --init --recursive
Setup
Note: SpongeVanilla uses Gradle as its build system. The repo includes the Gradle wrapper that will automatically download the correct Gradle
version. Local installations of Gradle may work but are untested. To execute the Gradle wrapper, run the ./gradlew script on Unix systems or only
gradlew on Windows systems.
Before you are able to build SpongeVanilla, you must first prepare the environment:
Run ./gradlew setupDecompWorkspace --refresh-dependencies
Make sure you have the Gradle plugin enabled (File > Settings > Plugins. For macOS users: IntelliJ IDEA > Preferences > Plugins).
Click File > New > Project from Existing Sources > Gradle and select the root folder for SpongeVanilla.
Make sure Use default gradle wrapper is selected. Older/newer Gradle versions may work but we only test using the wrapper.
Running
Note: The following is aimed to help you setup run configurations for Eclipse and IntelliJ, if you do not want to be able to run SpongeVanilla directly from your IDE then you can skip this.
Running ./gradlew eclipse should have generated the run configurations automatically.
When launching the server for the first time, it will shutdown by itself. You will need to modify eula.txt to set eula=true (this means you agree to the Mojang EULA, if you do not wish to do this then you cannot run the server).
Restart IntelliJ IDEA or reload the project, the run configuration should now be generated.
When launching the server for the first time, it will shutdown by itself. You will need to modify eula.txt to set eula=true (this means you agree to the Mojang EULA, if you do not wish to do this then you cannot run the server).
In order to build SpongeVanilla you simply need to run the gradlew command. On Windows systems you should run gradlew instead of ./gradlew to
invoke the Gradle wrapper. You can find the compiled JAR files in ./build/libs. You can find the compiled JAR files in ./build/libs but in most cases
you'll only need 'spongevanilla-x.x.x-x.x-x.jar'.
Updating your Clone
The following steps will update your clone with the official repo.
A dependency was added, but my IDE is missing it! How do I add it?
If a new dependency was added, you can just restart your IDE and the Gradle plugin for that IDE should pull in the new dependencies.
Contributing
Are you a talented programmer looking to contribute some code? We'd love the help!
Open a pull request with your changes, following our guidelines.
Please follow the above guidelines for your pull request(s) to be accepted.
Help! Things are not working!
Some issues can be resolved by deleting the '.gradle' folder in your user directory and running through the setup steps again, or even running gradle cleanCache and running through the setup again. Otherwise if you are having trouble with something that the README does not cover, feel free to join our IRC channel and ask for assistance.
请发表评论