Installation Guide

Setting up Turtle WoW is pretty straightforward for experienced PC users, but here are the full instructions for those new to downloading games manually onto their operating system:

## Account and Client

1. Load up the computer you wish to play on
2. Visit https://turtle-wow.org/#/home
3. Click the Download Client button
4. Use the Direct Download link to start downloading the game, about 8GB . You can try the other downloads like Google Drive, Mediafire. It doesn't matter which one you choose, they are the same download, but one of the options might let you download faster. If you know what you are doing with Torrenting, try the torrent option and load it with a torrent client like Deluge.
5. While the download is in progress, head back to https://turtle-wow.org/#/home and click on the green Sign Up button.

* Remember your account name and password, as you will use them to log into the game. Keep these secret, and please we suggest that you do not reuse a password you have used elsewhere!
* Your email can be used for password resets and important communication from the staff.
* The forum username will be publicly displayed if you decide to log in and post with this account on the Turtle WoW forums at https://forum.turtle-wow.org/

Once you have the .zip downloaded and your account ready, setting your game up will differ a bit depending on your operating system:

## Windows

1. Open the turtle wow .zip file with your file explorer
2. Extract the .zip. This can be wherever you want it to be placed, and we recommend it be somewhere in your user folder, but just make sure that you do NOT place turtle wow's folder into your system's C:\Program Files folder.
3. Go inside the folder, right click the WoW.exe, and create a shortcut onto your desktop. You should make a shortcut to WoWFoV.exe instead, if you use a widescreen 16:9 monitor.
4. Go to your desktop, and launch the game with the shortcut you made. Log in and enjoy.

## MacOS

Since Turtle WoW only has a native Windows x86 version, you will need external tools to run the game and its .exe. Likely your best bet is to set up a Windows VM with Parallels, especially on an Apple Silicon (M1/M2) Mac.

1. Follow the directions from Parallels to install Windows.
2. Once you have your Windows VM set up, download the Turtle client within this VM and follow the #Windows instructions.

**Note:** In Parallels, you may receive an error similar to the one below immediately after entering the world and when opening the Video Options dialog. This can be addressed by installing Screen Resolution Dropdown Fix.

```
Interface\FrameXML\UIDropDownMenu.lua:156: attempt to concatenate global UIDROPDOWNMENU_OPEN_MENU' (a nil value)
```

#### Intel Macs

Some Intel Mac users have reported success with Crossover/Wineskin, so if you're a little more technical, feel free to give that a try.

For Intel Macs running Catalina and newer, Porting Kit has successfully run Turtle WoW. After installing Porting Kit, use the following steps:

1. Go to "Add Application"
2. Select the Turtle WoW executable
3. At the "Advanced Settings" screen, set the Engine Version to WS11WineCX64Bit19.0.2
4. Proceed with the installation, default settings for everything else are fine
5. Run Turtle WoW through Porting Kit

## Steam Deck

If you installed Windows onto your steam deck, just follow #Windows.

These instructions are for people who are using the Steam Deck's default setup, where we will use Steam's UI to manage this game.

1. We assume you already have used the Deskop Mode of your steam deck to complete the #Account and Client steps, and that you now have your account ready and the .zip downloaded
2. In desktop mode, extract the .zip to a folder of your choice.
3. Copy down the full path to your WoW.exe
4. Pull up Steam's Desktop mode
5. Go to Library -> on the bottom left Add A Game -> Add a new non-steam game.
6. Hit browse, and locate the WoW.exe. You can also select WoWFoV.exe instead, if you use a widescreen 16:9 monitor.
7. Select this new game entry that has been created -> click the Gear icon -> select Properties -> Compatibility -> and check the option "Force the use of a specific Steam Play compatibility tool" option
8. On the dropdown, choose Proton Experimental.
9. Close the settings, and launch Turtle WoW and enjoy.

Optionally, you can download nice Turtle WoW banners from the Steam Grid DB, and add these on the Steam entry by Right clicking the entry -> Manage -> Set Custom Artwork, and on the game's page by Right clicking the top -> Set Custom Background

If you want to play Turtle WoW in the Steam Deck's handheld mode, we suggest using the ShaguController addon to tweak the UI to be better suited for this, and it will set default keybindings that line up better with Steam's default controller layout. See #Addons for further instructions on how to install Addons.

If in the future, you ever would like to move the location of your game, move the folder in your Desktop Mode, and be sure to update this Steam game entry with the new location.

## Linux+Lutris

The #Steam Deck instructions will work for Linux users that manage all their games through Steam. However, for general Linux users, we have Lutris as a better alternative for managing all kinds of games, handling runtimes, DXVK, and the same technology that Steam does, while also giving you easy access to far more settings to really tinker your experience.

We assume that your system is up to date, and you have the latest drivers set up. If not, follow your Linux Distro's guides on how to do this:

* Arch users: Updating, Graphics drivers.
* Pop\_OS users: Turn on Automatic Updates in the system settings.
* Ubuntu users: Use the Update Manager to update. NVIDIA users need to Install the proprietary drivers, AMD and Intel should work out of the box.
* Debian users: Updating, Graphics drivers.

With your system ready and able to play games in general:

1. With the Turtle WoW zip that you have downloaded, extract it somewhere nice in your home folder (or anywhere your Linux user has full read/write/execute permissions).
2. Copy down the location of your folder.
3. Visit https://lutris.net/downloads for instructions on how to install Lutris onto your Linux Distro.
4. Visit this GloriousEggroll Blogpost for instructions for your Linux Distro, on how to easily install every dependency that any game, including Turtle WoW, would ever need.
5. Once Lutris and these dependencies are installed, open Lutris, hit the top left button, and "Add locally installed game".
6. Name it Turtle WoW, select the "Wine" runner from the list.
7. Hit the "Game options" tab and Browse... to where you had set up your Turtle WoW folder, and select the WoW.exe. You can also select WoWFoV.exe instead, if you use a widescreen 16:9 monitor.
8. For the Working Directory and Wine prefix options, set both use the Turtle WoW folder itself. For example, if your Executable is at `/home/username/Turtle/WoW.exe`, you need to set these two options to `/home/username/Turtle/`
9. Hit Save on the top right
10. Find the Turtle WoW entry in Lutris, launch and enjoy.

Optionally, you can download nice Turtle WoW banners from the Steam Grid DB, and add these by going to the entry -> Configure, then select the banners.

If in the future, you would ever like to move the location of your game, use Lutris's Configure -> Directory Move feature.