End user wiki Update (#48)

* - Split Superseded list into categories
- Added Warning for Celeritas incompat
- Extended superseded list
- Improved Args page
- Added macOS warning

* Added more linespaces

* Changed br/ to br :)

* Further PR changes

* No more JourneyMap to Xaero :c

* smol typo

* dot

* Fix companion mods

* Extended Companion list

* Typo 2

* Add clarification

* Java instead of javaw for server

* Further List Change

Author: AnasDevO

docs/wiki/end-user-guide/args.md

@@ -6,18 +6,28 @@ title: JVM Arguments
 
 ## Overview
 
-JVM arguments were once crucial for performance optimization in Minecraft when running on older Java versions (such as Java 8).<br/>  
-With modern JVMs (Java 17+), most of these optimizations are no longer necessary, as performance tuning is handled well out of the box.<br/>  
-That said, a few arguments can still provide noticeable improvements.<br/>
-Keep in mind that JVM tuning is **hardware-dependent**: an argument that helps on one system may not yield the same results on another.<br/>
+JVM arguments were once crucial for performance optimization in Minecraft when running on older Java versions (such as Java 8).<br>  
+With modern JVMs (Java 17+), most of these optimizations are no longer necessary, as performance tuning is handled well out of the box.<br>  
+That said, a few arguments can still provide noticeable improvements.<br>
+Keep in mind that JVM tuning is **hardware-dependent**: an argument that helps on one system may not yield the same results on another.<br>
+
+## About Distributions
+
+GraalVM is being discontinued in favor of OpenJDK. We recommend to use [Zulu](https://www.azul.com/downloads/) or [Temurin](https://adoptium.net/temurin/releases?version=25&mode=filter&os=any&arch=any).<br>
 
 ## Useful Arguments
 
-- `-XX:+UnlockExperimentalVMOptions -XX:+UseCompactObjectHeaders` <br/> *Introduced in Java 24.* <br/> Reduces the size of object headers in the JVM from 96–128 bits down to 64 bits, lowering heap usage and potentially improving performance. _Java_ 25 made this a product feature ([See JEP 450](https://openjdk.org/jeps/450)) ([See JEP 519](https://openjdk.org/jeps/519))<br/> 
+::: info Note {id="note"}
+Make sure `-Xms` and `-Xmx` have the same size. This makes sure the JVM does not have to resize, and will avoid OOM crashes (if you're using a launcher, make sure Max ram is equal to Min ram)<br>
+:::
 
-- `-XX:+UseZGC` <br/> Enables the **Z Garbage Collector (ZGC)**, which provides very low latency garbage collection and can virtually eliminate GC pauses. <br/>
+- `-XX:+UseCompactObjectHeaders` <br> Reduces the size of object headers in the JVM from 96–128 bits down to 64 bits, lowering heap usage and potentially improving performance. _Java_ 25 made this a product feature ([See JEP 450](https://openjdk.org/jeps/450)) ([See JEP 519](https://openjdk.org/jeps/519)) 
+
+- `-XX:+UseZGC` <br> Enables the **Z Garbage Collector (ZGC)**, which provides very low latency garbage collection and can virtually eliminate GC pauses. 
 
 ## Notes
-- The latest tested Java version for Cleanroom Loader is **Java 25**, it is recommended to use this version<br/>
-- On older CPUs, **ZGC** can be demanding: it increases RAM usage (since ZGC does not use compressed object pointers) and may reduce performance. <br/> <br/>  Test your game both **with** and **without ZGC**, and compare results. You can revert to Java 24’s default collector (**G1GC**) by removing `-XX:+UseZGC`<br/>
-- The use of `-XX:+ZGenerational` is not required when using ZGC. (It is enabled by default in Java 25)<br/>
+
+- The latest tested Java version for Cleanroom Loader is **Java 25**, it is recommended to use this version, and to always stick to LTS versions.
+- On older CPUs, **ZGC** can be demanding: it increases RAM usage (since ZGC does not use compressed object pointers) and may reduce performance. <br> <br>  Test your game both **with** and **without ZGC**, and compare results. You can revert to Java 25’s default collector (**G1GC**) by removing `-XX:+UseZGC`
+- The use of `-XX:+ZGenerational` is not required when using ZGC. (It is enabled by default in Java 25)
+- Big heaps can only be correctly handled by **ZGC**. If using **G1GC**, make sure to pick reasonable heap sizes (Shouldn't exceed 11-12GB ram)

docs/wiki/end-user-guide/installation/install-client.md

@@ -6,52 +6,58 @@ title: Client
 
 ## How to Install Cleanroom Loader on the Client
 
+::: warning {id="warning"}
+macOS is not well-supported by Cleanroom, and may or may not work for you
+:::
+
 ### About Launchers
 
-The recommended way to run Cleanroom Loader is with a **MultiMC-based launcher**, such as **[Prism Launcher](https://prismlauncher.org/download/windows/)** or **[PolyMC](https://polymc.org/download/)**.<br/>  
-These are officially supported because other launchers may not properly handle the removal of certain vanilla libraries.<br/>
+The recommended way to run Cleanroom Loader is with a **MultiMC-based launcher**, such as **[Prism Launcher](https://prismlauncher.org/download/windows/)** or **[PolyMC](https://polymc.org/download/)**.<br>  
+These are officially supported because other launchers may not properly handle the removal of certain vanilla libraries.<br>
 
 ### Manual Install
 
 ::: info Note {id="note"}
 Importing Cleanroom Loader instance is only supported on MultiMC-based launchers. For other launchers, use the installer jar.
 :::
 Steps:
-1. Add [Fugue](https://www.curseforge.com/minecraft/mc-mods/fugue) to your mod folder<br/>
-   *(it will not load in a Forge environment)*<br/>
-2. Add [Scalar Legacy](https://www.curseforge.com/minecraft/mc-mods/scalar-legacy) to your mod folder<br/>
-   *(it will not load in a Forge environment)*<br/>
-3. :warning: **Warning:** Make sure your instance does not include problematic or deprecated mods.<br/>
-   See [Preparing your modpack](/wiki/end-user-guide/preparing-your-modpack) for more details.<br/>
-4. Download the `Cleanroom-MMC-instance-` archive from the [Releases page](https://github.com/CleanroomMC/Cleanroom/releases).<br/>
-5. Import it into your launcher.<br/>
-   *(Alternatively, unzip the patches and JSON files into an existing 1.12 instance.)*<br/>
-6. In your launcher, select the `javaw.exe` path of your **Java 25 installation**. (`javaw.exe` will not produce any command-line output and it the one that should be used in normal cases, while `java.exe` will produce a command-line output)<br/>
-7. *(Optional)* Add JVM arguments as described in the [JVM Arguments](/wiki/end-user-guide/args) section.<br/>
+1. Add [Fugue](https://www.curseforge.com/minecraft/mc-mods/fugue) to your mod folder<br>
+   *(it will not load in a Forge environment)*
+2. Add [Scalar Legacy](https://www.curseforge.com/minecraft/mc-mods/scalar-legacy) to your mod folder<br>
+   *(it will not load in a Forge environment)*
+3. :warning: **Warning:** Make sure your instance does not include problematic or deprecated mods.<br>
+   See [Preparing your modpack](/wiki/end-user-guide/preparing-your-modpack) for more details.
+4. Download the `Cleanroom-MMC-instance` archive from the [Releases page](https://github.com/CleanroomMC/Cleanroom/releases).
+5. Import it into your launcher.<br>
+   *(Alternatively, unzip the patches and JSON files into an existing 1.12 instance.)*
+6. In your launcher, select the `javaw.exe` path of your **Java 25 installation**. (`javaw.exe` will not produce any command-line output and it the one that should be used in normal cases, while `java.exe` will produce a command-line output)
+7. *(Optional)* Add JVM arguments as described in the [JVM Arguments](/wiki/end-user-guide/args) section.
+8. Copy over the `/.minecraft` folder (can also be named `/minecraft` folder) from your modpack over to your Cleanroom instance.
 
 ### Cleanroom Relauncher
 
-**Cleanroom Relauncher** is a <ins>**Client-side**</ins> mod that allows you to start a Forge 1.12.2 instance and seamlessly switch to Cleanroom Loader.<br/>  
-This is particularly useful for **modpack authors** who want to distribute Forge-compatible packs that can also run on Cleanroom.<br/>
-It is supported in both MultiMC-based launchers and standard launchers.<br/>
+**Cleanroom Relauncher** is a <ins>**Client-side**</ins> mod that allows you to start a Forge 1.12.2 instance and seamlessly switch to Cleanroom Loader.<br>  
+This is particularly useful for **modpack authors** who want to distribute Forge-compatible packs that can also run on Cleanroom.<br>
+It is supported in both MultiMC-based launchers and standard launchers.<br>
 Steps:
-1. Add [Fugue](https://www.curseforge.com/minecraft/mc-mods/fugue) to your modlist<br/>  
-   *(it will not load in a Forge environment)*<br/>
-2. Add [Scalar Legacy](https://www.curseforge.com/minecraft/mc-mods/scalar-legacy) to your modlist<br/>  
-   *(it will not load in a Forge environment)*<br/>
-3. :warning: **Warning:** Ensure your instance does not contain problematic or deprecated mods.<br/>  
-   See [Preparing your modpack](/wiki/end-user-guide/preparing-your-modpack) for details.<br/>
-4. Add the [Cleanroom Relauncher](https://www.curseforge.com/minecraft/mc-mods/cleanroom-relauncher) mod to your modlist and launch the game with **Java 8**.<br/>
-5. In the Cleanroom Relauncher GUI, select the `javaw.exe` path of your **Java 25 installation**. (`javaw.exe` will not produce any command-line output and it the one that should be used in normal cases, while `java.exe` will produce a command-line output)<br/>
-6. *(Optional)* Add JVM arguments from the [JVM Arguments](/wiki/end-user-guide/args) section.<br/>
-7. Click **Relaunch**.<br/>
+1. Add [Fugue](https://www.curseforge.com/minecraft/mc-mods/fugue) to your modlist<br>  
+   *(it will not load in a Forge environment)*
+2. Add [Scalar Legacy](https://www.curseforge.com/minecraft/mc-mods/scalar-legacy) to your modlist<br>  
+   *(it will not load in a Forge environment)*
+3. :warning: **Warning:** Ensure your instance does not contain problematic or deprecated mods.<br>  
+   See [Preparing your modpack](/wiki/end-user-guide/preparing-your-modpack) for details.
+4. Add the [Cleanroom Relauncher](https://www.curseforge.com/minecraft/mc-mods/cleanroom-relauncher) mod to your modlist and launch the game with **Java 8**.
+5. In the Cleanroom Relauncher GUI, select the `javaw.exe` path of your **Java 25 installation**. (`javaw.exe` will not produce any command-line output and it the one that should be used in normal cases, while `java.exe` will produce a command-line output)
+6. *(Optional)* Add JVM arguments from the [JVM Arguments](/wiki/end-user-guide/args) section.
+7. Click **Relaunch**.
 
 ## Notes
-- Cleanroom Relauncher’s configuration file can be found at `config/relauncher.cfg`. <br/> Deleting this file will prompt the setup GUI on the next launch.<br/>
+
+- Cleanroom Relauncher’s configuration file can be found at `config/relauncher.cfg`. <br> Deleting this file will prompt the setup GUI on the next launch.<br>
   ::: info Note {id="note"}
   Cleanroom Relauncher will check for cleanroom updates. Therefore, the UI will launch when an update rolls out.
   :::
-- :warning: **Warning:** Not all launchers are compatible with Cleanroom Loader. <br/> Supported launchers:
-    - :white_check_mark: MultiMC-based launchers (**Prism Launcher, PolyMC, etc.**)<br/>
-    - :warning: CurseForge Launcher *(limited support)*<br/>
-    - :warning: Official Minecraft Launcher *(limited support)*<br/>
+- :warning: **Warning:** Not all launchers are compatible with Cleanroom Loader. <br> Supported launchers:
+    - :white_check_mark: MultiMC-based launchers (**Prism Launcher, PolyMC, etc.**)
+    - :warning: CurseForge Launcher *(limited support)*
+    - :warning: Official Minecraft Launcher *(limited support)*

docs/wiki/end-user-guide/installation/install-server.md

@@ -8,19 +8,19 @@ title: Server
 
 ### Steps
 
-1. Delete the `libraries` folder inside your server directory.<br/>
-2. :warning: **Warning:** Ensure your server modlist does not include problematic or deprecated mods.<br/>
-   See [Preparing your modpack](/wiki/end-user-guide/preparing-your-modpack) for more details.<br/>
-3. Download the latest `cleanroom-x.x.x-installer.jar` from the [Releases page](https://github.com/CleanroomMC/Cleanroom/releases) and run it.<br/>
-4. In the installer GUI, select **Install server** and choose your server’s directory.<br/>
-5. Add [Fugue](https://www.curseforge.com/minecraft/mc-mods/fugue) to your mod folder<br/>
-   *(it will not load in a Forge environment)*<br/>
-6. Add [Scalar Legacy](https://www.curseforge.com/minecraft/mc-mods/scalar-legacy) to your mod folder<br/>
-   *(it will not load in a Forge environment)*<br/>
-7. *(Optional)* Add JVM arguments to your server’s launch file as described in the [JVM Arguments](/wiki/end-user-guide/args) section.<br/>
+1. Delete the `libraries` folder inside your server directory.
+2. :warning: **Warning:** Ensure your server modlist does not include problematic or deprecated mods.<br>
+   See [Preparing your modpack](/wiki/end-user-guide/preparing-your-modpack) for more details.
+3. Download the latest `cleanroom-x.x.x-installer.jar` from the [Releases page](https://github.com/CleanroomMC/Cleanroom/releases) and run it.
+4. In the installer GUI, select **Install server** and choose your server’s directory.
+5. Add [Fugue](https://www.curseforge.com/minecraft/mc-mods/fugue) to your mod folder<br>
+   *(it will not load in a Forge environment)*
+6. Add [Scalar Legacy](https://www.curseforge.com/minecraft/mc-mods/scalar-legacy) to your mod folder<br>
+   *(it will not load in a Forge environment)*
+7. *(Optional)* Add JVM arguments to your server’s launch file as described in the [JVM Arguments](/wiki/end-user-guide/args) section.
 
 ## Notes
 
 - On Windows, you can point to modern Java executables either by updating your **Environment Variables** or by specifying the full path between double quotes in the Launch bat, e.g.:  
-  `"C:/Program Files/.../bin/javaw.exe"`<br/>
-- On Linux, you can use `SDKMAN!` to manage your java versions.<br/>
+  `"C:/Program Files/.../bin/java.exe"`
+- On Linux, you can use `SDKMAN!` to manage your java versions.

docs/wiki/end-user-guide/introduction.md

@@ -5,11 +5,16 @@ title: Introduction
 # Cleanroom Loader
 
 ## Overview
-**Cleanroom Loader** is a modern fork of Forge for Minecraft **1.12.2**, designed to bring the game up to date with current technology while improving performance, load times and compatibility.<br/>
+
+**Cleanroom Loader** is a modern fork of Forge for Minecraft **1.12.2**, designed to bring the game up to date with current technology while improving performance, load times and compatibility.<br>
+
 ### Key Features
-- **Java 25 support** – run Minecraft with the latest Java versions.<br/>
-- **Upgraded LWJGL3** – benefit from modern rendering and input handling.<br/>
-- **Extended compatibility** – includes patches that allow nearly ≈99% Forge mods to run smoothly.<br/>
+
+- **Java 25 support** – run Minecraft with the latest Java versions.
+- **Upgraded LWJGL3** – benefit from modern rendering and input handling.
+- **Extended compatibility** – includes patches that allow nearly ≈99% Forge mods to run smoothly.
+
 ### Planned Features
-- **Modular Render System** – a complete rework of the rendering pipeline. [See Kirino discussion](https://github.com/CleanroomMC/Cleanroom/discussions/405).<br/>
-- **Improved APIs** – practical, developer-friendly APIs under active development. [See Project board](https://github.com/orgs/CleanroomMC/projects/4/).<br/>
+
+- **Modular Render System** – a complete rework of the rendering pipeline. [See Kirino discussion](https://github.com/CleanroomMC/Cleanroom/discussions/405).
+- **Improved APIs** – practical, developer-friendly APIs under active development. [See Project board](https://github.com/orgs/CleanroomMC/projects/4/).