Tutorials/Playing and saving Minecraft on a thumb drive
Before beginning this tutorial, note that the following guides are only for the 2.x launcher. If you want to make minecraft portable for an older launcher version, please view this page instead
This tutorial explains how to run Minecraft on a portable drive. This is useful if you want to retain your game data (launcher profiles, worlds, resource packs, etc.) when switching computers.
The primary focus of this guide is to create an installation of Minecraft on a portable drive. However, the exact same steps can be followed to create a portable installation of the game; that is, an installation that is not "integrated" with the computer, which is useful for managing multiple installations and generally keeping things organised.
Note: After this guide the game will be only 99% portable: the game data will be stored and used by game and its launcher where you want but launcher will create
.minecraft directory anyway and will be placing there its log files (like update logs, logs with game messages and crashes, etc.)
Instructions (for Windows)
Note: The following Windows tutorial will guide you through installing the game to
D:\Games\PortableMinecraft\. However, this guide can be used to install the game to any directory. When following this guide, replace this directory with the directory you actually want to install the game to. Please also note that while this guide was written for Windows, it is still largely applicable to other operating systems with minor changes.
Navigate to the portable drive in the file explorer, and create the
D:\Games\PortableMinecraft\ directory. Next, create
Launcher folder for launcher with its data and
MyMinecraft folder (or another name of your choosing) for game data.
If you have existing game data, you can move it to the desired directory. Navigate to the
.minecraft folder and copy all of its contents (but not the folder itself) into
Now you need to move the launcher. Download
Minecraft.exe (if you don't have it) and move it to
Create an empty text file called
MyMinecraft.bat (or another name of your choosing) in the
Open the batch file with notepad or another text editor and paste the following text into it before saving the file:
@echo off start "" "%cd%\Launcher\Minecraft.exe" --workDir "%cd%\MyMinecraft"
Everything is now finished. When you want to play, just use the batch file to launch the game. Do not start the launcher directly (without using the batch file), or the game will just use the default directory in
%APPDATA% as its working directory. It is recommended to set the launcher's executable to have the "hidden" attribute to avoid accidentally running it. You could also make a shortcut on the Desktop to run the bat file without having to find it.
Instructions (for Linux)
Note: The following tutorial assumes that the USB disk is located (and mounted) at
/media/user/USBDisk, and that you would like to have portable minecraft at
/media/user/USBDisk/minecraft-portable. However, this guide can be used to install the game to any directory. When following this guide, replace this directory with the directory you actually want to install the game to.
Important preparation: You need to make sure that you have correct java version installed because linux launcher doesn't have its own java. If you want to play minecraft versions less than 1.13, you should have Java 8 installed and selected as default in your system because minecraft versions earlier than 1.13 don't support Java 11, they will just simply crash at launch.
Firstly, check which version of java is currently used in your system:
If your java(or openjdk, doesn't matter) version in the first output line doesn't look like
"1.8.0_xxx" (but instead looks like
"14", etc.), it means that Java 8 isn't installed or selected as default on your system.
Secondly, install Java 8 package on your system (depending on the distro the package name can be
java-1_8_0-openjdk, etc.) via terminal or graphical package manager. If your distro repositories don't have Java 8 package, maybe this can help.
Finally, run the following command and select the path containing previously installed Java 8 package name:
sudo update-alternatives --config java
Now, you are ready to install the game.
Start by creating directory for the game:
mkdir minecraft-portable && cd minecraft-portable
myminecraft folder (or another name of your choosing) for your minecraft game data:
Now, at this point, if you would like to copy all your existing game data, run the following command:
cp -r ~/.minecraft ./myminecraft
You now need to download the Minecraft Launcher. Do so by running the following command:
wget -O launcher.tar.gz https://launcher.mojang.com/download/Minecraft.tar.gz
Next, extract the
minecraft-launcher folder by using your favourite extraction utility. This tutorial assumes the extracted folder is located in
All the basic setup is completed. You will find the launcher at
To open the launcher correctly, you can run the following command:
/media/user/USBDisk/minecraft-portable/minecraft-launcher/minecraft-launcher -w /media/user/USBDisk/minecraft-portable/myminecraft
But the better way is to use a shell script and run it when you want to play Minecraft. Create empty file called
myminecraft.sh (or another name of your choosing) with the following text:
#!/bin/bash "$(dirname "$(readlink -f "$0")")"/minecraft-launcher/minecraft-launcher -w "$(dirname "$(readlink -f "$0")")"/myminecraft # Note: "$(dirname "$(readlink -f "$0")")" is the directory path of this script current location, like %cd% in Windows
Then make it executable:
chmod +x myminecraft.sh