Updated Java Management (markdown)

Daniel Scalzi 2018-08-20 03:55:22 -04:00
parent eb2d334768
commit 7f7cde972b

@ -2,7 +2,7 @@
<h1 align="center">Java Management</h1>
<p align="center">Customize your java executable, allocate more ram, or experiment with JVM args.</p>
<p align="center">Customize your Java executable, allocate more ram, or experiment with JVM args.</p>
<p align="center"><img src="https://i.imgur.com/lKIApi9.png" alt="Java Settings"></p>
<p align="center"><em>Java Management Tab. Accessible in the settings menu.</em></p>
@ -13,13 +13,44 @@ The launcher was designed to handle Java setup for you. If you're an advanced us
---
## The Launcher Handles Everything for You
The launcher validates the configured Java executable before each launch. If the configured value does not point to a valid Java version, your computer will be scanned for a valid version. If you do not have a valid installation, the game will not launch. WesterosCraft requires **Java 8 x64 greater than update 52**.
**Why is Java 10+ not supported?** Forge and LaunchWrapper [only support Java 8](https://github.com/Mojang/LegacyLauncher/pull/11).
#### Automatically Install a Valid Version of Java
The launcher will give you the option to automatically download a valid version of Java if it fails to find one. It will download it to `.westeroscraft/runtime/x64` as a local installation (only for the launcher). **We recommend using this option.**
<img src="https://i.imgur.com/YqbEd2C.png" width="75%" height="75%" alt="Automatic Java Install">
#### Manually Installing a Valid Version of Java
If you want to manually install Java rather than having the launcher do it for you, follow these steps.
* Download Java 8 x64
* Windows/macOS
* Download from [Oracle](http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html).
* For Windows: Windows x64 (`jre-8uVERSION-windows-x64.exe`)
* For macOS: Mac OS X x64 (`jre-8uVERSION-macosx-x64.dmg`)
* Linux:
* OpenJDK (recommended): `$ sudo apt-get install openjdk-8-jre`
* Oracle: [Instructions](https://java.com/en/download/help/linux_x64_install.xml)
* Follow on-screen instructions.
* Try to launch the game again, the launcher should find the version you just installed. If it does not, try setting the value manually.
<img src="https://i.imgur.com/ULTPlew.png" width="75%" height="75%" alt="Manual Java Install">
---
## Java Management Tab
### Change Minimum or Maximum RAM
Allocating RAM is easy! Just move the sliders to your desired value. You can set the value to the nearest half a gigabyte.
<img src="https://i.imgur.com/jSskdiV.gif" width="75%" height="75%" alt="Java Settings">
<img src="https://i.imgur.com/jSskdiV.gif" width="75%" height="75%" alt="RAM Sliders">
#### Technical Notes
* WesterosCraft requires 3GB of RAM to run smoothly.
@ -47,30 +78,7 @@ Allocating RAM is easy! Just move the sliders to your desired value. You can set
* Windows: `bin/javaw.exe`
* macOS/Linux: `bin/java`
<img src="https://i.imgur.com/t0j9iOp.png" width="75%" height="75%" alt="Java Settings">
#### Built-In Java Handling
The launcher automatically discovers valid installations of Java on your computer. If you do not have a valid installation, the launcher will prevent the game from launching. WesterosCraft requires **Java 8 x64 greater than update 52**.
The launcher will give you the option to automatically download a valid version of Java if it fails to find one. It will download it to `.westeroscraft/runtime/x64` as a local installation (only for the launcher). **We recommend using this option.**
**Why is Java 10+ not supported?** Forge and LaunchWrapper [only support Java 8](https://github.com/Mojang/LegacyLauncher/pull/11).
#### Manually Installing a Valid Version of Java
If you want to manually install Java rather than having the launcher do it for you, follow these steps.
* Download Java 8 x64
* Windows/macOS
* Download from [Oracle](http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html).
* For Windows: Windows x64 (`jre-8uVERSION-windows-x64.exe`)
* For macOS: Mac OS X x64 (`jre-8uVERSION-macosx-x64.dmg`)
* Linux:
* OpenJDK (recommended): `$ sudo apt-get install openjdk-8-jre`
* Oracle: [Instructions](https://java.com/en/download/help/linux_x64_install.xml)
* Follow on-screen instructions.
* Try to launch the game again, the launcher should find the version you just installed. If it does not, try setting the value manually.
<img src="https://i.imgur.com/t0j9iOp.png" width="75%" height="75%" alt="Java Executable">
---
@ -78,7 +86,7 @@ If you want to manually install Java rather than having the launcher do it for y
Advanced use only. Do not specify `-Xmx` or `-Xms` here. These values are modified by the memory sliders.
<img src="https://i.imgur.com/vO2eWku.png" width="75%" height="75%" alt="Java Settings">
<img src="https://i.imgur.com/vO2eWku.png" width="75%" height="75%" alt="JVM Arguments">
Available Arguments:
* [Windows](https://docs.oracle.com/javase/8/docs/technotes/tools/windows/java.html)