Prism Launcher¶
This page is outdated! Click here to go to the new guide!¶
Prism Launcher is an incredibly powerful launcher that makes managing your mods and modded instances much easier. It can do everything the official launcher can do, but allows for much more customization and ease of access. The official launcher is much slower to use and requires a lot of manual work for modern Minecraft. For modded and vanilla users alike, it is recommended to switch to Prism Launcher for an issue-less experience.
This guide will explain the install process for Prism. Please take the time after setting up to better learn your way around the launcher, as you may end up using it as your go-to launcher from now on!
How to Install (Linux)¶
- This is the install guide for GNU/Linux. Despite looking long, this is a very simple process and should only take a few minutes! This guide will also assume you are migrating from SkyClient, but steps will be largely the same, except for the migrating data section.
Step 1 - Installing Prism¶
Download Prism Launcher. Below you will find distro specific instructions on how to download Prism Launcher which you can also find on their website.
How do I install Prism Launcher?
Below you will find distro specific instruction on how to install Prism.If you don't know what distro you're using you probably shouldn't be using Linux.
Flatpak (most distros)
Install from FlatHubAlpine Linux
APK Packages are available on Alpine Linux Edge for multiple architecturesapk add prismlauncher
Arch Linux
There are several packages available:prismlauncher
prismlauncher-git
Installing
# stable binary package:
sudo pacman -S prismlauncher
# latest git package:
yay -S prismlauncher-git
# stable Qt 5 source package:
yay -S prismlauncher-qt5
# stable Qt 5 binary package:
yay -S prismlauncher-qt5-bin
# latest Qt 5 git package:
yay -S prismlauncher-qt5-git
CentOS Stream / Fedora / Red Hat Enterprise Linux
RPM packages are available on Copr for x86_64 and aarch64. If you are on an Enterprise Linux distribution (RHEL, CentOS, Rocky, etc.) and do not have the EPEL repositories enabled, please enable them here.Nightly builds are updated automatically in the Terra repository and built on Copr every 24 hours.
# enables the copr repo
sudo dnf copr enable g3tchoo/prismlauncher
# stable releases
sudo dnf install prismlauncher
# nightly builds
sudo dnf install prismlauncher-nightly
# stable Qt 5 releases
sudo dnf install prismlauncher-qt5
# nightly Qt 5 builds
sudo dnf install prismlauncher-qt5-nightly
Debian / Ubuntu
We use makedeb for our Debian packages.Several MPR packages are available:
prismlauncher
prismlauncher-bin
prismlauncher-git
Installation using Prebuilt MPR (recommended)
curl -q 'https://proget.makedeb.org/debian-feeds/prebuilt-mpr.pub' | gpg --dearmor | sudo tee /usr/share/keyrings/prebuilt-mpr-archive-keyring.gpg 1> /dev/null
echo "deb [signed-by=/usr/share/keyrings/prebuilt-mpr-archive-keyring.gpg] https://proget.makedeb.org prebuilt-mpr $(lsb_release -cs)" | sudo tee /etc/apt/sources.list.d/prebuilt-mpr.list
sudo apt update
sudo apt install prismlauncher
Installation using an MPR helper
Installing UNAbash <(curl -fsL https://github.com/AFK-OS/una/raw/main/install.sh)
una update
# stable source package:
una install prismlauncher
# stable binary package:
una install prismlauncher-bin
# latest git package:
una install prismlauncher-git
Installation with Pacstall
Installing Pacstallsudo bash -c "$(curl -fsSL https://git.io/JsADh || wget -q https://git.io/JsADh -O -)"
Installing Prism Launcher
# latest git package:
pacstall -I prismlauncher-git
Gentoo
Ebuilds are available in the official Gentoo repository, under games-action/prismlauncher and games-action/prismlauncher-qt5Note that, for the time being, it is not stabilized, so it's masked for `~amd64` and `~arm64` only.
sudo emaint sync -a
# If you need to unmask the package, and considering `package.accept_keywords` to be a folder.
echo ">=games-action/prismlauncher-5.0" | sudo tee -a /etc/portage/package.accept_keywords/prismlauncher
# Or do this if you want to build from the latest commit instead of a release
echo "=games-action/prismlauncher-9999 **" | sudo tee -a /etc/portage/package.accept_keywords/prismlauncher
emerge games-action/prismlauncher
OpenSUSE
RPM packages are available on the Open Build Service.# add repository (if on leap, replace 'openSUSE_Tumbleweed' with '15.4')
zypper addrepo https://download.opensuse.org/repositories/home:getchoo/openSUSE_Tumbleweed/home:getchoo.repo
# refresh repository cache
zypper refresh
# stable releases (Qt6 version, only for Tumbleweed)
zypper install prismlauncher
# latest builds (Qt6 version, only for Tumbleweed)
zypper install prismlauncher-nightly
# stable releases (Qt5 version, available for Leap and Tumbleweed)
zypper install prismlauncher-qt5
# latest builds (avalible for Leap and Tumbleweed)
zypper install prismlauncher-qt5-nightly
Void Linux
Prism Launcher is available on the official Void repository.sudo xbps-install PrismLauncher
Continue the installation process until you get to the "Java" screen. Here, you will decide which Java you want to set as the default for new instances. Click on the version that says "1.8" at the beginning of the version and has "Eclipse Foundation" in the path name. This is your Java 8 and it will be the default version of Java for every new instance you create on Prism. Of course, you can always change this later and can still manually specify a different version of Java whenever you want.
For the Minimum and Maximum memory allocation, leave them at 512 MiB and 4096 MiB respectively, unless you only have 8GB of ram or less, in which case you may want to change the maximum to 2048 MiB.
All of these settings can be later adjusted globally or per instance. This includes changing the Java version or memory allocation. See the global settings button on the main page or in instance settings once you've completed this guide.
After this, continue with the installation process as normal.
Step 2 - Logging in¶
Now that we've installed Prism, let's log in. Once Prism has launched, you should see a Steve head and "Profiles" text in the top right. Click on this and press "Manage Accounts". From here, click "Add Microsoft" on the right side menu. This will open a popup window, which will have a button to open the link to verify yourself and also copy the code. Simply paste the code into the window that opens up. Note, you may need to sign in to your Microsoft account first.
Once this is completed, you can exit back to the main Prism Launcher menu. Click on the button at the top left that says "Add Instance".
Step 3 - Creating an instance¶
This guide will describe the process for Fabric 1.21.10, but steps for other versions should also be obvious.
Once you've clicked on the button on the top left that says "Add Instance", name it whatever you want and giving a group for it is optional, but I do not recommend giving a group name until you need to better organize your instances.
Under the Version selector, select 1.21.10. Then in the Mod Loader tab directly underneath, choose Fabric. It will automatically choose the latest version of Fabric for 1.21.10 for you. Simply click "OK" to proceed. You should now be back on the main Prism page.
Step 4 - Installing Mods¶
If the mod is on Modrinth or CurseForge, download them within the launcher using the Download Mods button. If the mod is not on either, you should be confident that it is not malware/a RAT, and you can simply drag and drop them into the Mods tab in Prism Launcher.
Step 5 - Explore¶
Prism Launcher has a lot of things to offer, such as themes if you don't like the look of it, as well as a lot of options for your instances, including the ability to see all your mods, resource packs, and worlds in the launcher before launching. You can use these menus to install mods and resource packs, and even update mods if they are hosted on Modrinth or CurseForge! Please take the time to actually learn how the launcher works and experiment with it! Prism is an incredibly powerful launcher and it's important to know exactly what you can do with it!
You can find a list of Prism themes and how to install them on their website.
Step 6 - Setting CurseForge API Key¶
Some CurseForge mods may not allow downloads from third party launchers such as Prism Launcher. This can be bypassed by opening Prism settings, going to APIs, then API Keys and entering $2a$10$bL4bIL5pUWqfcO7KQtnMReakwtfHbNKh6v1uTpKlzhwoueEJQnPnm into the CurseForge Core API.
Updating Prism, Mods, Minecraft, and Fabric Loader¶
To update Prism, simply update through your package manager, or reinstall it the same way you installed it.
To update mods, head to the Mods tab, and simply press the Check for Updates button and follow all prompts. This will update all your mods to the latest version. It can also update disabled mods, but will still keep them disabled by default.
To update Minecraft, head to the Version tab, (right) click on Minecraft, then Change Version. Set it to the version you want to use. Update your mods as described in the step above to update your mods to the new Minecraft version as well. Not all mods may be available for this new version of Minecraft. Take note of which mods don't get updated and try playing. If you crash, read the crash message to see which mods aren't updated yet and disable them.
To update Fabric Loader, head to the Version tab, (right) click on Fabric Loader, then Change Version. Set it to the latest version.
Common Issues¶
My mods aren't showing up in-game!¶
If you see a list of mods in the Mods tab, you should click Version and check if Fabric Loader is installed. If not, press Install Loader on the right and install the latest version of Fabric Loader.
Need More Help?¶
If you encounter any issues not shown here you should ask for help in my discord server. If you encounter any issues unrelated to the guide at all, or if you want to be in their community or follow for updates, you can ask in the Prism Community discord server