Support us on Patreon to keep GamingOnLinux alive. This ensures all of our main content remains free for everyone. Just good, fresh content! Alternatively, you can donate through PayPal. You can also buy games using our partner links for GOG and Humble Store.
We do often include affiliate links to earn us some pennies. See more here.

How-to: Minecraft with the Steam Controller on Linux desktop and SteamOS

By -
Last updated: 12 Jun 2021 at 12:05 pm UTC

Note: Run any of this at your own risk, don't hold me up at gunpoint if you screw it up. Works perfectly fine for me. I can/will probably keep updating this based on feedback to make it as easy as possible for people.

I wanted to see how easy it was to not only get Minecraft working with the Steam Controller on Ubuntu, but to also see if I could get it all on my Steam Machine, and as it turns out most of it is easy enough.

Linux desktop (Ubuntu, Fedora etc)
For desktop Linux like Ubuntu it’s as easy as having the Minecraft.jar downloaded from here, making a tiny bash script with this in it:

Quote#!/bin/bash
java -jar ~/Downloads/Minecraft.jar


You can simply copy/paste that into a blank text file in gedit or whatever text editor you use

Save that text file as something like “minecraft.sh” and set it to executable by right clicking -> select properties up the top and checking the “Allow executing file as program” box.

Then you can add it to Steam using the “Games -> Add a non-Steam Game to My Library” option like so:
image
Click Browse and find your way to where you saved the file created above and you will see this:
image

And then it will just work, you can launch it from Steam Big Picture mode and it will pick up the Steam Controller perfectly.

This will also allow you to stream it to your Steam Machine, or another Linux box running Steam. I’ve tested it myself, and it works well while streaming!

SteamOS
You will need to enable desktop mode in SteamOS by going to Settings -> Interface and enabling Linux desktop mode. Then quit to the desktop using the top right button (like you would turn off your machine, there will be a new option available to go to the desktop).

The SteamOS desktop user account doesn’t come with a password set (see their support page here), so you will need to open the terminal (push the mouse to the top-left corner, type terminal and open it). Then type “passwd” and enter a password twice to create it.

You can then download this script (or copy it out from the spoiler tags below) (poached and edited from here, cheers!).

Save it to the standard Downloads folder and then run the below command in terminal:

Spoiler, click me
#!/bin/bash
# Init

# Make sure only root can run
if [[ $EUID -ne 0 ]]; then
echo "This script must be run as root." 1>&2
exit 1
fi

echo "The script was run as root!"
echo "Working to install Java..."
echo "Downloading files..."
wget --no-check-certificate --no-cookies --header "Cookie: oraclelicense=accept-securebackup-cookie" http://download.oracle.com/otn-pub/java/jdk/7u65-b17/jre-7u65-linux-x64.tar.gz
wget https://s3.amazonaws.com/Minecraft.Download/launcher/Minecraft.jar

if [ ! -f jre*x64.tar.gz ]; then
echo "Error, Java failed to download correctly, please try again..."
exit 1
fi
if [ ! -f Minecraft.jar ]; then
echo "Error, Minecraft failed to download correcly, please try again..."
exit 1
fi

# Install Java
mkdir /usr/local/java
tar xzf jre*x64.tar.gz -C /usr/local/java
JAVAVER=$(ls /usr/local/java)
echo "Java version is: $JAVAVER"
echo "JRE_HOME=/usr/local/java/$JAVAVER" >> /etc/profile
echo "PATH=\$PATH:\$HOME/bin:\$JRE_HOME/bin" >> /etc/profile
echo "export JRE_HOME" >> /etc/profile
echo "export PATH" >> /etc/profile
update-alternatives --install "/usr/bin/java" "java" "/usr/local/java/$JAVAVER/bin/java" 1
update-alternatives --install "/usr/bin/javaws" "javaws" "/usr/local/java/$JAVAVER/bin/javaws" 1
update-alternatives --set java /usr/local/java/$JAVAVER/bin/java
update-alternatives --set javaws /usr/local/java/$JAVAVER/bin/javaws
. /etc/profile
echo "Java is installed!"
echo
echo
echo "Java self check"
echo "----------------------------"
java -version

