Puzzle Pirates installation guide (Chromebook)

	ATTENTION: This is a third-party guide.
	It has been developed independently by a Puzzle Pirate player(s). It is not created, supported, or endorsed by Grey Havens. Players follow these instructions at their own risk. For a full list of third-party tools and guides, see this category list.

This guide is written specifically for installation on Chromebooks, by accessing the built in Linux platform.
(for people with little to no Linux experience)

Enable Linux

First you need to set up Linux on your Chromebook.
Full instructions and more information can be found here

You can continue to use your normal Chromebook apps and features, but turning on this environment lets you install Linux apps and use the Linux console.

chromium.org states: "Unless otherwise specified, all devices launched in 2019 and later support Linux on ChromeOS"
You can find the list of supported devices here

To enable linux:

• Select Settings
• Select About ChromeOS
• Select Developers
• Next to "Linux development environment" select "Set up"

Novice Linux help

Once Linux apps are enabled, open the 'Terminal' app Select 'penguin' under 'Linux' to bring up the console.

Read through the instructions below, commands needed can be cut from here; to paste in the Linux console use ctrl + shift + v

Java 8 Installation

The following Java installation instructions were found here

Run the following commands:

sudo echo "deb https://deb.debian.org/debian sid main" | sudo tee /etc/apt/sources.list.d/chrome_os_made_simple_java8.list

sudo apt update

sudo apt install openjdk-8-jdk

sudo rm /etc/apt/sources.list.d/chrome_os_made_simple_java8.list

You can verify Java installed correctly by running:

java -version

Java's installation path is required in the yohoho installation step, unless something changes the path should be:

/usr/lib/jvm/java-8-openjdk-amd64/jre

To find the Java installation path, you can type: (and ignore the /bin/java on the end)

readlink -f $(which java)

Game installatioin

Download the Game

• Either:
  • Download manually from yohoho-install.bin
  • Then, in the 'Files' app, copy the file 'yohoho-install.bin' from 'Downloads' to 'Linux files'
• Or:
  • Type the following from the console:

curl -O -L "https://download-cdn.puzzlepirates.com/yoclient/yohoho-install.bin"

Start the installer

Enter the following into the console:

chmod +x yohoho-install.bin

./yohoho-install.bin

Next you'll get the Licence Agreement, scroll to the end and type 'yes' if you agree.

Then you'll be asked which 'Java Virtual Machine' you'd like to use.

From the #Java 8 Installation instructions you'll see it should be:

/usr/lib/jvm/java-8-openjdk-amd64/jre

Finally, you will be asked where you'd like to install yoclient. You can press enter to have it installed to the default location:

/home/user/yohoho

Running the game

If you're still in your user directory, and you installed to the default location, you should be able to launch with this command:

./yohoho/yohoho

To add a launcher to the apps menu, simply copy the file 'Yohoho! Puzzle Pirates.desktop' from the yohoho install directory to '.local/share/applications'

(if you are using the File app; click the three dots in the top right to open the menu, and enable 'Show hidden files' to see the '.local' folder)