# How to install Easy Multiplayer

Here are the instructions to install modpack to various launchers.

## Supported <a href="#supported" id="supported"></a>

### [Modrinth App](https://modrinth.com/app) <a href="#modrinth-app" id="modrinth-app"></a>

App version 0.6.2 or higher required.

1. Under "Popular packs" section, hover on "Easy Multiplayer"
2. Click `⤓ Install`
3. The modpack will now install.
4. Once installed, hover on the created instance under "Jump back in"
5. Click ▶️ button to play.

### [Prism Launcher](https://prismlauncher.org/) <a href="#prism-launcher" id="prism-launcher"></a>

You need [Java 21](https://prismlauncher.org/wiki/getting-started/installing-java/) to play the game.

1. Click `Add Instance`
2. Select `Modrinth` tab from the left
3. Select "Easy Multiplayer"
4. Click `OK`
5. The modpack will now install.
6. Once installed, double-click the icon to play.

### [Steam Deck](https://www.steamdeck.com/) + Prism Launcher <a href="#steam-deck--prism-launcher" id="steam-deck--prism-launcher"></a>

1. With Steam Deck turned on, hold down `⏻` (power) and tap `Switch to Desktop`.
2. From the taskbar, select 👜 "Discover".
3. Tap the searchbar on the top left corner, then press ❎ to open the on-screen keyboard.
4. Search for "Prism Launcher" and tap `Install` on the first result.
5. Launch it and go through its initial setup process, then close it.
6. Open Steam app, select `Games` → `Add a Non-Steam Game to My Library...` → select Prism Launcher → `ADD SELECTED PROGRAMS`.
7. Close Steam and launch `Return to Gaming Mode`.
8. Launch Prism Launcher from your game library.
9. Tap `Add Instance`
10. Select `Modrinth` tab from the left
11. Select "Easy Multiplayer"
12. Click `OK`
13. The modpack will now install.
14. Once installed, double-tap the icon and wait.
15. Tap `Options...` → `Controls...` → `Controller Settings...`
16. Select a controller, then `Done` → `Done` → `Done`
17. The game is now set up and you can just launch it from your game library from now on.
18. Bonus: if you want a better icon in your game library, [follow these instructions](https://prismlauncher.org/download/steam-deck/#setting-up-artwork).

P.S. If you get Deck-specific issues, try asking on [r/SteamDeck](https://old.reddit.com/r/steamdeck) .

### [MultiMC](https://multimc.org/) <a href="#multimc" id="multimc"></a>

You need [Java 21](https://adoptium.net/temurin/releases/?version=21\&package=jre\&arch=x64#version-filter) to play the game.

1. Click `Add Instance`
2. Select `Modrinth` tab from the left
3. Select "Easy Multiplayer"
4. Click `OK`
5. The modpack will now install.
6. Once installed, double-click the icon to play.

## Not supported <a href="#not-supported" id="not-supported"></a>

### <mark style="color:blue;">GDLauncher</mark> <a href="#gdlauncher" id="gdlauncher"></a>

Due to technical limits and issues, GDLauncher is no longer supported. It is recommended to migrate to Prism Launcher:

1. [Install and run Prism Launcher](https://prismlauncher.org/)
2. Click `Add Instance`
3. Select `Modrinth` tab from the left
4. Select "Easy Multiplayer"
5. Click `OK`
6. The modpack will now install.
7. Once installed, click the `Folder` button on the left.
8. Open GDLauncher
9. Right click on your previously used instance → `Open Folder`
10. Copy the important files and folders over:
    * `saves` for your local worlds
    * `resourcepacks`, if you use any
    * `screenshots`
    * `servers.dat` for your multiplayer servers
    * `options.txt`, if you want to keep your vanilla option changes
11. Launch the instance on Prism and confirm everything is correct
12. Uninstall GDLauncher

### Pojav Launcher <a href="#pojav-launcher" id="pojav-launcher"></a>

Pojav Launcher is not yet supported due to drawbacks (long installation process, high energy usage, performance may not be better etc), but is being considered.

### ATLauncher <a href="#atlauncher" id="atlauncher"></a>

*Not to be confused with* [*TLauncher*](#tlauncher)*.*

ATLauncher is currently not supported simply because the interface is confusing and complex. There have been discussions with its developer to improve this and it may be considered in the future.

### PolyMC <a href="#polymc" id="polymc"></a>

**PolyMC is compromised and you should uninstall it immediately!**

To migrate to Prism Launcher (a safe fork of PolyMC), follow these instructions:

1. Uninstall PolyMC
2. Install [Prism Launcher](https://prismlauncher.org/)
3. Launch it and pay attention to the prompt you get:
   1. > It looks like you used PolyMC before. Do you want to migrate your data to the new location of Prism Launcher?
      * Click `Yes` and the migration will complete.
   2. > It looks like you used PolyMC on Windows before. Do you want to migrate your data to the new location of Prism Launcher?
      * Click `Yes` and the migration will complete.
   3. > Old data from PolyMC was found, but you already have existing data for Prism Launcher. Sadly you will need to migrate yourself. Do you want to be reminded of the pending data migration next time you start Prism Launcher?
      * Click `No` and follow manual migration instructions below.
4. If needed, [update](#prism-launcher) or [install](#prism-launcher) the modpack again
5. To run the modpack, double click the Easy Multiplayer icon

<details>

<summary>Manual migration</summary>

1. Close Prism Launcher
2. Go to one of these directories according to your operating system:
   * Portable (Windows/Linux): `PolyMC/instances`
   * Windows: `%APPDATA%/PolyMC/instances`
   * macOS: `~/Library/Application Support/PolyMC/instances`
   * Linux: `~/.local/share/PolyMC/instances`
3. Select all the files and folders in the instances folder, right click on one of them and select `Copy`
4. Open Prism Launcher, click `Folders`, then `View Instance Folder`
5. Once your instance folder has opened, right click anywhere and select `Paste`
6. Close Prism Launcher and reopen it, your instances should be there
7. Sign in to your accounts, configure Prism Launcher to your preferences

</details>

### TLauncher <a href="#tlauncher" id="tlauncher"></a>

*Not to be confused with* [*ATLauncher*](#atlauncher)*.*

[TLauncher is malware](https://www.youtube.com/watch?v=SBTH9n6lz9o), so it will never be supported by Easy Multiplayer. It is highly recommended to [reset your entire computer](https://www.howtogeek.com/202590/stop-trying-to-clean-your-infected-computer-just-nuke-it-and-reinstall-windows/), then come back to this page and follow install instructions for any supported launcher.

#### Cracked launchers <a href="#cracked-launchers" id="cracked-launchers"></a>

Any launchers that let you run the game without having purchased it first are not supported.

#### Other launchers <a href="#other-launchers" id="other-launchers"></a>

Technically you can install it in *some* other launchers that support Modrinth modpacks or in *any* launcher by following the vanilla instructions. However, please do not ask for support here if you use an unsupported launcher.

#### Other modpacks <a href="#other-modpacks" id="other-modpacks"></a>

While it is theoretically possible, this is **not advised**:

* mods may have conflicts
* neither Easy Multiplayer or the other modpack will be able to support you

Instead, we recommend you to use modpack with other mods added by you.

#### Game clients <a href="#game-clients" id="game-clients"></a>

Easy Multiplayer is not compatible with any "game clients", including "hacked clients" and "PvP clients". Use normal mods instead!

#### Bedrock Edition <a href="#bedrock-edition" id="bedrock-edition"></a>

Easy Multiplayer is not compatible with Bedrock Edition. See also: [Pojav Launcher](#pojav-launcher)

## Servers <a href="#servers" id="servers"></a>

Any server that works with vanilla Minecraft is supported, no changes are necessay to the server.

## Quilt/Fabric <a href="#quilt" id="quilt"></a>

Easy Multiplayer is based on [Quilt](https://quiltmc.org/), not [Fabric](https://fabricmc.net/).

It can be attempted to run it through Fabric, but not all mods and configurations work without changes. If you do attempt it, you're on your own - do not ask for support from the modpack.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://naberno.gitbook.io/wiki/how-to-install-easy-multiplayer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.