# Install Minecraft
mkdir /home/$SUDO_USER/.minecraft
mv Minecraft.jar /home/$SUDO_USER/.minecraft
touch /home/$SUDO_USER/Desktop/minecraft.desktop
echo '[Desktop Entry]' >> /home/$SUDO_USER/Desktop/minecraft.desktop
echo 'Name=Minecraft' >> /home/$SUDO_USER/Desktop/minecraft.desktop
echo 'Exec=java -jar /home/'$SUDO_USER'/.minecraft/Minecraft.jar' >> /home/$SUDO_USER/Desktop/minecraft.desktop
echo 'Icon=/home/'$SUDO_USER'/.minecraft/minecraft_logo.ico' >> /home/$SUDO_USER/Desktop/minecraft.desktop
echo 'Terminal=false' >> /home/$SUDO_USER/Desktop/minecraft.desktop
echo 'Type=Application' >> /home/$SUDO_USER/Desktop/minecraft.desktop
echo 'Categories=Application;' >> /home/$SUDO_USER/Desktop/minecraft.desktop
chmod +x /home/$SUDO_USER/Desktop/minecraft.desktop
wget https://dl.dropbox.com/s/l02or84ws4a1bde/minecraft_logo.ico
mv minecraft_logo.ico /home/$SUDO_USER/.minecraft
chown -R $SUDO_USER:$SUDO_USER /home/$SUDO_USER/.minecraft

# Cleanup
rm -R jre*.tar.gz

 

Quotesudo ~/home/Downloads/installminecraft.sh


You can easily get to the terminal on SteamOS desktop mode, by going to the top left corner which brings up the overlay, then type terminal and the icon will appear! This is perfectly safe, I’ve tested it multiple times myself.

It will automatically download Java for you, and automatically move the Minecraft.jar file into /home/.minecraft for you to clean up the cruft. Once finished, it will create a Minecraft file on the desktop you can double click to run.

You are able to adjust the keys to the gamepad using Minecraft’s options menu, which surprised me I didn’t think it would be picked up properly. I was able to walk around with the stick, and interact with the environment. It's not as good as having it in Big Picture mode to configure it properly though. I haven’t been able to figure out how to get it to work from the SteamOS Big Picture mode yet, feel free to share tips in the comments. I will update the article if anyone manages to give me a pointer on that.

Article taken from GamingOnLinux.com.
Tags: Editorial, HOWTO
0 Likes
About the author -
author picture
I am the owner of GamingOnLinux. After discovering Linux back in the days of Mandrake in 2003, I constantly checked on the progress of Linux until Ubuntu appeared on the scene and it helped me to really love it. You can reach me easily by emailing GamingOnLinux directly. You can also follow my personal adventures on Bluesky.
See more from me
The comments on this article are closed.
All posts need to follow our rules. For users logged in: please hit the Report Flag icon on any post that breaks the rules or contains illegal / harmful content. Guest readers can email us for any issues.
15 comments Subscribe

GNUzel 12 Nov 2015
this makes me excited for when i finally get mine sometime.
pb 12 Nov 2015
How to get Minecraft on SteamOS in Big Picture mode:

0. I assume you already set up password for 'desktop' user, because 'steam' user doesn't have sudo rights.
1. Go to settings and find "Add external app" or something like that (sorry, writing from memory, feel free to correct the post) - and add XTerm
2. Go to library and launch XTerm
3. Download Minecraft.jar wget https://s3.amazonaws.com/Minecraft.Download/launcher/Minecraft.jar
4. Create a 'minecraft' script
echo "java -jar /home/steam/Minecraft.jar" >minecraft
chmod 755 minecraft
5. Create a 'minecraft.desktop' file containing something along these lines:
[Desktop Entry]
Name=Minecraft
Exec=minecraft
Icon=steam
Terminal=false
Type=Application
6. su to user desktop su desktop
7. Copy the files where they should go:
sudo cp minecraft /usr/bin/
sudo cp minecraft.desktop /usr/share/applications/
8. exit Xterm
9. go to setting and add Minecraft exactly the same way you added XTerm in #1

