diff --git a/docs/contributing/_category_.json b/docs/contributing/_category_.json index 24ebef2..066c60f 100644 --- a/docs/contributing/_category_.json +++ b/docs/contributing/_category_.json @@ -1,5 +1,5 @@ { - "position": 4, + "position": 7, "label": "Contributions", "collapsible": false, "link": { diff --git a/docs/faq/_category_.json b/docs/faq/_category_.json new file mode 100644 index 0000000..7155034 --- /dev/null +++ b/docs/faq/_category_.json @@ -0,0 +1,8 @@ +{ + "position": 4, + "label": "Frequently Asked Questions", + "collapsible": true, + "link": { + "type": "generated-index" + } +} diff --git a/docs/faq/game-related.mdx b/docs/faq/game-related.mdx new file mode 100644 index 0000000..0da02b5 --- /dev/null +++ b/docs/faq/game-related.mdx @@ -0,0 +1,47 @@ +--- +title: Game related +description: Questions about Minecraft - Java Edition (the game) +sidebar_position: 3 +--- + +## How to change the GPU used in the game? +Your Dedicated GPU (dGPU) is more powerful than your Integrated GPU (iGPU). Sometimes it can happen that Windows decides to use iGPU for Minecraft, which significantly degrades the game's performance. Here's how to fix that. + +:::warning + +Use one of the options at a time, not all together!\ +Option B implies that you disabled Option A, and Option C only applies if Option B is not configured. + +And obviously apply these changes with the game closed. + +::: + +### Option A: Force dGPU from the Launcher settings +1. Start the launcher and go to *Launcher Settings* +2. Enable the *Use Dedicated GPU* option +3. Start the game + +You'll see that the game now uses *MinecraftJava.exe* instead of *javaw.exe* + +### Option B: Force dGPU from the Windows settings +1. Follow [this](https://www.youtube.com/watch?v=b-skXHedB78) video or go to Settings -> System -> Display -> Graphics settings +2. You'll see a section that says *Graphics performance preference*, click on browse and look for *javaw.exe* +3. Click add, select *Max performance* for your GPU and click OK + +If you don't know which javaw.exe to select: Start the game -> Then minimize -> Open the Task Manager look for the Java process -> Right click -> Open location and the file that it will show you is the javaw.exe you need to select in step 2 + +### Option C: Force dGPU from your GPU Control Panel +:::note + +Intel doesn't seem to have an option for this, so you'll have to use Option B. AMD seems to but it's not very clear and finally Nvidia that we do have an explanation to give. + +PS: If you don't know which javaw.exe to select: Start the game -> Then minimize -> Open the Task Manager look for the Java process -> Right click -> Open location and the file that it will show you is the javaw.exe you need to select in step 4 + +::: + +1. Press Windows + S to open the search bar and search for *NVIDIA Control Panel* (open it) +2. Select *Manage 3D Settings* -> Select the *Global settings* tab +3. Click on the *Preferred graphics processor* option -> Select *High-performance Nvidia processor* +4. Go to the *Program Settings* tab -> Click on the *Add* button -> Find/Browse on the Add window -> Choose the *javaw.exe* file you found in the Note +5. Choose the *High-performance Nvidia processor* option from the menu +6. Click *Apply* for changes diff --git a/docs/faq/launcher-related.mdx b/docs/faq/launcher-related.mdx new file mode 100644 index 0000000..1810c74 --- /dev/null +++ b/docs/faq/launcher-related.mdx @@ -0,0 +1,161 @@ +--- +title: Launcher related +description: Questions about SKlauncher (the launcher itself) +sidebar_position: 2 +--- + +:::tip + +Before you start looking here, check the following pages first: +- [Installation - Common questions](/getting-started/install#common-questions) +- [Log in](/getting-started/login) + +::: + +## Where is SKlauncher installed? +- Windows: `%APPDATA%\.minecraft` +- Linux: `~/.minecraft` +- macOS: `~/Library/Application Support/minecraft` + +Copy that path according to your OS into the folder address bar to go to that location. + +:::info + +This is actually where Minecraft: Java Edition is ~~installed~~ downloaded. Since SKlauncher doesn't have an installer yet, it's just:\ +\- `\java` (you may find it, but it's useless for you)\ +\- `\.minecraft\sklauncher`\ +\- `\.minecraft\sklauncher-fx.jar`\ +\- *The SKlauncher.exe/.jar you downloaded* + +::: + +## Can I install SKlauncher in another folder? +Yes, just run it with `--workDir` but keep in mind that: +1. Use *absolute paths* because *relative paths* or *current directory* (".") may cause errors. +2. Everything that should go in *[.minecraft](#where-is-sklauncher-installed)* will now be in the workDir you set. +3. If you already had [game directories](#how-does-game-directory-work) defined, you'll have to change them to the new path. + +### Windows +Create a shortcut and edit it to use this launch parameter or run it from the Terminal / CMD: +- Shortcut: Right click on SKlauncher.exe/.jar -> Create shortcut -> Right click on that new shortcut -> Properties -> General tab -> Target: and at the end add `--workDir "C:\Games\SKlauncher"` (like [this](https://i.imgur.com/T1HkqQc.png)). +- CMD: `SKlauncher.exe --workDir "C:\Games\SKlauncher"` or `java.exe -jar SKlauncher.jar --workDir "C:\Games\SKlauncher"` + +### Linux / macOS +Run it from the Terminal: `java -jar SKlauncher.jar --workDir "~/Games/SKlauncher"` + +## Difference between Microsoft and Offline? +Since that's already a bit explained by reading the [Log in](/getting-started/login) guide, let's talk about the key differences in a very simple and summarized way. + +| | Microsoft | SKlauncher | Offline | +|:----------------------------:|:-------------------:|:-----------------------:|:--------------------:| +| Change your skin | Yes | Yes | No | +| Change your cape | Only if you won one | Yes | No | +| Visibility of your skin/cape | Global | SKlauncher players only | No | +| Servers you can join | Any | Offline servers only | Offline servers only | + +This is very summarized even with what is mentioned in the Log in guide. +

+ +Microsoft has the absolute advantage since the only real limit is the [Cape](https://minecraft.wiki/w/Cape).\ +You also show your support for the creators, who have been updating the game for over 15 years and allowing you to play every version to this day. + +## Where can I buy the game? +- You can do it from the [Official Site](https://www.minecraft.net/store/minecraft-java-bedrock-edition-pc) and [Microsoft Store](https://www.microsoft.com/p/apps/9nxp44l49shj) as permanent options (one-time payment). +- You also have the option of the [Xbox Game Pass for PC](https://www.xbox.com/games/store/game-pass-para-pc/cfq7ttc0kgq8) (pay per month) or simply the [Free Trial](https://www.minecraft.net/free-trial) (temporary). + +:::note + +Don't forget to always check that you're buying Minecraft: Java Edition.\ +However, if it hasn't changed, you might see that you're buying Minecraft: Java Edition and Minecraft: Bedrock Edition at the same time. + +::: + +:::danger + +Key selling websites may be an option, but you should be careful from whom you're buying and pray that the key isn't stolen.\ +The latter is a bad thing for both: the creator loses money in analyzing that it's indeed stolen and then your game is taken away from you. + +::: + +## Is SKlauncher piracy? +Since the previous question is about buying the game you'll have this logical question. + +SKlauncher is perfectly legal since all the files come from the official Mojang servers, servers that allow public access and their files are even the ones that have the launch parameters to use.\ +Nothing is re-hosted, much less cracked. Just as the server can change the [online-mode](/troubleshooting/game-related#failed-to-login-invalid-session), the client can enable/disable the demo mode. + +This is how everything is coded, literally the existence of third party launchers is to make things easier (like installing Mod Loaders, Mods, Modpacks, etc.) since you can literally start everything with just a simple .bat / .sh file. + +## Is SKlauncher a virus? +Visit [this](/virus) link for more information, since this is a very complex question to be simplified and answered in simple terms.\ +If you want something short: No! SKlauncher never had, don't have and never will have viruses! + +## Is SKlauncher open source? +Not at the moment, but there are plans for it to be in the future. However the code code isn't obfuscated, so you could decompile it and verify everything for yourself. + +> We would like to go open-source in 2024, but it's not so simple. Many parts of the launcher is not ready for foss, but I would love to make it foss. When I started this project I never intended it to be open-source as you need some sacrifices for it, and back then most of the projects weren't open-source, and a lot still isn't. Just look for paid plugins on spigot, it's closed source and even obfuscated. Does sticking a price makes it safe? No. But yes, java is fully decompilable, and you can read the code pretty close to the original (unless it's obfuscated), there are some launchers that are open-source, there are launchers that are closed source, and bruh, there are launchers that are open source where the source is obfuscated, so it's not really open source. But here you can read the source, while the licenses doesn't allow you to just clone the launcher for your needs. I wouldn't like to see my work where someone just changed it's name and logo, but's thats the price of being open source\ +> \- [Link to message](https://discord.com/channels/141669825129873409/290149381548670976/1191138312392552448) + +PS: Open source doesn't equal security. Not only the platform (GitHub for example) won't warn you "Hey, there's something dangerous here!" but you end up with a false security believing "someone else already checked it". + +## Can I force the Demo mode? +Yes, just run the launcher with `--demo` (if you have skin/cape, it should still be visible). + +## Can I use clients, mods, resource packs, shaders, etc. in SKlauncher? +Yes, everything that works for *Minecraft Launcher* should work in *SKlauncher*. + +The only difference may be the way to install. For example:\ +\- SKlauncher 3.2.x: You can install the Mod Loader from the "Installations Manager" and even install Modpacks. Something that in Minecraft Launcher should be done manually.\ +\- SKlauncher 3.3.x *(Not released yet)*: In addition to the above, you can add Mods, Resource Packs, Shaders and Maps! + +:::info + +Some Clients and maybe Mods may require you to enable *Compatibility Mode* (which disables the SKlauncher skin system). + +And although the [Modding](/category/modding) guide tells you how to install the Mod Loaders, the other things you should search on [Google](https://www.google.com/) / [YouTube](https://www.youtube.com/). But I'll give you some little tips: +- You will find your true game folder by right clicking on the installation you want to play and then click on "Open installation directory" (this is in case you've a [Game Directory](#how-does-game-directory-work) defined). +- Just as the launcher allows you to download from [CurseForge](https://www.curseforge.com/minecraft) or [Modrinth](https://modrinth.com/), you can access both sites to search for the Mods, Resource Packs, Shaders, etc. you're looking for. +- If the guide you're following is for Minecraft Launcher (everything is done manually) you're fine. If it's for another launcher than SKlauncher it might not work. + +::: + +## How does Game Directory work? +If you read about [--workDir](#can-i-install-sklauncher-in-another-folder) you will see that the concept in short is "*I want my .minecraft to actually be in a different place*".\ +But what about installations (or instances if you prefer that name) of the game? What if you want to have your options, worlds, mods, etc. from Release 1.8 separated from Release 1.16.5? That's where setting up a Game Directory comes into play. + +- If the Game Directory isn't set... + - All your worlds, options, mods, etc. are in the same place. +- If the Game Directory is set (reference image below)... + - Most files are still downloaded to your .minecraft, you will even have to install the Mod Loader (Forge / Fabric / Others) there. + - The invididual mods (OptiFine / Sodium / Others), your options, your worlds, your game / crash logs, etc. will be separate. + +![Reference image](/img/faq/launcher-related/gamedir.png) + +:::tip + +As shown in the reference image above, the Game Directory for the Vanilla 1.17.1 installation is set to `"%APPDATA%\.minecraft\skprofiles\Vanilla 1.17.1"` while the one for the Fabric 1.17.1 installation is set to `"%APPDATA%\.minecraft\skprofiles\Fabric 1.17.1"`. + +These folders (skprofiles, Vanilla 1.17.1 and Fabric 1.17.1) were created manually, so you could create them as "Game-Instances", "Custom" and "Example". The only important thing is NOT to put them in game folders (like versions folder). + +:::note + +If you right click on the installation you want to play and then click on "Open installation directory", the folder of your Game Directory will open. + +::: + +## Can I use a different Java for the game? +Of course you can! Edit the installation you want to play with a different Java and in the *More Options* section search for *Java Executable*, click on the folder icon and you will be able to find your *javaw.exe* (Windows) or *java* (Linux / macOS) that you want to use (it can be from Temurin, Liberica or other).\ +If you want to go back to *Use bundled Java runtime*, just delete the entire path you set and let the game decide. + +:::tip + +Don't install one Java for SKlauncher and another Java for the game! Use the extractable version of Java (usually .zip for Windows and .tar.gz for Linux and macOS).\ +This way you can try any Java you want without any problems, because maybe the Java that doesn't allow you to start SKlauncher is the Java that gives you more performance / stability if you use it in the game. + +::: + +## How to uninstall SKlauncher? +Read [this](#where-is-sklauncher-installed) question and delete the mentioned files/folders that are from SKlauncher and you're done.\ +Or also the .minecraft folder, but that's deleting the whole game and not just SKlauncher. + +If your idea is to delete absolutely everything, also uninstall Java.\ +And after all that restart the PC, so you can say that you have "deleted all traces" of Java, SKlauncher and Minecraft: Java Edition. diff --git a/docs/faq/uncategorized.mdx b/docs/faq/uncategorized.mdx new file mode 100644 index 0000000..8c84a63 --- /dev/null +++ b/docs/faq/uncategorized.mdx @@ -0,0 +1,69 @@ +--- +title: Uncategorized +description: Questions that can apply to all of the previous ones +sidebar_position: 4 +--- + +## My question doesn't appear! +1. You can always [join the Discord server](https://skmedix.pl/discord) and use the appropriate channels to ask a question. But before you do that, using the search option in Discord to find answers can save you unnecessary waiting time. + - We only ask you to do 3 things: + - Search if someone else asked the same question and got an answer. + - Formulate your question properly. + - Finally wait patiently for an answer. +2. Search on the Internet because, unless it's a very specific question about SKlauncher, you're likely to find answers to your questions much faster. + - Officially there is [Minecraft Forum](https://www.minecraftforum.net/) and [Minecraft Wiki](https://minecraft.wiki/). + - You can also find much more information on [Google](https://www.google.com/) (or any other search engine) and/or [YouTube](https://www.youtube.com/). + +## Where are the logs located? +The logs about the launcher will always be [where you have .minecraft](/faq/launcher-related#where-is-sklauncher-installed), but the logs about the game will be [where you have your game directory](/faq/launcher-related#how-does-game-directory-work). + +- Launcher: `.minecraft\sklauncher\sklauncher_logs.txt` +- Game: `.minecraft\logs\latest.log` and `.minecraft\crash-reports\crash-YYYY-MM-DD_HH.MM.SS-client.txt` + +:::tip + +You can copy the logs content and paste it in [mclo.gs](https://mclo.gs/), this way you send a link instead of a huge message.\ +Or [upload the files](https://support.discord.com/hc/en-us/articles/25444343291031-File-Attachments-FAQ#h_01J4M00QYZTXY5FV9KDWT05H5T) directly to Discord. + +PS: It might be good to read what the launcher shows you, because if your game crashes and the launcher shows again telling you just that: at the top right you will have 2 buttons, where one of them is to give you the link to the report. + +::: + +### Debug mode +Sometimes you need the logs to show even more information to find the cause of the problem. + +:::warning + +You should do this *only if requested to do it* and **after that revert the changes**. + +::: + +:::danger + +Be careful with the **exposed data**!\ +Debug logs may contain sensitive information including: +- Access tokens and session IDs +- IP addresses and connection details + +Using **[mclo.gs](https://mclo.gs/)** is recommended, **as it automatically censors sensitive data** such as the **access token** (a concern if you're using Microsoft login).\ +But this would only matter to you for the *If you can't start the game or there is a problem inside it...* part. + +::: + +#### If you can't even reach the launcher... +1. [Download](/getting-started/downloads#downloading) the SKlauncher in its .jar version and then start it by Terminal commands: `java -jar SKlauncher.jar` +2. Copy the entire contents of the console and paste it into the Discord chat (when it ends or seems to do nothing more). + +#### If you can't start the game or there is a problem inside it... +1. Start the launcher, go to *Launcher Settings* and enable the *Show Launcher Console* option. Then you'll see that a new tab has been added to the main screen: Launcher Log. Click on it so you can see the logs so far. +2. Edit the installation you're having problems with. Then you must edit in the "More Options" section the following: + - Launcher Visibility: *Keep the launcher open and show game output* + - JVM Arguments: Add at the end `-Xdiag -Dsklauncher.debug=true` (remember there is space between arguments, so first add a space before pasting this) +3. After that you start the game and you'll see the Game Output window and that's it. Reproduce again the problem you're having and send everything. + +:::info + +- The *Launcher Log* tab is the same as the Launcher log file. +- The *Game Output* window looks like the same as sending both Game logs files, but with a bit more information at the beginning (so sending the content of this window should be more than enough). + +::: diff --git a/docs/faq/web-related.mdx b/docs/faq/web-related.mdx new file mode 100644 index 0000000..b8a6dbc --- /dev/null +++ b/docs/faq/web-related.mdx @@ -0,0 +1,49 @@ +--- +title: Web related +description: Questions about the SKlauncher website +sidebar_position: 1 +--- + +:::tip + +Before you start looking here, check the following pages first: +- [Downloading - Common questions](/getting-started/downloads#common-questions) + +::: + +## Can I migrate my Other Launcher account to SKlauncher? +- Yes, just [make your SKlauncher account](/getting-started/register) and when it asks for a username you type the same username you had in *Other Launcher*. + - Obviously it must be the same: going from *TheExample* to *theexample* isn't the same thing. +- You won't lose anything because the UUID will remain the same (unless that *Other Launcher* has a different UUID system). + +## How do I put on a skin or cape? +- If you already have your own skin or cape, simply go to the [customization](https://skmedix.pl/settings/customization) view and upload them in the appropriate fields. Remember to pay attention to the *Slim* field, which can affect the appearance of your skin. +- In case you are still looking for a skin or cape, we recommend using our [skins](https://skmedix.pl/skins) and [capes](https://skmedix.pl/capes) pages respectively, which contain thousands of skins and capes ready to use. + +:::note + +If you're using a Microsoft account, then you'll need to do it from the *[Minecraft Launcher](https://www.minecraft.net/en-us/download)* ([alternative](https://www.minecraft.net/en-us/download/alternative)).\ +But keep in mind the [skins priority](#will-other-players-be-able-to-see-my-skin-and-cape)! + +::: + +## Is it possible to upload transparent skins? +Minecraft: Java Edition doesn't support transparent skins by default, so they will not be visible without the appropriate mods.\ +SKlauncher itself doesn't include a mod for visibility of transparent skins, as we're not modifying the game. However, if you feel the need to do so, nothing prevents you from [finding a suitable mod](/faq/launcher-related#can-i-use-clients-mods-resource-packs-shaders-etc-in-sklauncher). + +## Can I upload an animated cape? +As with the issue of transparent skins, SKlauncher doesn't modify the game itself. And this is necessary for animated skins to be seen in the game world.\ +At the moment, we have no plans to change this. If you want to see an animated cape you will need to [find a suitable mod](/faq/launcher-related#can-i-use-clients-mods-resource-packs-shaders-etc-in-sklauncher). + +## Will other players be able to see my skin and cape? +Yes! If your friends or other players on the server also use SKlauncher then you will all see your skins in the game.\ +Playing with our launcher is a prerequisite. If you've changed your skin and your fellow players don't see it, check if it's visible in your account settings on our website. Also try restarting the game along with the launcher. + +:::info + +No matter if you're using a Microsoft or Offline account, the priority of the skins/capes is the following:\ +1\. SKlauncher\ +2\. Microsoft\ +3\. Dedicated server (some mod or plugin, like SkinsRestorer) + +::: diff --git a/docs/features/skins-support.mdx b/docs/features/skins-support.mdx index f58da69..a569917 100644 --- a/docs/features/skins-support.mdx +++ b/docs/features/skins-support.mdx @@ -3,7 +3,9 @@ title: Skins Support --- :::info TODO + This document is a work in progress. Please help us improve it by contributing! + ::: | Version | Vanilla | Forge | NeoForge | Fabric | Quilt | @@ -77,4 +79,4 @@ This document is a work in progress. Please help us improve it by contributing! | 1.7.4 | | N/A | N/A | N/A | N/A | | 1.7.3 | | N/A | N/A | N/A | N/A | | 1.7.2 | | | N/A | N/A | N/A | -| pre-1.7 | | | N/A | N/A | N/A | \ No newline at end of file +| pre-1.7 | | | N/A | N/A | N/A | diff --git a/docs/getting-started/downloading.mdx b/docs/getting-started/downloading.mdx index 76c8868..051ddc3 100644 --- a/docs/getting-started/downloading.mdx +++ b/docs/getting-started/downloading.mdx @@ -9,22 +9,40 @@ To download and run SKlauncher, you will need to follow these simple steps: ## Downloading :::caution + SKlauncher currently doesn't have an installer for Windows, or any other operating system. + ::: 1. Download the latest version of SKlauncher from [here](https://skmedix.pl/downloads). 2. Select the version of SKlauncher that is compatible with your operating system - If you are using Windows, download the .exe file - - If you are using Linux or Mac OS, download the .jar file + - If you are using Linux or macOS, download the .jar file 3. Follow the instructions to [install SKlauncher](/getting-started/install) -## Common Issues +## Common questions +Some users may have some questions before or after downloading, we'll see the main ones here: + +### Can I use the .jar in Windows? +Of course! + +### What's the difference between .exe and .jar? +The .exe is the .jar converted to .exe using Exe4j, so the only difference is that the .exe will give you an error message if you don't have Java installed/updated (and a nice icon).\ +It can be said that it's to simplify things for Windows users. + +### Is it a virus? +Visit [this](/virus) link for more information, since this is a very complex question to be simplified and answered in simple terms.\ +If you want something short: No! SKlauncher never had, don't have and never will have viruses! +## Common issues Some users may find that they are unable to download SKlauncher, here are some common issues and how to fix them. ### Downloads buttons are not showing up -There are few reason why it may happen, but most common is that you are using adblocker. Please disable it and try again. -If it still doesn't work, try to wait up to 10 minutes on the error screen, it should load after that. +- Disable any ad blockers and refresh the page. + - Also disable auto-translate and anything that can modify the page. +- Try in Incognito mode (Private / InPrivate). +- Try in another web browser like Microsoft Edge, Google Chrome, etc. +- Wait up to 10 minutes at the error screen, the download buttons should load anyway after that wait. ### File is getting downloaded as a .html file This may happen if you're using a download manager. Please disable it and try again. diff --git a/docs/getting-started/installation.mdx b/docs/getting-started/installation.mdx index eeed2f0..37a3d49 100644 --- a/docs/getting-started/installation.mdx +++ b/docs/getting-started/installation.mdx @@ -10,7 +10,9 @@ To run SKlauncher you need to have Java installed on your computer. In this guid For a long time, SKlauncher required Java 8 with JavaFX, but this is no longer the case. Now you can use any version of Java above 11. We recommend using the LTS (Long-term support) version, which is currently Java 21. :::danger + Support for Java 8 with JavaFX will be removed in the future. We recommend using Java 21. + ::: ## Installing Java @@ -21,10 +23,10 @@ Support for Java 8 with JavaFX will be removed in the future. We recommend using 1. Go to [Adoptium](https://adoptium.net/) and click on the **Latest LTS Release** button. 2. Run the installer and follow the instructions. 3. In the *Custom Setup* screen, make sure to select the following options: - - Add to PATH - - Associate .jar - - Set JAVA_HOME variable - - JavaSoft (Oracle) registry key + - Add to PATH + - Associate .jar + - Set JAVA_HOME variable + - JavaSoft (Oracle) registry key 4. Click **Next**, then **Install**. 5. Wait for the installation to finish, then click **Finish**. @@ -50,7 +52,9 @@ sudo pacman -S jdk21-openjdk ### Java 8 with JavaFX :::caution + Sometimes your Java 8 may be too old to run SKlauncher. In this case, you need to update it. + ::: If you can't use Java 21, you can use Java 8 with JavaFX. We recommend using either: @@ -58,27 +62,73 @@ If you can't use Java 21, you can use Java 8 with JavaFX. We recommend using eit - [Liberica 8 Full JDK](https://bell-sw.com/pages/downloads/#jdk-8-lts) ## Running SKlauncher +You don't need to [register](/getting-started/register) to try it, but when you see the "log in" screen we recommend you read the [Log in](/getting-started/login) guide to avoid headaches. ### Windows If you didn't skip the Custom Setup screen, you can now run SKlauncher. ### Linux -To run SKlauncher on Linux, use the following command in the terminal: +To run SKlauncher on Linux, use the following command in the Terminal: + ``` java -jar SKlauncher.jar ``` -Make sure you're in the directory containing the SKlauncher.jar file, or provide the full path to the file. + +Make sure you're in the directory containing the SKlauncher.jar\* file, or provide the full path to the file. + +:::tip + +You may need to give it execute permissions first by typing `chmod +x SKlauncher.jar` (and maybe `755` instead of `+x`). + +::: + +\* - When downloading the name is in SKlauncher-version.jar format. Ideally, you should always rename it to SKlauncher in case you've to download it again (especially if you make a shortcut or script to launch it). ## Common questions ### I have Java X, but the game requires Java Y, will it work? -Yes, it will work. SKlauncher downloads the game's version of Java, so you can use any version of Java on your computer. +Yes, it will work. SKlauncher downloads the game's version of Java, so you can use any version of Java on your computer. \* + +\* - And if you want to use another Java when playing (like using Java 21 when the game would use Java 17), you can do it! But the explanation is [here](/faq/launcher-related#can-i-use-a-different-java-for-the-game). ### Why do I need Java 8 with JavaFX? SKlauncher is built with JavaFX, which may not be included in Java 8 by default. So you need to install Java 8 with JavaFX or Java 21. +### Can I NOT install Java? +Yes, but this requires: +1. Using a portable Java distribution: + - Windows: .zip format + - Linux / macOS: .tar.gz format +2. Running SKlauncher via command line: `java -jar SKlauncher.jar` + +:::note + +This approach requires basic knowledge of: +- Working directories. +- Relative / absolute paths. +- Using "quotes" for paths with spaces. + + + For example, this is what it would be like to run SKlauncher via CMD commands in Windows when my working directory is the Downloads folder:\ + `"jdk-21.0.5+11\bin\java.exe" -jar SKlauncher.jar` + + +::: + +### Can I install SKlauncher in another folder? +Of course! But the full answer on how to do it is [here](/faq/launcher-related#can-i-install-sklauncher-in-another-folder). + ## Common issues +:::tip + +Did you already have Java before and you installed the one in the guide?\ +Did you uninstall every Java you had and are about to install the one in the guide? + +It may be a good idea to restart the PC. + +::: + ### I have Temurin 21 installed, but it still says that I don't have Java installed In this situation you probably skipped the *Custom Setup* screen. To fix this, you need to reinstall Java 21, and make sure to [follow the instructions](/getting-started/install#windows) in the *Custom Setup* screen. diff --git a/docs/getting-started/login-microsoft.mdx b/docs/getting-started/login-microsoft.mdx new file mode 100644 index 0000000..73f8d4e --- /dev/null +++ b/docs/getting-started/login-microsoft.mdx @@ -0,0 +1,42 @@ +--- +slug: /getting-started/login/microsoft +title: Microsoft login +unlisted: true +--- + +:::info + +This option is *only for users* who have *Minecraft: Java Edition* **[purchased](/faq/launcher-related#where-can-i-buy-the-game)**.\ +In addition those users **had to create an user** when using *[Minecraft Launcher](https://www.minecraft.net/en-us/download)* ([alternative](https://www.minecraft.net/en-us/download/alternative)) at *least once*. + +::: + +## Login +1. Run SKlauncher and click the "Login with Microsoft" button. +2. Your default browser will open an official Microsoft login page for you to sign in with your account (make sure it's the one that has Minecraft: Java Edition purchased). +3. In a moment it will ask you if you want to allow an app (ReLogin) and you must do it. +4. When the whole process is finished, you will be redirected to a local page saying that you can now close your browser (do it). +5. If everything is ok, you will see that you are logged in to SKlauncher with your Microsoft account. + +## Common questions + +### What is ReLogin, is it dangerous? +It's a generic Microsoft Azure application where you do the OAuth 2.0 authentication flow to get the access token so you can play (like any launcher would do....in a nutshell and in simple terms). + +> On 30th August 2024 for a few hours we switched from using *ReLogin* to *Auth Me for Minecraft*. In the end it was switched back to ReLogin because it wasn't a necessary change.\ +> This is noted in case you see that App when you visit [Microsoft - Manage applications](https://account.live.com/consent/Manage). + +So no, it's not dangerous. Obviously don't push your luck and publish your access token or your refresh token.\ +If you think you've leaked any, you can always manually invalidate them:\ +\- The refresh token when you remove ReLogin.\ +\- The access token when you change your Microsoft password. + +### What data does SKlauncher store about my Microsoft account? +From the Launcher: Google Analytics data.\ +About your Microsoft account: Absolutely nothing. + +## Common issues + +### Couldn't log in / Profile not found +Read the error message and do what it says, but if that doesn't help you can always [ask for help in Discord](https://skmedix.pl/discord) explaining the problem (and sending the log by clicking on Open Log).\ +This is assuming that the [Xbox Live service](https://support.xbox.com/en-US/xbox-live-status) isn't down and that you followed the info at the top of this page (if both are ok, you can try restarting the launcher and try again). diff --git a/docs/getting-started/login-offline.mdx b/docs/getting-started/login-offline.mdx new file mode 100644 index 0000000..2be713e --- /dev/null +++ b/docs/getting-started/login-offline.mdx @@ -0,0 +1,48 @@ +--- +slug: /getting-started/login/offline +title: Offline login +unlisted: true +--- + +:::info + +This option allows you to use **any username** because *this is how the game is coded*, no one will be able to access your Microsoft or SKlauncher account when using the same username.\ +You will be able to play multiplayer, but only on servers that allow offline players ([online-mode=false](/troubleshooting/game-related#failed-to-login-invalid-session)). + +::: + +## Login +1. Run SKlauncher and click the "Switch to offline mode" button (currently located in the bottom left corner). +2. Type the same username you chose on the SKlauncher website (username, not email) to use your SK account (otherwise, type any username you want to use) and click the "Login offline" button. +3. If everything is ok, you will see that you are logged in to SKlauncher. + +## Common questions + +### Can I really use any username without a password? Isn't this a serious problem? +This is how offline accounts work because that's how the game is coded. + +If you type the username of a Microsoft account (like Notch) you will only see the skin/cape that he has set. But you won't be able to change or see any private data or anything that affects the real user. \*\ +\* - The same happens if you type the username of an SKlauncher account. + +In both cases you've nothing to worry about your data. + +### If I can use any username, what happens on servers? +- Online Mode: Nothing, since an Offline account can't join a server with [online-mode=true](/troubleshooting/game-related#failed-to-login-invalid-session). +- Offline Mode: Literally play with all your stuff, that's why [online-mode=false](/troubleshooting/game-related#failed-to-login-invalid-session) servers use plugins/mods that ask you to login\*. + +\* - Obviously, if you see that you join a server the 1st time in your life and it asks you to login...it means that someone else registered with that user. + +### What data does SKlauncher store about my SKlauncher account? +- Account data: + - Email + - Password (stored with Argon2id, no plain text or insecure stuff) + - Discord ID (optional since you should have used this option) +- Profile data: + - Username + - Skin + - Cape + - Slim +- Launcher data: + - Google Analytics + +So if you didn't make an account in SKlauncher only Google Analytics data is received when using the launcher. diff --git a/docs/getting-started/login.mdx b/docs/getting-started/login.mdx new file mode 100644 index 0000000..5187e99 --- /dev/null +++ b/docs/getting-started/login.mdx @@ -0,0 +1,30 @@ +--- +slug: /getting-started/login +title: Log in +description: To log in correctly in the launcher you have to... +sidebar_position: 4 +--- + +import Admonition from '@theme/Admonition'; +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +:::info + +Before proceeding, answer the following question to save yourself some headaches! + +::: + + + + + Then you can use the **[Microsoft login](/getting-started/login/microsoft)** option. + + + Then you can only use the **[Offline login](/getting-started/login/offline)** option.\ + :bulb: Don't let the name confuse you, you can still play on servers (only those with [online-mode=false](/troubleshooting/game-related#failed-to-login-invalid-session)). + + :wink: Hey! Buying the game has many advantages and also shows your support to the creators, so keep saving and [buy it](/faq/launcher-related#where-can-i-buy-the-game). + + + diff --git a/docs/getting-started/register.mdx b/docs/getting-started/register.mdx new file mode 100644 index 0000000..de04fd3 --- /dev/null +++ b/docs/getting-started/register.mdx @@ -0,0 +1,30 @@ +--- +slug: /getting-started/register +title: Register +description: Create a SKlauncher account to change your skin and cape +sidebar_position: 3 +--- + +:::info + +This is totally *optional*, **you don't need to create an account** to try SKlauncher as you will read in the [Log in](/getting-started/login) guide.\ +But if your idea is to **change the skin and cape**, then yes: *you need to create an account*. + +::: + +1. Go to [SKlauncher](https://skmedix.pl/) and click [Sign in](https://skmedix.pl/login). +2. If you want to create an account using... + - Discord: click *Login with Discord* and follow the instructions. + - Email: click *[Register now](https://skmedix.pl/register)* and follow the instructions. + +:::warning + +Don't lose access to your Discord / Email or you'll lose your account if you forget your password!\ +If you don't lose anything and forget your password, [it's recoverable](/troubleshooting/web-related#i-forgot-my-password). + +::: + +3. Done, now you have an SKlauncher account. But now you're missing the profile that will define your username\* (the in-game name) and with it the possibility to modify the skin and cape.\ +So follow the instructions (assuming you're on the [Customization](https://skmedix.pl/settings/customization) page) so you can finish everything to finally [Log in](/getting-started/login) to the launcher. + +\* - If it already exists in SKlauncher you won't be able to use it, but some recommend to check that it doesn't exist in Microsoft either with [NameMC](https://namemc.com/) / [MCChecker](https://mcchecker.net/) diff --git a/docs/intro.mdx b/docs/intro.mdx index 3c35f4d..895c0f7 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -4,15 +4,12 @@ title: Introduction sidebar_position: 0 --- -# Introduction +## What is SKlauncher? +SKlauncher is a game launcher for **Minecraft: Java Edition**, designed to offer players an easy-to-use, visually appealing interface for managing the game and installed modifications, along with a range of offline features. -## What is SKlauncher - -SKlauncher is a game launcher for the game Minecraft: Java Edition, with the simple goal to provide players an easy-to-use and -beautiful interface to manage the game and installed modifications, with an additional set of offline features. +For {new Date().getFullYear() - 2014} years, SKlauncher has enabled users to log in with their Mojang accounts (prior to the migration to Microsoft in 2023) or use Offline accounts, with the option to create an SKlauncher account. ## Features - -* - This feature is currently in development +\* - This feature is currently in development + +## The team +Since its inception, SKlauncher has been developed solely by **SKmedix**, who has served as the *primary developer*. In early 2023, **Foxer** joined the team as a *Front-End developer*. + +Although the team is small, **the community** plays an invaluable role: users contribute by *translating the launcher*, *testing* and reporting bugs, *moderating* the Discord server, and providing *support* to fellow users. diff --git a/docs/modding/_category_.json b/docs/modding/_category_.json index fa9d65c..e1ab6bd 100644 --- a/docs/modding/_category_.json +++ b/docs/modding/_category_.json @@ -1,5 +1,5 @@ { - "position": 3, + "position": 6, "label": "Modding", "collapsible": false, "link": { diff --git a/docs/modding/fabric.mdx b/docs/modding/fabric.mdx index 9bafad2..ed663a3 100644 --- a/docs/modding/fabric.mdx +++ b/docs/modding/fabric.mdx @@ -3,7 +3,9 @@ title: Installing Fabric --- :::info TODO + This document is a work in progress. Please help us improve it by contributing! + ::: Thanks to SKlauncher 3.1 installing Fabric is a really quick and simple process. Here's what you will need to do to install it: @@ -11,4 +13,4 @@ Thanks to SKlauncher 3.1 installing Fabric is a really quick and simple process. 1. Go to the **Installations Manager** and create a new installation. 2. In the version chooser select **Fabric** and choose desired Minecraft version. 3. Customize the installation to your liking and save it. -4. Done! \ No newline at end of file +4. Done! diff --git a/docs/modding/forge.mdx b/docs/modding/forge.mdx index 2766e70..784b5a2 100644 --- a/docs/modding/forge.mdx +++ b/docs/modding/forge.mdx @@ -3,7 +3,9 @@ title: Installing Forge --- :::info TODO + This document is a work in progress. Please help us improve it by contributing! + ::: Thanks to SKlauncher 3.1 installing Forge is a really quick and simple process. Here's what you will need to do to install it: @@ -11,4 +13,4 @@ Thanks to SKlauncher 3.1 installing Forge is a really quick and simple process. 1. Go to the **Installations Manager** and create a new installation. 2. In the version chooser select **Forge** and choose desired Minecraft version. 3. Customize the installation to your liking and save it. -4. Done! \ No newline at end of file +4. Done! diff --git a/docs/modding/neoforge.mdx b/docs/modding/neoforge.mdx new file mode 100644 index 0000000..a60c4f5 --- /dev/null +++ b/docs/modding/neoforge.mdx @@ -0,0 +1,16 @@ +--- +title: Installing NeoForge +--- + +:::info TODO + +This document is a work in progress. Please help us improve it by contributing! + +::: + +Thanks to SKlauncher 3.1 installing NeoForge is a really quick and simple process. Here's what you will need to do to install it: + +1. Go to the **Installations Manager** and create a new installation. +2. In the version chooser select **NeoForge** and choose desired Minecraft version. +3. Customize the installation to your liking and save it. +4. Done! diff --git a/docs/modding/optifine.mdx b/docs/modding/optifine.mdx index e072fea..f59ea22 100644 --- a/docs/modding/optifine.mdx +++ b/docs/modding/optifine.mdx @@ -36,3 +36,19 @@ Before following these steps, **make sure you have run the version of Minecraft ## Using OptiFine with Fabric You can do so by installing **[OptiFabric](https://www.curseforge.com/minecraft/mc-mods/optifabric)** mod, but it's **not recommended** for compatibility reasons. Even the author of this mod suggests using alternatives to Optifine such as **[Sodium](https://modrinth.com/mod/sodium)**. It serves the same purpose as OptiFine, works natively with Fabric and reportedly gives even better performance. Sodium however doesn't have shaders support built in. But you can use **[Iris Shaders](https://modrinth.com/mod/Iris)** mod for that. + +## Common questions +### Why can't it be installed automatically? +If you look closely, when you download OptiFine you go through advertising. Without advertising it's even more money sp614x (creator of OptiFine) itself has to put in to maintain everything.\ +Now if we look at the website... + +> Can I include OptiFine in my modpack?\ +> Generally no, unless you have an explicit permission from us.\ +> \- [OptiFine - FAQ](https://optifine.net/faq) + +> (...)\ +> It may not be placed on any web site or otherwise distributed publicly without advance written permission.\ +> Use of this mod on any other website or as a part of any public display is strictly prohibited and a violation of copyright.\ +> \- [OptiFine - Copyright](https://optifine.net/copyright) + +So much less he wants it to be integrated into a launcher without permission and SKlauncher respects his decision. diff --git a/docs/modding/quilt.mdx b/docs/modding/quilt.mdx new file mode 100644 index 0000000..999afff --- /dev/null +++ b/docs/modding/quilt.mdx @@ -0,0 +1,16 @@ +--- +title: Installing Quilt +--- + +:::info TODO + +This document is a work in progress. Please help us improve it by contributing! + +::: + +Thanks to SKlauncher 3.1 installing Quilt is a really quick and simple process. Here's what you will need to do to install it: + +1. Go to the **Installations Manager** and create a new installation. +2. In the version chooser select **Quilt** and choose desired Minecraft version. +3. Customize the installation to your liking and save it. +4. Done! diff --git a/docs/servers/_category_.json b/docs/servers/_category_.json new file mode 100644 index 0000000..39e5ebb --- /dev/null +++ b/docs/servers/_category_.json @@ -0,0 +1,9 @@ +{ + "position": 3, + "label": "Servers", + "collapsible": false, + "link": { + "type": "doc", + "id": "servers" + } +} diff --git a/docs/servers/dedicated-server.mdx b/docs/servers/dedicated-server.mdx new file mode 100644 index 0000000..db18acc --- /dev/null +++ b/docs/servers/dedicated-server.mdx @@ -0,0 +1,37 @@ +--- +title: Dedicated servers +description: Create your own dedicated server to play with more than 1M players +sidebar_position: 2 +--- + +:::info TODO + +This document is a work in progress. Please help us improve it by contributing! + +:::warning NOTICE TO CONTRIBUTORS + +1. No need to install Java!\ +Since we're going to talk about commands or even create a .bat/.sh file to start the server, it would be convenient to use the extractable Java\ +(otherwise, imagine the problem of installing a Java for SKlauncher and another Java for the server). + +2. There isn't an official list to download the .jar for the server, but there's [MCVersions](https://mcversions.net/) as a possible option (since the URLs come from the official server). + +::: + +> Want to set up a multiplayer server? +> +> Please note: This server setup is only compatible with Minecraft: Java Edition. +> +> If you want to run a Minecraft multiplayer server by yourself things get kind of involved (see [this wiki article for a tutorial](https://minecraft.wiki/w/Tutorials/Setting_up_a_server)). First make sure you can use java from the command line. On Linux and macOS this should already be set up but on Windows you might have to tinker with the PATH environment variable. +> +> Download [minecraft_server.jar](https://www.minecraft.net/en-us/download/server) and run it with the following command: +> +> `java -Xmx1024M -Xms1024M -jar minecraft_server.jar nogui` +> +> Should you want to start the server with its graphical user interface you can leave out the "nogui" part. +> +> Just so you know, by downloading any of the software on this page, you agree to the [Minecraft End User License Agreement](https://account.mojang.com/documents/minecraft_eula) and [Privacy Policy](https://go.microsoft.com/fwlink/?LinkId=521839). +> +> If you want to skip the setup and start exploring other 3rd party servers visit our official [Server Listing Site](http://aka.ms/verifiedservers). Each server offers its own brand of fun and uniqueness. Find your favorite with our Server List Site, where all listed servers have been reviewed and verified as following our community standards and guidelines. Browse servers based on game type, play style, and more. Chance is there’s a server listed for you – regardless of age or the way you play. + +Source: https://www.minecraft.net/en-us/download/server diff --git a/docs/servers/lan-world.mdx b/docs/servers/lan-world.mdx new file mode 100644 index 0000000..a926b96 --- /dev/null +++ b/docs/servers/lan-world.mdx @@ -0,0 +1,85 @@ +--- +title: Open to LAN worlds +description: You can play in your Singleplayer world with up to 8 friends in LAN +sidebar_position: 1 +--- + +You can play in your Singleplayer world with up to 8 friends in LAN, thanks to the fact that since Release 1.3.1 the game has an integrated server\* in the client. + +\* - If you're going to play on a version prior to the mentioned one, you'll have to create a [dedicated server](/servers/dedicated-server). + +## Hosting +1. You want to be the host, so you start the game, fire up the world of choice, press ESC and click **Open to LAN**. +2. Now configure the server settings to your liking, and then click **Start LAN World**. +3. Done, you should see a message like this in the chat: `Local game hosted on port [50000]` (the port may be different). + - Depending on the version it can show you the IP and Port (for example: 192.168.1.100:50000). +4. Tell your friends to join. + +## Joining +1. The host already did everything and you want to connect, so you start the game and go to *Multiplayer*. +2. You will see a caption that says **Scanning for games on your local network**, below it the host world should appear. + - Every 1.5 seconds it refreshes, so don't spam the *Refresh* button. +3. Done, select the server and click **Join Server** (or just double click). + - The *Direct Connection* or *Add Server* option might work only if you and the host are Microsoft accounts, otherwise you will get [this](#failed-to-login-invalid-session) error. + +## Common issues +There are many possible problems and some are detailed in [this](https://www.howtogeek.com/242375/how-to-troubleshoot-minecraft-lan-game-problems/) external link.\ +Assuming the best case scenario where you know about IP, Firewall, etc. and therefore you've everything properly configured, there are 2 very common and "difficult" problems. + +### Failed to login: Invalid session +That's already answered [here](/troubleshooting/game-related#failed-to-login-invalid-session), but you don't have access to the `server.properties` file in this case!\ +There are two possible solutions, the 1st one would work in any case. + +#### Vanilla (no mods) +Players will only be able to connect if it appears in Multiplayer under *Scanning for games on your local network*.\ +If the world isn't listed there (since connecting by IP:Port will give the invalid session error), you'll have to do [this](#the-world-is-not-listed-in-the-lan-list). + +#### Modding +There are some mods that only add the option to change the Online Mode and this is what you're looking for.\ +In case you have never installed mods before, you can learn how to do that in the [Modding](/category/modding) guide. + +Some mods that allow you to change Online Mode are the following: +- [Lan Server Properties](https://www.curseforge.com/minecraft/mc-mods/lan-server-properties) +- [EasyLAN](https://www.curseforge.com/minecraft/mc-mods/easylan) +- [Custom LAN](https://www.curseforge.com/minecraft/mc-mods/custom-lan) +- [Server.Properties for LAN](https://www.curseforge.com/minecraft/mc-mods/server-properties-for-lan) + +Obviously install just one, not all of them! And you may prefer to search for another one because they may not be for the version and/or Mod Loader you want to use. + +### The world is not listed in the LAN list +There are some cases where everyone has everything properly configured (properly in LAN, Firewall allowed, etc.) but to some (or none) the world appears in LAN.\ +In my case it was always solved by modifying the network metric (this is explained in Windows, I'm not sure how it will be with Linux / macOS). + +1. Everyone must close the game and the launcher, but have Hamachi on (assuming you use Hamachi or another to have a virtual LAN). +2. Run *Windows PowerShell* as administrator and type this command: `Get-NetIPInterface` + +
+ You will see something like this + + ``` + ifIndex InterfaceAlias AddressFamily NlMtu(Bytes) InterfaceMetric Dhcp ConnectionState PolicyStore + ------- -------------- ------------- ------------ --------------- ---- --------------- ----------- + 5 Hamachi IPv6 1500 15 Enabled Connected ActiveStore + 8 Ethernet IPv6 1500 25 Enabled Connected ActiveStore + 1 Loopback Pseudo-Interface 1 IPv6 1500 75 Disabled Connected ActiveStore + 5 Hamachi IPv4 1500 15 Enabled Connected ActiveStore + 8 Ethernet IPv4 1500 25 Enabled Connected ActiveStore + 1 Loopback Pseudo-Interface 1 IPv4 1500 75 Disabled Connected ActiveStore + ``` + +
+ +3. Now you must check the `ifIndex` and `InterfaceMetric` to modify them with this command:\ +`Set-NetIPInterface -InterfaceIndex XX -InterfaceMetric YY` + - Lower metric means higher priority (I use Hamachi 15, Ethernet 25 and Loopback 75). + - Example command to make Hamachi 15: `Set-NetIPInterface -InterfaceIndex 5 -InterfaceMetric 15` +4. Done, restart the PC and everything should be fine now. + - Remember that everyone should do this. + +:::note + +If you look at the logs, you'll see that it tells you that there is an error about an invalid session! But it allows you to join anyway. + +I also remind you that this assumes the best case scenario (everything is perfectly configured, just not using the correct network adapter) and that if it fails again just reboot the PC (at least, that was the solution to the few times it happened to me). + +::: diff --git a/docs/servers/servers.mdx b/docs/servers/servers.mdx new file mode 100644 index 0000000..6c9b78a --- /dev/null +++ b/docs/servers/servers.mdx @@ -0,0 +1,25 @@ +--- +slug: /category/servers +title: Servers +id: servers +--- + +import DocCardList from '@theme/DocCardList'; + +:::tip + +Looking for servers instead of creating them?\ +Currently there's no official\* server list globally, but you'll be able to find several in [Xyrios](https://xyrios.com/) when it's released to the public! + +\* - Ok, there's only the [official and verified list](http://aka.ms/verifiedservers) for Microsoft accounts. But there isn't a list of all servers for Microsoft and Offline accounts! + +::: + +There are 2 ways to make a server in the game: the 1st one is to open in LAN your singleplayer world and the 2nd one is to create a dedicated server.\ +Although the 1st option should be the easiest, they are still advanced topics. \* + +\* - If everything is ok, you just follow the guide and that's it! But problems can always occur, from properly allowing in the Firewall to talking to your ISP because you don't have a real Public IP. + +*** + + diff --git a/docs/troubleshooting/_category_.json b/docs/troubleshooting/_category_.json new file mode 100644 index 0000000..9ca496a --- /dev/null +++ b/docs/troubleshooting/_category_.json @@ -0,0 +1,8 @@ +{ + "position": 5, + "label": "Troubleshooting", + "collapsible": true, + "link": { + "type": "generated-index" + } +} diff --git a/docs/troubleshooting/game-related.mdx b/docs/troubleshooting/game-related.mdx new file mode 100644 index 0000000..c2a94d7 --- /dev/null +++ b/docs/troubleshooting/game-related.mdx @@ -0,0 +1,61 @@ +--- +title: Game related +description: Problems with Minecraft - Java Edition (the game) +sidebar_position: 3 +--- + +## Game doesn't start due to GLFW, OpenGL, ig7icd64.dll or atio6axx.dll error +Possible solutions which you'll have to search on the Internet if you don't understand something: +- Check for driver updates on the graphics brand's website: Search and update manually, because sometimes the automatic software says "you already have the latest version" and it's not true. + - Hey, if you don't have a dGPU then you'll have to search for the CPU drivers (that updates the iGPU drivers...usually). +- Try reinstalling your graphics drivers: Especially check that you can do a clean install (restore factory graphics settings). + - If it doesn't ask you to do so, restart the PC anyway. +- Make sure the game is set to [prefer high performance graphics](/faq/game-related#how-to-change-the-gpu-used-in-the-game) in the OS and/or driver control panel. + +:::note + +If you're pretty sure you did everything correctly and the problem persists, it means that your GPU no longer supports the version of the game you're trying to start.\ +For example: Release 1.17 moved OpenGL 2.0 to 3.2. If your GPU only supports 3.1, then you'll have to play versions prior to Release 1.17. + +Could there be a mod that will fix the problem? Maybe, as long as they don't ask you to put a random .dll in a system folder or similar things you should be fine. + +::: + +## I get a Crash Report that says: Report was empty +Since the report is empty, it would be ideal if you share the [logs in debug mode](/faq/uncategorized#where-are-the-logs-located).\ +This way the problem could be reported to the developer and never happen again. + +It seems that this happens since dGPU usage can be forced from the launcher settings, so the solution would be: [disable use dGPU](/faq/game-related#how-to-change-the-gpu-used-in-the-game) (Option A - But Disable!)\ +But others also say it's related to GPU drivers, so it would be doing the 3 points of the [above problem](#game-doesnt-start-due-to-glfw-opengl-ig7icd64dll-or-atio6axxdll-error). + +:::note + +If only disabling the use dGPU option solved the problem, it would be very good if you re-enable it and send the [logs in debug mode](/faq/uncategorized#where-are-the-logs-located) so that the problem can be solved permanently. + +::: + +## Release 1.13 and above doesn't launch on Linux x86 (32-bits) +The Minecraft engine (LWJGL) has dropped Linux x86 support in LWJGL 3, so play older versions or install Linux x64 (64-bits). + +## Invalid signature for profile public key +Since the error is possible for both Microsoft and Offline accounts... + +### Microsoft accounts +- Check that there are no problems in the [Xbox Live service](https://support.xbox.com/en-US/xbox-live-status). +- Follow the error message and restart the game and launcher (it may even be useful to log out and log back in). + +### Offline accounts +- The server you're trying to connect to only allows players with a public key signed by Mojang (`enforce-secure-profile=true`). + - If it's your server, then set `enforce-secure-profile=false` in your `server.properties` file and restart the server. + +## Failed to login: Invalid session +Since the error is possible for both Microsoft and Offline accounts... + +### Microsoft accounts +- Check that there are no problems in the [Xbox Live service](https://support.xbox.com/en-US/xbox-live-status). +- Follow the error message and restart the game and launcher (it may even be useful to log out and log back in). + +### Offline accounts +- The server you're trying to connect to is for Online (Microsoft) accounts (`online-mode=true`). + - If it's your server, then set `online-mode=false` in your `server.properties` file and restart the server. +- It could also be that a Microsoft account already joined that server and your Offline account has the same name. In that case you'll have to change your name to one that doesn't exist (you can check it in [NameMC](https://namemc.com/) / [MCChecker](https://mcchecker.net/)). diff --git a/docs/troubleshooting/launcher-related.mdx b/docs/troubleshooting/launcher-related.mdx new file mode 100644 index 0000000..cea63ca --- /dev/null +++ b/docs/troubleshooting/launcher-related.mdx @@ -0,0 +1,54 @@ +--- +title: Launcher related +description: Problems with SKlauncher (the launcher itself) +sidebar_position: 2 +--- + +:::tip + +Before you start looking here, check the following pages first: +- [Installation - Common issues](/getting-started/install#common-issues) +- [Log in](/getting-started/login) + +::: + +## Error: Unable to access jarfile when opening SKlauncher +The path [where SKlauncher is installed](/faq/launcher-related#where-is-sklauncher-installed) contains special characters (like `?, !, ^, &, $`) or you put it in OneDrive. + +## Launcher starts but closes or keeps loading forever +1. Delete other launcher folders located in `.minecraft` +2. Delete `sklauncher` folder located in `.minecraft` +3. Delete `java` folder located in `%APPDATA%` +4. Check that Java is allowed in your Firewall and/or Antivirus. +5. Follow the [Installation](/getting-started/install) guide again and restart the PC. + +## My skin hasn't changed +- If there are no problems with the server (like the overload that occurred in August 2021) or problems with your connection: + - When you upload your skin/cape for the first time you should see the change instantly (if you already have the Launcher/Game open, you should close it). + - But when you want to change your skin/cape for the second, third, etc. time it may take a couple of hours to change (and it's even possible that the Launcher shows your old skin but inside the Game you already see the new one). +- So if you saved the skin/cape [properly](/faq/web-related#how-do-i-put-on-a-skin-or-cape), you don't have much else to do but wait. + +## My skin isn't visible on servers or with mods +- Singleplayer: If it works in Vanilla (no mods), then it could be a problem with the Mod Loader or one of the mods. + - If it's a particular mod, you don't use it and done. But if it was the Mod Loader there is not much you can do (you could report it in [the Discord server](https://skmedix.pl/discord)). +- Multiplayer: Some servers have plugins to change the skin by typing `/skin MicrosoftUsername` in the chat (and even allow to put the url of the skin, but it depends on the plugin). + +## I can't see any version in SKlauncher +Check if your [Launcher logs](/faq/uncategorized#where-are-the-logs-located) says anything about "DNS Poisoning", if it does you're in trouble: +1. Start a full system scan with your Antivirus, the stronger the scan the better. And waits for it to finish. + - Hey! Maybe you don't have any virus and you know perfectly well that you ran something that was going to change what is mentioned in step 2. +2. Disconnect from Internet and open `%WINDIR%\System32\drivers\etc\hosts` file with Notepad. Delete unwanted DNS text lines without # at the beginning of the text lines (especially if they say something about Microsoft, Mojang, etc). +3. Run CMD as administrator and type `ipconfig /flushdns`. After that just restart your PC, reconnect to Internet and run SKlauncher. + - If it still doesn't work delete .json files of the launcher and run again. If you've still questions and problems, head to our [Discord](https://skmedix.pl/discord). + +## I can't allocate more than 1 GB +You must have x64 (64-bits) Java installed, read the [Install](/getting-started/install) guide. + +## I can only play the Demo mode +If you haven't [forced the demo mode](/faq/launcher-related#can-i-force-the-demo-mode), then read the [Log in](/getting-started/login) guide again. + +## 'X' client doesn't work +Edit the Client installation in the launcher and enable Compatibility Mode. + +## Going into Friends tab on Hypixel hangs the game +Edit the installation you're using in the launcher and enable Compatibility Mode. diff --git a/docs/troubleshooting/uncategorized.mdx b/docs/troubleshooting/uncategorized.mdx new file mode 100644 index 0000000..749dc66 --- /dev/null +++ b/docs/troubleshooting/uncategorized.mdx @@ -0,0 +1,16 @@ +--- +title: Uncategorized +description: Problems that can occur in all of the previous ones +sidebar_position: 4 +--- + +## My problem doesn't appear! +1. You can always [join the Discord server](https://skmedix.pl/discord) and use the appropriate channels to ask a question. But before you do that, using the search option in Discord to find answers can save you unnecessary waiting time. + - We only ask you to do 3 things: + - Search if someone else asked the same problem and got a solution. + - Explain properly what has happened. + - Send the corresponding [logs](/faq/uncategorized#where-are-the-logs-located). + - Finally wait patiently for an answer. +2. Search on the Internet because, unless it's a very specific problem about SKlauncher, you're likely to find answers to your problems much faster. + - Officially there is [Minecraft Forum](https://www.minecraftforum.net/) and [Minecraft Wiki](https://minecraft.wiki/). + - You can also find much more information on [Google](https://www.google.com/) (or any other search engine) and/or [YouTube](https://www.youtube.com/). diff --git a/docs/troubleshooting/web-related.mdx b/docs/troubleshooting/web-related.mdx new file mode 100644 index 0000000..6011071 --- /dev/null +++ b/docs/troubleshooting/web-related.mdx @@ -0,0 +1,25 @@ +--- +title: Web related +description: Problems with the SKlauncher website +sidebar_position: 1 +--- + +:::tip + +Before you start looking here, check the following pages first: +- [Downloading - Common issues](/getting-started/downloads#common-issues) + +::: + +## I forgot my password +1. Go to the SKlauncher website, click on *Sign in* and finally on *[Forgot password?](https://skmedix.pl/reset-password)* +2. Follow the on-screen instructions. + +If your Discord account uses the same email as your SKlauncher account, you could click *Login with Discord*. This would be only for the remote case that you even forgot your email. + +:::note + +If you forgot your email address or lost access to it, it won't be possible to recover the account.\ +I think in that case, it would be a good time to start researching and using *password managers* (Bitwarden, KeePass, etc.) to make sure this never happens to you again. + +::: diff --git a/docs/virus-conspiracy-club.mdx b/docs/virus-conspiracy-club.mdx new file mode 100644 index 0000000..3f12fb5 --- /dev/null +++ b/docs/virus-conspiracy-club.mdx @@ -0,0 +1,117 @@ +--- +slug: /virus +title: Virus Conspiracy Club +description: Does SKlauncher have any viruses or vulnerabilities? +unlisted: true +--- + +This page addresses common questions and misconceptions about SKlauncher and its [security](https://skmedix.pl/security).\ +Misunderstandings about launchers like SKlauncher can arise from misinformation, vague suspicions, or specific issues left unexplained. Let’s clarify some of these concerns. + +:::warning + +1. A certain level of knowledge is necessary to analyze and determine if software is malicious. +2. While this doc focuses on SKlauncher, much of it applies to other games, programs, and launchers too. + +::: + +*** + +## Is SKlauncher a Virus? +No, SKlauncher is not a virus. However, certain warnings and security alerts can appear during download or execution. Here’s what you need to know: + +:::note + +To simplify things (*since there are many Antivirus and hundreds of combinations of security settings*), let's pretend you're a **Windows** user with **Windows Defender** and **all its options enabled**. + +::: + +### Downloading +> **When you download the .exe or .jar file, your browser may block it as "potentially unwanted".** + +This occurs because of SmartScreen, which is reputation-based. Files that are new and unsigned often trigger these alerts.\ +As more users download and approve SKlauncher, this alert will disappear. Generally, the .exe file might clear SmartScreen faster than the .jar. + +Why does this happen? Since the file is unsigned and new, it doesn’t yet have a trustworthy reputation in SmartScreen. + +:::note + +The [Downloads](https://skmedix.pl/downloads) page provides an SHA-256 checksum, which you can use to verify the file integrity.\ +Compare this with the checksum on [VirusTotal](https://www.virustotal.com/) to ensure your download hasn’t been tampered with. + +::: + +PS: You can test SmartScreen’s behavior on the [demo website](https://demo.smartscreen.msft.net/) under *URL Rep Demos*. + +### Running +> **When starting the .exe, you may see an alert saying "an unrecognized app was prevented from starting".** + +Again, it will always happen because it's SmartScreen. Especially to the .exe file because it's executed directly by Windows while the .jar is executed by the Java Virtual Machine.\ +We're still in the same dilemma as in downloads: it's reputation based and the more people click on "More info -> Run anyway", the faster the alert will disappear. + +PS: You can test SmartScreen’s behavior on the [demo website](https://demo.smartscreen.msft.net/) under *App Rep Demos*. + +> **When navigating through the different launcher options, the Antivirus notifies you that a threat has been blocked.** + +If this occurs, check what specifically is being flagged. But the last time something like this happened, it happened when installing Forge.\ +Windows Defender at first look looks like it flagged SKlauncher, but it turned out it was flagging the Forge installer (which is literally downloaded from the Forge server). + +If you’re downloading a modpack, files come from sources like CurseForge or Modrinth, where individual mods or downloaded files might trigger Antivirus alerts.\ +At first glance, this can look like an SKlauncher issue when it's actually a third-party file being flagged. + +## Is SKlauncher open source? +Already answered [here](/faq/launcher-related#is-sklauncher-open-source). + +## Are there any Vulnerabilities? +SKlauncher has experienced only one known vulnerability, Log4j, which affected many platforms. SKlauncher patched it faster than Microsoft, and there were no reports of SKlauncher users being impacted.\ +Fractureiser (a malware in certain mods) is another example, SKlauncher actively detected and warned users if an infected mod was detected during installation. + +If you hear about a vulnerability affecting SKlauncher or the game, remember: +1. Stay calm and investigate. +2. Avoid using the launcher or game until you’re sure what the vulnerability affects. +3. Report concerns on the [Discord server](https://skmedix.pl/discord) so the developer team can address any legitimate risks. + +## What about user data? +There’s a myth that SKlauncher stores or sells user data, especially for Microsoft accounts. This is false. Here’s a breakdown of what SKlauncher actually stores: + +### Microsoft accounts +- Account data: + - Absolutely nothing +- Profile data: + - Absolutely nothing +- Launcher data: + - Google Analytics + +### Offline accounts +- Account data: + - Email + - Password (stored with Argon2id, no plain text or insecure stuff) + - Discord ID (optional since you should have used this option) +- Profile data: + - Username + - Skin + - Cape + - Slim +- Launcher data: + - Google Analytics + +So if you didn't make an account in SKlauncher only Google Analytics data is received when using the launcher. + +## Conclusion +SKlauncher is not malicious and will not try to sell your data (especially Microsoft data). Every detection over time always turned out to be a false positive. + +*** + +Would a more detailed answer with code and all that nice stuff be great? It really would! But it's hard to respond to something that isn't specific.\ +You tell me "SKlauncher has a virus because this report says it does X" and I've to reverse engineer what the report says and ask myself "Of everything my launcher does, what is the closest thing to this?". Because even if I report the false positive to the Antivirus, they're never going to tell me "Oh yeah sorry, it's just that you do X thing and we misinterpreted it". + +How many times have you heard "SKlauncher is a virus"? Probably many.\ +How many times did you hear "SKlauncher verifies that your DNS hasn’t been altered to ensure secure connections to SKlauncher, Microsoft, Mojang, etc. and even checks if any mod you installed is infected by Fractureiser"? I put my hands on the fire: you never heard of it. + +Why does this happen? Because those spreading these accusations don’t understand the technology. They don’t know how to generate or interpret reports, and they’re often uninterested in finding the truth.\ +For example, once I was flagged for collecting your list of games, but the reality was simple: I read and write the same file that Minecraft Launcher uses (launcher_profiles.json). If they’d looked more closely at the report, they’d have seen this for themselves. + +*** + +Does all this mean you should ignore all the alerts you see? Of course not!\ +Just take the trouble to analyze the results as well as possible and even think if there is any sense (like the time a detection said that we had a [Trojan in Java](https://discord.com/channels/141669825129873409/290149381548670976/1291497403861569686) but that was marked to the .exe and not to the .jar...in other words, an absolute nonsense). diff --git a/static/img/faq/launcher-related/gamedir.png b/static/img/faq/launcher-related/gamedir.png new file mode 100644 index 0000000..5b7866a Binary files /dev/null and b/static/img/faq/launcher-related/gamedir.png differ