Huckleberry Installing

Installing Huckleberry (Windows)

Getting Huckleberry on Windows is simple, download the executable (https://github.com/Runsafe/huckleberry-launcher/releases/download/vWindows/HuckleberryLauncher.exe) somewhere on your computer and run it. Every time you want to play Huckleberry, simply run the launcher again! The launcher will handle everything for you, from authentication to keeping your game client up-to-date each time you launch it.

Installing Huckleberry (Mac/Windows XP)

Firstly, download and install Git (http://git-scm.com/downloads) for your operating system, following the installation wizard through, leaving all the settings at default.

Once done, download the Unix launcher script (https://github.com/Runsafe/huckleberry-launcher/releases/download/vUnix/unix_launch.sh). Next, create a new folder on your desktop and give it a name like "HuckleberryFolder". Locate the file "unix_launch.sh" in your computer downloads and put it in your new folder.

Using a Mac? Follow this step.

Once you've done this, find the application "Terminal" on your computer put it with the other applications at the bottom of the screen (such as your web browsers). Drag the folder "HuckleberryFolder" from your desktop onto the Terminal logo. This should open a new Terminal window. Type "chmod 777 unix_launch.sh" and hit enter. Then type "sh unix_launch.sh" and hit enter. Now type in the e-mail and password you use to sign into the Runsafe website. This should begin downloading Huckleberry.

Using Windows XP? Follow this step.

Double-click on the unix_launch.sh file you've just downloaded and it will ask for your e-mail address and password you use to sign into the Runsafe website. Once you've typed them in it should begin installing Huckleberry into the folder the script is in!

Installing Huckleberry (Linux)

Open a terminal window and run these commands:

mkdir huckleberry
cd huckleberry
curl -s -o run.sh http://huckleberry.runsafe.no/unix_launch.sh
chmod +x run.sh
./run.sh

You can now start huckleberry using the run.sh script. try ./run.sh --help for a list of arguments you can pass it!

Keeping Huckleberry Up-to-date

Keeping Huckleberry up-to-date is easy, simply run the script/launcher again (depending on your operating system) and it will do all the work for you! Before it launches the game, it will check all of your files and make sure everything is correct before running.

Troubleshooting

Logging in...

Logging into Huckleberry does NOT use your Minecraft/Mojang account details. Instead, it uses the e-mail address and password of your Runsafe account which you can create on our website (https://runsafe.no).

The launcher doesn't work!

If you're on Windows, you will need at least .NET 4.5! If you cannot upgrade to .NET 4.5 see the section for Windows XP users below.

When I click play, it goes back to the main menu?

This normally happens when your session is invalid. Simply close down the game, open up the launcher and click log-out, then log back in. If you're using the script launcher, you won't need to log-out, simply just type in your e-mail address and password again as normal. If you're still unable to play, contact an admin to see what the issue is!

When the loading bar is almost complete, it tells me a file could not be found?

Your Java environment is not set-up correctly. Follow this guide here to set it up: https://www.java.com/en/download/help/path.xml