Notes:
- I used 'steam' icon for Minecraft because it's sure to be there and because I don't care much - feel free to use any icon you like, maybe there even are some official icons, no idea
- I had some weird text input problem in the launcher (couldn't type login/password) which I circumvented by copying my ~/.minecraft dir from laptop to steambox, so I was logged in automatically. Might be general SteamOS/BPM problem but might be specific to alchemist, or even my own system - please report back if you can confirm that.
- feel free to point any mistakes, I typed it all from memory and in a bit of a hurry, so there may be some typos or logical errors - hopefully not!
- standard disclaimer - test it out on your own responsibility, I won't refund any broken hardware :D
- forgot one thing: of course you have to install java first! I did it (sudo-ing from 'desktop' user) by adding debian repos to /etc/apt/sources.list and then apt-get install openjdk-8-jre or sth like that. Won't give specific instructions from memory though ;-)

[edit] changed 'code' to 'quote' - looks worse now but 'code' removed newlines for some reason.
[edit2] changed it back but puting every line separately, looks moderately good imo ;-)


Last edited by pb on 12 Nov 2015 at 10:53 pm UTC
MayeulC 12 Nov 2015
It's a great idea to put tutorial like these on this site, most notably for people who are new to Linux/SteamOS

I think it would be great if someone could post here a tutorial explaining how to get emulators running, as well as installing a package manager. I do not have time to do it myself yet, but if it hasn't been done by the time I get some spare time in my hands, I'll write one for sure. I've pointed out Lutris as a possible solution in the past, but I don't really know if it's difficult to get it running on SteamOS.
Edit: the official Minecraft launcher is publicly available from here, as listed there. I don't really see why you didn't include it.
Edit2: One could just provide a .deb with minecraft too, no?


Last edited by MayeulC on 12 Nov 2015 at 10:43 pm UTC
Liam Dawe 12 Nov 2015
It's a great idea to put tutorial like these on this site, most notably for people who are new to Linux/SteamOS

I think it would be great if someone could post here a tutorial explaining how to get emulators running, as well as installing a package manager. I do not have time to do it myself yet, but if it hasn't been done by the time I get some spare time in my hands, I'll write one for sure. I've pointed out Lutris as a possible solution in the past, but I don't really know if it's difficult to get it running on SteamOS.
Edit : the official Minecraft launcher is publicly available from here, as listed there. I don't really see why you didn't include it.
You're right, I didn't even realise that was the legal download in the original script.

I have updated it now to not make people download Minecraft.
Liam Dawe 12 Nov 2015
@pb, I tried that, but I get permission errors when trying to download in xterm.
pb 12 Nov 2015
@pb, I tried that, but I get permission errors when trying to download in xterm.

Are you logged as user 'steam' and in /home/steam? I assumed that's where you land after starting xterm from Big Picture, but maybe it's not universal.

BTW now I noticed that you mentioned some script that already does most stuff which I mentioned in my post and even installs oracle's java - if I'm not wrong, after running that script you should be able to simply add Minecraft from settings -> add external app and it should work in BPM w/o problems. I wish I knew about that script rather than figure it all out by myself. ;-) But it's still useful as it may be used to add pretty much any other app - you only need to create a proper .desktop file for a game/app you installed and it should be easily addable and launchable from BPM.


Last edited by pb on 12 Nov 2015 at 11:04 pm UTC
DamonLinuxPL 12 Nov 2015
So why we need this simply script in bash? We can't run in directly from Steam as .jar file?
tamccullough 13 Nov 2015
Fantastic. So looking forward to playing on the couch with the kids.


Last edited by tamccullough on 13 Nov 2015 at 1:57 am UTC
rustybroomhandle 13 Nov 2015
Newbies might also like to know how to install Kodi on their Steam Machine since SteamOS media centre functionality is a bit not-quite-there. :)

