Options > Video Settings from the title screen, __not__ in the world.
-Otherwise, go to your [.minecraft folder](#find-minecraft), open options.txt and change the value next to gamma to 5.0. This is the highest value allowed for speedrunning.
+Otherwise, go to your [.minecraft folder](#find-minecraft), open options.txt and change the value next to gamma to 5.0, or follow [the setup guide](#setup-setup) for a guide on setting up mods.
## How do I allocate more RAM to Minecraft? {#allocate-ram}
-If you’re on Prism or MultiMC:
+If you're on Prism or MultiMC:
- Go to Settings > Java and set the maximum memory allocation to somewhere around 3000.
- 
+
-If you’re on the default launcher (though the default RAM allocation is fine):
+If you're on the default launcher (though the default RAM allocation is fine):
-1. Go to Installations, find the installation you’re using and click the “...” button. Click “Edit”.
+1. Go to Installations, find the installation you're using and click the "..." button. Click "Edit".
+
- 
+
-1. Click “More Options”, then adjust the number after -Xmx.
- - You can change “G” to “M” to edit in terms of MB instead of GB.
+1. Click "More Options", then adjust the number after -Xmx.
+ - You can change "G" to "M" to edit in terms of MB instead of GB.
+
- 
+
-
+
Do not allocate too much RAM since [it may cause lag spikes](https://vazkii.net/blog_archive/"%20\l%20"blog/ram-explanation).
@@ -137,35 +129,35 @@ Do not allocate too much RAM since [it may cause lag spikes](https://vazkii.net/
On Windows:
-1. For Windows 10, press the Start button and type “Graphics settings”. Under Graphics performance preference, click “Browse”. For Windows 11, under Graphics performance preference, click "Add desktop app."
+1. For Windows 10, press the Start button and type "Graphics settings". Under Graphics performance preference, click "Browse". For Windows 11, under Graphics performance preference, click "Add desktop app."
+
-
+
- 
+
-2. Select the javaw.exe that Minecraft is using, and set it to “High performance”.
+2. Select the javaw.exe that Minecraft is using, and set it to "High performance".
-If you don’t know where to find javaw.exe,
+If you don't know where to find javaw.exe,
-If you’re on Prism/MultiMC:
+If you're on Prism/MultiMC:
-- Go to Edit (instance) > Settings > Java, and copy the path in “Java path”.
+- Go to Edit (instance) > Settings > Java, and copy the path in "Java path".
-If you’re on the default launcher:
+If you're on the default launcher:
-- Go to Installations, find the installation you’re using and click the “...” button. Click “Edit”, then “More Options”. Copy the path in “Java executable”.
+- Go to Installations, find the installation you're using and click the "..." button. Click "Edit", then "More Options". Copy the path in "Java executable".
Alternatively, you can follow steps 1-5 of [this guide](https://obsproject.com/kb/minecraft-java-edition-troubleshooting).
-## I have worse performance than expected
+## I have worse performance than expected {#performance}
This is usually caused by one or more of the following issues:
- [Not allocating enough RAM](#allocate-ram)
-- [Using the bundled Java runtime](#update-java)
-- [Using the integrated GPU](#use-dgpu) (if you have multiple GPUs) for the Java version you’re using
+- [Using Java 8 instead of 17+](#update-java)
+- [Using the integrated GPU](#use-dgpu) (if you have multiple GPUs) for the Java version you're using
-## How do I add custom commands like `!elo` on Twitch?
+## How do I add custom commands like `!elo` on Twitch? {#elo-command}
OshBot has some commands for Ranked like `+elo`, see [its documentation](https://bot.osh.gay/ranked/elo).
@@ -189,94 +181,172 @@ $(eval r=$(customapi
+
+ 
+
+
+## Water is invisible / block textures don't display properly {#multidraw}
E.g.:
+
- 
+
In the title screen, go to Options > Click the Book & Quill (top right) > Sodium and disable "Use Chunk Multi-Draw".
::: info
- Chunk Multidraw is a Sodium option that boosts performance. On a small percentage of GPUs, it will cause this issue, so you will have to disable it if you’re having this issue.
+ Chunk Multidraw is a Sodium option that boosts performance. On a small percentage of GPUs, it will cause this issue, so you will have to disable it if you're having this issue.
:::
-## I can’t increase my render distance beyond 16 (or some other number)
+## I can't increase my render distance beyond 16 (or some other number) {#rd-cap-16}
[Allocate more RAM](#allocate-ram).
-## Blocks don’t drop / entities are frozen
+## Blocks don't drop / entities are frozen {#ghost-nether}
+
+(also referred to as an "internal server crash"; it's in this section because the game doesn't force quit like most crashes)
+
+This is known as a ghost nether or phantom nether. Once you get this, if it isn't just Minecraft lagging a lot, there's nothing you can do about it, since you've basically crashed (so you'll need to restart Minecraft).
+
+You can help us determine the cause of this issue. If you experience this, paste your [log file](#crashes) in #bug-report in the [Ranked discord server](https://discord.mcsrranked.com/).
+
+## Ninjabrain Bot appears like a zip file, double-clicking it doesn't run it {#jarfix}
+
+If you're having issues with .jar programs on Windows, download and run **Jarfix.exe** from [this page](https://github.com/qMaxXen/Jarfix/releases/latest).
-(also referred to as an “internal server crash”; it's in this section because the game doesn’t force quit like most crashes)
+## MiniPracticeKit doesn't work {#mpkdebug}
-This is known as a ghost nether or phantom nether, and usually occurs when you change dimensions. Once you get this, there’s nothing you can do about it, since you’ve basically crashed (so you’ll need to restart Minecraft).
+To troubleshoot MiniPracticeKit not working, please verify the following:
+- A file that's at least 20 KB named **exactly** "hotbar" or "hotbar.nbt", __not__ "hotbar (1).nbt" or similar, exists in your .minecraft folder.
+- You are pressing your **Hotbar slot 1** hotkey while holding your **Load hotbar** hotkey, and both of these aren't conflicting with other hotkeys.
-You can help us determine the cause of this issue. If you experience this, paste your [log file](#crashes) in #bug-report in the [Ranked discord server](https://discord.gg/nnjUSyDErj).
+## I can't press F3 without holding Fn / some F3 keys don't work {#fnlock}
-## I was teleported immediately after entering the nether (and took some fall damage / can't find my nether portal)
+Toggle Fn-lock on your pc
+
- 
+
-- If you’re on a different launcher, [go to your .minecraft folder](#find-minecraft) > logs and select latest.log. Send this file in #tech-help:
+- If you're on a different launcher, [go to your .minecraft folder](#find-minecraft) > logs and select latest.log. Send this file:
+
- 
+
- The crash report can sometimes be found in .minecraft/crash-reports, with the date of the crash in its file name. It contains a little more information about the crash itself, but the log file is usually sufficient to diagnose issues.
-- If there’s an error message, sending a screenshot of that would be helpful too, in case there isn’t a crash report generated.
+- If there's an error message, sending a screenshot of that would be helpful too, in case there isn't a crash report generated.
-The following sections will go through common crashes. “Symptoms” means things to look for if you’re not sure what crash it is.
+The following sections will go through some issues. "Symptoms" means things to look for if you're not sure what crash it is. This is mostly included for those who may be interested; it's not meant to be extensive, and the above is a way better way to diagnose a crash.
+
+## Exit codes
+
+Exit codes in log files are never sufficient to diagnose the problem. If you get a crash, please [send the full log](#crashes) when asking for help and not just the exitcode.
## Outdated Java version
Symptoms in the log file:
-- “Java is version 1.8” under “Checking Java version…”
-- “- java 8” under “Loading mods”
-- “UnsupportedClassVersionError” followed by “has been compiled by a more recent version of the Java Runtime”
+- "Java is version 1.8" under "Checking Java version…"
+- "- java 8" under "Loading mods"
+- "UnsupportedClassVersionError" followed by "has been compiled by a more recent version of the Java Runtime"
Explanation:
@@ -290,11 +360,11 @@ Fix:
Symptoms in the log file:
-- “Error occurred during initialization of VM” followed by “Could not reserve enough space for \[memory allocated\] object heap”
+- "Error occurred during initialization of VM" followed by "Could not reserve enough space for \[memory allocated\] object heap"
Explanation:
-- You can’t allocate RAM above a certain amount if you use 32-bit Java.
+- You can't allocate RAM above a certain amount if you use 32-bit Java.
Fix:
@@ -304,55 +374,55 @@ Fix:
Symptoms:
-- In the default launcher: Error message mentioning “Your Java Runtime is incompatible. Please edit your installation to use the bundled Java Runtime. Name: Java version mismatch”
+- In the default launcher: Error message mentioning "Your Java Runtime is incompatible. Please edit your installation to use the bundled Java Runtime. Name: Java version mismatch"
+
- 
+
-- In Prism launcher: “This instance is not compatible with Java version…”
+- In Prism launcher: "This instance is not compatible with Java version…"
Explanation:
-- Minecraft doesn’t like it when you change your java version.
+- Minecraft doesn't like it when you change your Java version.
Fix (default launcher):
-- Watch [this video](https://youtu.be/HEtqR74M-_w). Read the pinned comment if you’re on the Windows store version of the launcher. You’ll have to do this every time the launcher updates.
+- Watch [this video](https://youtu.be/HEtqR74M-_w). Read the pinned comment if you're on the Windows store version of the launcher. You'll have to do this every time the launcher updates.
Fix (Prism Launcher):
-- Go to Settings > Java > enable Skip Java compatibility checks.
+- Go to Edit > Settings > Java > enable Skip Java compatibility checks.
## Incompatible mods, outdated mods, or mods with dependencies
Symptoms:
-- Error message mentioning “Incompatible mod set found!”, followed by a list of mods stating they are “not whitelisted”
+- Error message mentioning "Incompatible mod set found!", followed by a list of mods stating they are "not whitelisted"
Explanation:
-- The ranked mod is only compatible with specific whitelisted mods to prevent cheating, and only specific versions of these mods are whitelisted. See the [list of allowed mods](https://mods.tildejustin.dev) for more details.
+- The ranked mod is only compatible with specific whitelisted mods to prevent cheating, and only specific versions of these mods are whitelisted. See the [list of allowed mods](https://mc.sr/mods) for more details.
Fix:
-- Refer to the error message; it will tell you which mods are not whitelisted and whether a different version of a mod you’re using is whitelisted. Remove the mods that are not whitelisted and [update](https://mods.tildejustin.dev/) the mods that the error message tells you to update.
-- If you are still confused, it's possible that some mods just recently got updated and haven't been updated yet. Feel free to send a screenshot of the error message in #tech-help for help.
+- Refer to the error message; it will tell you which mods are not whitelisted and whether a different version of a mod you're using is whitelisted. Remove the mods that are not whitelisted and [update](https://mc.sr/mods/) the mods that the error message tells you to update.
+- If you are still confused, it's possible that some mods just recently got updated and haven't been updated yet. Feel free to send a screenshot of the error message in #public-help for help.
## Too little RAM allocated (usually only on MultiMC)
Symptoms in the log file:
-- “OutOfMemoryError: Java heap space” (This error may also indicate a memory leak. Check your RAM allocation to determine which is more likely.)
+- "OutOfMemoryError: Java heap space" (This error may also indicate a memory leak. Check your RAM allocation to determine which is more likely.)
Symptoms in the crash report:
-- In “Memory” under “System Details”, there are three numbers in brackets. If the latter two are “1024 MB” or any number less than 1900 MB\*, you may have this issue.
- - \*If you are using Shenandoah GC and know what you are doing, having a lower memory allocation is fine, as long as it’s not too low (<1200 MB)
+- In "Memory" under "System Details", there are three numbers in brackets. If the latter two are "1024 MB" or any number less than 1900 MB\*, you may have this issue.
+ - \*If you are using Shenandoah GC and know what you are doing, having a lower memory allocation is fine, as long as it's not too low (<1200 MB)
Explanation:
-- By default, MultiMC allocates 1024 MB of RAM to Minecraft. This was sufficient for Minecraft versions before 1.13, but for anything after that, 1024 MB is too low. It should be set to somewhere from 2000 MB to 3000 MB, [but not too high](https://vazkii.net/blog_archive/"%20\l%20"blog/ram-explanation). You only really need a high RAM allocation (2800-3000) if you play on 32 render distance (possibly because you’re speedrunning All Advancements).
+- By default, MultiMC allocates 1024 MB of RAM to Minecraft. This was sufficient for Minecraft versions before 1.13, but for anything after that, 1024 MB is too low. It should be set to somewhere from 2000 MB to 3000 MB, [but not too high](https://vazkii.net/blog_archive/"%20\l%20"blog/ram-explanation). You only really need a high RAM allocation (2800-3000) if you play on 32 render distance (possibly because you're speedrunning All Advancements).
Fix:
@@ -362,7 +432,7 @@ Fix:
Symptoms in the log file:
-- “OneDrive” mentioned basically anywhere
+- "OneDrive" mentioned basically anywhere
Explanation:
@@ -376,8 +446,8 @@ Fix:
Symptoms in the log file:
-- “OutOfMemoryError” (This error may also be caused by allocating too little RAM. Check your RAM allocation to determine which is more likely.)
-- “There is insufficient memory for the Java Runtime Environment to continue”
+- "OutOfMemoryError" (This error may also be caused by allocating too little RAM. Check your RAM allocation to determine which is more likely.)
+- "There is insufficient memory for the Java Runtime Environment to continue"
Other symptoms:
@@ -389,7 +459,7 @@ Explanation:
Fix:
-- Assuming the memory leak is caused by Sodium, replace Sodium with a version downloaded from [this website](https://mods.tildejustin.dev/) after selecting Mac.
+- Assuming the memory leak is caused by Sodium, replace Sodium with a version downloaded from [this website](https://mc.sr/mods/) after selecting Mac.
## Resizing the window to a large height
@@ -409,8 +479,8 @@ Fix:
Symptoms in the log file:
-- “A fatal error has been detected by the Java Runtime Environment” followed by “EXCEPTION_ACCESS_VIOLATION”
-- “.minecraft\\hs_err_pid<id>.log”, where <id> is a few numbers
+- "A fatal error has been detected by the Java Runtime Environment" followed by "EXCEPTION_ACCESS_VIOLATION"
+- ".minecraft\\hs_err_pid<id>.log", where <id> is a few numbers
Other symptoms:
@@ -422,7 +492,7 @@ Explanation and fix: this crash may be caused by one of the following –
- Try using window capture instead of game capture in OBS.
- Try disabling hardware acceleration in Discord.
- If you're on a laptop, [make sure](#use-dgpu) Minecraft is using the dedicated GPU if you have one.
-- A compatibility issue between SpeedrunIGT, Intel Graphics and OpenGL. Enable “safe font mode” in SpeedrunIGT options. If the game crashes before you can access that menu, delete .minecraft/speedrunigt.
+- A compatibility issue between SpeedrunIGT, Intel Graphics and OpenGL. Enable "safe font mode" in SpeedrunIGT options. If the game crashes before you can access that menu, delete .minecraft/speedrunigt.
- Driver issues. Check if your drivers are updated, and update them or downgrade them if they're already updated.
Generally, JVM crashes are difficult to diagnose, so there's not much we can help with if it isn't caused by one of the above issues.
@@ -431,31 +501,40 @@ Generally, JVM crashes are difficult to diagnose, so there's not much we can hel
Symptoms in the log file:
-- “ConcurrentModificationException”, optionally accompanied with “Exception loading structure” or “StructureManager”
+- "ConcurrentModificationException", optionally accompanied with "Exception loading structure" or "StructureManager"
Explanation:
-- CMEs are rare crashes that are basically caused by RNG. There is a fix for a specific CME in StructureManager in Java 11+ (see below), which crashes with “Exception loading structure” or with a mention of “StructureManager”.
+- CMEs are rare crashes that are basically caused by RNG. There is a fix for a specific CME in StructureManager in Java 11+ (see below), which crashes with "Exception loading structure" or with a mention of "StructureManager".
Fix:
- Add [Voyager](https://github.com/modmuss50/Voyager/releases/tag/1.0.0) to your mods folder (you should do this regardless of whether you experienced this crash, so that future crashes may be prevented).
-## UnknownHostException {#unknownhostexception}
+## Network issues {#network}
Symptoms in the log file:
-- “UnknownHostException: No such host is known (mcsrranked.com)”
+- "UnknownHostException: No such host is known (mcsrranked.com)"
+- "java.net.SocketTimeoutException: Connect timed out"
Explanation:
-- Something on your end (network, firewall, antivirus, etc.) is blocking the ranked mod from working.
+- Something on your end (network, firewall, antivirus, etc.) is blocking the Ranked mod from working.
Fix:
+- If you are from Russia, this is almost definitely due to internet censorship. People have reported that adding mcsrranked.com to zapret's lists/list-general.txt has fixed their issue.
+- Try again later.
- Check if your firewall/antivirus is blocking mcsrranked.com.
-- If it’s not a firewall/antivirus issue, [change your DNS provider](https://developers.google.com/speed/public-dns/docs/using"%20\l%20"windows) or use a VPN.
-
-## Exit codes
-
-Exit codes in log files usually aren’t sufficient to diagnose the problem.
+- Try [changing your DNS provider](https://developers.google.com/speed/public-dns/docs/using"%20\l%20"windows).
+- Try using a VPN/proxy.
+- Try rebooting your PC.
+- Try rebooting your router.
+- [Make sure ipv6 works fine](https://test-ipv6.com/), if not, [try disabling it](https://www.google.com/search?q=how+to+disable+ipv6+on+windows).
+- On Windows, run these 3 commands in cmd launched as admin:
+
+
ipconfig /flushdns,
+netsh interface ip reset,
+netsh winsock reset;
+and reboot afterwards.
+- Try using a different network.
diff --git a/docs/install/img/folderinafolder.png b/docs/install/img/folderinafolder.png
new file mode 100644
index 00000000..4795a8fd
Binary files /dev/null and b/docs/install/img/folderinafolder.png differ
diff --git a/docs/install/img/title_menu.png b/docs/install/img/title_menu.png
deleted file mode 100644
index 6994262f..00000000
Binary files a/docs/install/img/title_menu.png and /dev/null differ
diff --git a/docs/install/index.md b/docs/install/index.md
index 12101ecb..8c1cca57 100644
--- a/docs/install/index.md
+++ b/docs/install/index.md
@@ -1,7 +1,7 @@
# Installation Guide
::: tip
- đź’¬ Having issues? Check [this document](./faq) or feel free to ask in our [Discord server](https://mcsrranked.com/discord) in the #public-help channel.
+ đź’¬ Having issues? Check [this document](./faq) or feel free to ask in our [Discord server](https://discord.mcsrranked.com) in the #public-help channel.
:::
You can play with the MCSR Ranked mod on most popular launchers.
@@ -15,7 +15,7 @@ You can play with the MCSR Ranked mod on most popular launchers.
::: warning
- Cracked launchers/accounts are **not** supported and will **not** work.
- Clients that modify the game like Lunar are **not** allowed.
-- You can only use mods that [are allowed](https://mods.tildejustin.dev/) for speedrun.com.
+- You can only use mods that [are allowed](https://mc.sr/mods/) for speedrun.com.
:::
âś… **Installation Method**:
diff --git a/docs/install/install_modrinth.md b/docs/install/install_modrinth.md
index e44e9ff7..dbc80a84 100644
--- a/docs/install/install_modrinth.md
+++ b/docs/install/install_modrinth.md
@@ -5,5 +5,5 @@ We recommend using the official modpack, which includes other allowed QoL and pe
Then, open Modrinth App, and go to `Create New Instance`, select `From File`, and choose the `.mrpack` file. Finally, launch your new instance.
-## (Advanced) Update Java
-TO-DO
+## Updating Java
+It is generally recommended that you update your Java version for better performance, mod compatibility, and to fix some issues. To do this, follow [this guide](https://youtu.be/XeVKnvYEVSg).
\ No newline at end of file
diff --git a/docs/install/install_vanilla.md b/docs/install/install_vanilla.md
index 780cf43d..4788d9e9 100644
--- a/docs/install/install_vanilla.md
+++ b/docs/install/install_vanilla.md
@@ -16,8 +16,8 @@ You do **NOT** need Fabric API, it is banned and none of the allowed mods use it
:::
## Download the mods
-Download the MCSR Ranked mod from [the Modrinth page](http://modrinth.com/mod/mcsr-ranked)
-Additionally, it is recommended to get other allowed mods from https://mods.tildejustin.dev/.
+Download the MCSR Ranked mod from [the Modrinth page](https://modrinth.com/mod/mcsr-ranked)
+Additionally, it is recommended to get other allowed mods from https://mc.sr/mods/.
Under Launcher > Installations
 Create a new folder named "mcsr ranked" in this directory, and create a folder named "mods" inside that,