http://kodi.tv/
Crazy Penguin 13 Nov 2015
Nice! Will try that if I get my hands on a Steam Controller.
Tried playing Minecraft once with an normal Gamepad on a XBox which kinda sucked.

Another thing with adding Non-Steam games & Apps to Steam, is that you will get kicked out of the game everytime Steam gets an update or looses contact to the Steam server :(.

Newbies might also like to know how to install Kodi on their Steam Machine since SteamOS media centre functionality is a bit not-quite-there. :)

http://kodi.tv/

Sure and burn a lot of power ~200W/h (depening on model) for just watching movies :(. A Raspberry Pi needs max. 3-4 W/h and small machine with an ATOM CPU needs 10-15W/h.

So why we need this simply script in bash? We can't run in directly from Steam as .jar file?

Steam can't run a .jar file out of the box. As can see in the screenshots you only can add a filename BUT no parameters. So you have to wrap the full command line into a shell script.
tuubi 13 Nov 2015
View PC info
  • Supporter Plus
Another thing with adding Non-Steam games & Apps to Steam, is that you will get kicked out of the game everytime Steam gets an update or looses contact to the Steam server :(.
Does it help if you set Steam to offline mode?

Newbies might also like to know how to install Kodi on their Steam Machine since SteamOS media centre functionality is a bit not-quite-there. :)

http://kodi.tv/

Sure and burn a lot of power ~200W/h (depening on model) for just watching movies :(. A Raspberry Pi needs max. 3-4 W/h and small machine with an ATOM CPU needs 10-15W/h.
Are you suggesting people have different devices for different uses, like one for media and one for gaming? Fine I guess, and you will most likely save on power bills, but that kinda defeats the purpose.

Kodi does support the common video acceleration APIs and allows you to tweak audio and video settings to your hearts content. Here running 1080p h.264 video content with a relatively high bit rate (at pretty much default settings, some tweaked to higher quality as opposed to lower resource usage) my GPU didn't even switch out of its lowest power mode and CPU load was negligible. So I doubt the power draw is anywhere near gaming levels. I have no way to measure it though.
M@GOid 13 Nov 2015
Well, if you want a less painfull way to play Minecraft, may I suggest you try this:

View video on youtube.com

http://www.minetest.net/
Storminator16 13 Nov 2015
Steam can't run a .jar file out of the box. As can see in the screenshots you only can add a filename BUT no parameters. So you have to wrap the full command line into a shell script.

(If I'm not misrepresenting what you are saying) Not necessarily, you just need to wrap your commands in quotation marks. I run a couple of .jars directly out of Steam, and you'll get the Steam overlay. I believe this is the video I originally saw that showed I could do so: https://www.youtube.com/watch?v=OcBeiYRJ198

Edit: Never mind, I ran into an issue today and now understand your point. Can't pass parameters to the .jar file the way I mentioned. If you don't need to pass parameters then it is acceptable.


Last edited by Storminator16 on 14 Nov 2015 at 3:40 pm UTC
ProfessorKaos64 13 Nov 2015
Definitely should ass this as a script to SteamOS-Tools.
bmcwal 8 Jan 2016
Brand new Linux user here requesting some hand holding!

I'm running SteamOS and am trying to get Minecraft to work without any success so far. First of all, I tried the youtube link referenced in the OP, but when I try and open Minecraft a dialog box pops up to say "There was an Error Launching the Application".

Looking for a fix for that has brought me here, and I'd like to try the OP's dropbox script, but it's just returning a 404 right now; does anyone have a mirror?

Without that, I've tried pb's method, but I can only get as far as step 3 (download minecraft.jar) only to be told that Permission is denied. Any suggestions?
While you're here, please consider supporting GamingOnLinux on:

Reward Tiers: Patreon. Plain Donations: PayPal.

This ensures all of our main content remains totally free for everyone! Patreon supporters can also remove all adverts and sponsors! Supporting us helps bring good, fresh content. Without your continued support, we simply could not continue!

You can find even more ways to support us on this dedicated page any time. If you already are, thank you!
The comments on this article are closed.