Editing Getting Started on Linux (v3) Wine-Staging 6.0, vulkan & dxvk

<small> This is a work in progress. Please send any comments, corrections or concerns to @tragedie37 in the forums. </small>

This installation procedure is a marriage between the [[wikipedia:Getting_Started_on_Linux|original Linux installation instructions]] and @meriadoc's wonderful, but complicated, [[wikipedia:Getting_Started_on_Linux_(v2)|non-PlayOnLinux version]].

The reason this page exists is because the original version would not recognize my hardware while Meriadoc's version is able to correctly identify my GPU, due to its using vulkan and dkvx, but does not use PlayOnLinux (POL). POL is much easier for me to control how many clients I am running, rather than using command line arguments or a script. Optionally, I like installing a base wine-staging wine system as well as POL; this usually ensures that 32-bit binaries are included in your installation.

=== <u>PlayOnLinux</u> ===
See Optional Section below for steps to install POL and/or Wine; this guide assumes that the user has correctly installed POL, vulkan drivers (both 64 and 32-bit drivers) and wine.

# Download the latest [https://www.dropbox.com/s/bppy4ebt7vl7hwk/TAKP%20PC%20V2.1c.zip?dl=0 Windows client]
# Download the [https://www.dll-files.com/dinput8.dll.html 32-bit version of dinput8.dll], version number 6.0.6001.18000
# NOTE: 11/06/23 - Using latest wine (7.22) I did not have to install or use this file, this was actually messing up my install!
# Open POL
## Choose the <code>Tools | Manage Wine Versions</code> menu
### Under the "x86" section (32 bit), install the <code>6.0-staging</code> version
###;[[File:POL6Staging.png|250px]]
### You can choose to install wine-staging 2.2 as a fall back; however, I suggest also installing wine-staging 2.22, as well [See note below]
## Goto your POL folder at <code>/home/<username>/.PlayOnLinux/wine/linux-x86/6.0-staging</code> and make sure that there are no files containing <code>libz.so</code>; my installation did not have any
##;[[File:Libzso_example.png|250px]]
## Click on the <code>Configure</code> button; this will open a popup
##;[[File:POLConfigure.png|250px]]
## Click on NEW
##;[[File:POLNew.png|250px]]
## This will open another pop entitled, 'Virtual drive creator', click NEXT
##;[[File:POLVirtualDrive.png|250px]]
## Choose the 32 bit drive and click NEXT
##;[[File:POL32bit.png|250px]]
## Highlight 6.0-staging and click NEXT
##;[[File:POL6staging.png|250px]]
## Choose a name for the virtual drive, I named mine 'EverQuest' and move on to the next step
## Highlight 'EverQuest' and go to the 'Install Components' tab and install the following:
### dinput8
### vcrun2010
### dxvk (Note: choose the one without any numbers after it)
### (Optional) Microsoft corefonts
##;[[File:POLdinput8.png|250px]]
## Next, choose the 'Wine' tab and click on 'Configure'
##;[[File:POLConfigureWine.png|250px]]
## If POL prompts to install wine-mono and/or wine-gecko, allow it to install
## Once the 'Wine Configuration' pops up, go to the 'Staging' tab and click on 'Enable CSMT for better graphic performance'; even though it states that it's deprecated, it does not hurt to click on it and may cause problems if not; once done, click 'Ok' to close the window
##;[[File:POLcsmt.png|250px]]
## Go to the 'Display' and disable GLSL
##;[[File:POLglsl.png|250px]]
## Unzip the Windows client you downloaded from above; I recommend the 2.1c version, it includes freethemouse.dll and other recommendations; cut or copy the folder and paste it in <code>/home/(username)/PlayOnLinux's virtual drives/EverQuest/drive_c/Program Files/</code>
##;[[File:POLEQfolder.png|250px]]
## Download and unzip the <b>32-bit</b> file [https://www.dll-files.com/dinput8.dll.html dinput8.dll version 6.0.6001.18000]; copy it to <code>/home/(username)/PlayOnLinux's virtual drives/EverQuest/drive_c/windows/system32/</code>
##;[[File:POLdinput8 overwrite.png|250px]]
## Download [http://dege.freeweb.hu/dgVoodoo2/dgVoodoo2/ dgVoodo]; I grabbed the Latest Stable Version, 2.79.3
### Extract the downloaded zip file to a subfolder that you created (it extracts everything to the folder in which you put the zip file)
### Copy D3D8.dll and D3D9.dll to <code>/home/(username)/PlayOnLinux's virtual drives/EverQuest/drive_c/Program Files/EverQuest</code>; make sure to delete the existing d3d8.dll
### Rename the 2 files in the EverQuest directory and rename them to <code>d3d8.dll</code> and <code>d3d9.dll</code> (Note: Linux is case sensitive)
###;[[File:POLrenamed.png|250px]]
## Return to the 'Configuration' window and click on the 'Wine' tab; within the tab, click on the 'Registry Editor' button
##;[[File:POLregistry.png|250px]]
### Click your way to <code>HKEY_CURRENT_USER\Software\Wine\DllOverrides</code>
### Right click on the white space in the right-side window pane and click NEW -> STRING VALUE
#### Name it <code>d3d8</code>
#### Double-click on the DATA value and enter 'native'
####;[[File:POLregistry_override.png|250px]]
#### Ensure that d3d9, d3d10 and d3d11 all exist and have "native" as their value
#### Close the Registry Editor
## On the left-hand side of the Configuration window choose the 'General' tab and MAKE A NEW SHORTCUT FROM THIS VIRTUAL DRIVE
##;[[File:POLshortcut.png|250px]]
### Choose <code>eqgame.exe</code> and click NEXT
###;[[File:POLeqgame.png|250px]]
### Name the shortcut, I named mine 'EverQuest', click NEXT
### Then, choose 'I don't want to make another shortcut' and click NEXT
## Finally, we have to edit the <code>/home/(username)/PlayOnLinux's virtual drives/EverQuest/drive_c/Program Files/EverQuest/eqclient.ini</code>
### Open the <code>eqclient.ini</code> in your favorite editor, mine is [https://vim.rtorr.com/ vim]
###;[[File:POLvim1.png|250px]]
### Find the section [VideoMode] and enter your height and width (see example)
###;[[File:POLvmode.png|250px]]
### Save and close the file

<b>WARNING: Changing video display size in-game will cause the client to crash. If you need to change the video display resolution, close the game, edit the <code>eqclient.ini</code> and restart POL.</b>

Enjoy playing on the Al'Kabor Project in Linux!

Thanks and credit to the TAKP developers, @krakmojo for the original POL instructions and @meriadoc for his excellent v2 guide. It bears repeating that this is a work in progress; if you find a mistake or want to provide any feedback, please contact me via the forums @tragedie37.

=== <u>Notes on 2.2-Staging Installation</u> ===
For years, I've noticed a problem with choosing 2.2-Staging: When I tried to open the Wine Configuration tab or it tried to install gecko or mono, I could not see the window; after a lot of research, I was told to look at my running processes and check for an extremely small, unselectable box in the upper left hand corner of my monitor. Sure enough, it was there. If that happens to you, here's the fix:

* In POL, add 2.2-Staging and 2.22-Staging; I used 2.22 because it was the closest in numerical value that I found to work; newer versions of Wine through POL do not have the same files/structure
* First, make sure to delete any of the <code>libz.so</code> files, should be four of them
* Open up your favorite file manager and navigate to /home/<user>/.PlayOnLinux/wine/linux-x86/
*;[[File:POLlibx86-1.png|250px]]
* You should have two folders for <code>2.2-staging</code> and <code>2.22-staging</code>
*# Open up another file manager window and navigate one file manager to <code>2.2-staging</code> and the other to <code>2.22-staging</code>
*#;[[File:POLlibx86-2.png|250px]]
*# In the <code>2.2-staging/lib/</code> folder, delete the <code>libz.so</code> files if they exist
*#;[[File:POLlibzso-delete.png|250px]]
*# Copy all the files in the <code>2.22-staging/lib/</code> folder and paste them into the <code>2.2-staging/lib/</code> folder; <b>Do not choose to overwrite any existing files</b>
*#;[[File:POL2.22skip.png|250px]]
*# There will be seven files copied over that will allow <code>2.2-staging</code> to function normally:
*#* libfreetype.so
*#* libfreetype.so.6
*#* libfreetype.so.6.8.1
*#* libpng.so
*#* libpng12.so
*#* libpng12.so.0
*#* libpng12.so.0.49.0

You can use a command line argument to display the differences before and after. Note: this search will highlight even sub-folders, be aware that you don't need to pay attention to them:

<code>cd /home/<username>/.PlayOnLinux/wine/linux-x86</code><br />
<code>find "2.2-staging/" "2.2-staging/" "2.22-staging/" -printf '%P\n' | sort | uniq -u</code><br />
The above search will show you what's in <code>2.22-staging</code> and is missing in <code>2.2-staging</code>

=== <u>Install vulkan drivers</u> ===
This is needed to ensure that [[wikipedia:Vulkan|vulkan]] calls from POL are handled correctly. The installation will differ depending on your video card, as noted below.

* [https://youtu.be/j-inskOehOI?t=23 Ubuntu/Ubuntu-based] distros
*# <b>AMD</b>
*## Make sure that you have the 32-bit repository enabled: <code> sudo dpkg --add-architecture i386</code>
*## Install the vulkan drivers from the stock repository: <code>sudo apt-get install libvulkan1 mesa-vulkan-drivers vulkan-utils</code><br />
*##;This should also install the 32-bit/i386 versions
*# <b>NVidia</b>
*## Note: Make sure you have the latest driver supported by your specific video card; once that is done:
*## Install the NVidia repository for the most up-to-date vulkan drivers <code>sudo add-apt-repository ppa:graphics-drivers/ppa</code>
*## Update your repository list: <code>sudo apt-get update</code>
*## Install vulkan drivers: <code>sudo apt-get install vulkan vulkan-utils</code>
*## 11/6/23 Ubuntu Focal update - This didn't work for me and I had to run commands from this AskUbuntu answer here - [https://askubuntu.com/questions/1324989/unable-to-install-vulkan AskUbuntuAnswer]
*##;Please make sure that you understand what happens when you add another repository as that software may override what is delivered by the base Ubuntu installation
* Arch/Arch-based distros
* Void Linux
* OpenSUSE
* Solus

=== <u>Optional Steps: Install Wine</u> ===
Install wine and POL from the command line
* Ubuntu/Ubuntu-based distros
*# <code>sudo dpkg --add-architecture i386</code>
*# <code>sudo apt-get update</code>
*# Now, for wine, you have two choices, you can go with the default repository or with the latest from [https://www.winehq.org/ WineHQ]
*## WineHQ version
*### Add the GPG key <code>wget -qO- https://dl.winehq.org/wine-builds/winehq.key | sudo apt-key add -</code> (NOTE: You may have to install wget and or curl <code>sudo apt-get install wget curl</code>
*### Followed by: <code>sudo apt-get install software-properties-common</code>
*### Add the repository: <code>sudo apt-add-repository "deb https://dl.winehq.org/wine-builds/ubuntu/ $(lsb_release -cs) main"</code>
*### Install the wine-staging branch: <code>sudo apt-get install --install-recommends winehq-staging</code>
*### Verify your installation on the command line: <code>wine --version</code>
*## Ubuntu or Ubuntu-based distro standard repository (NOTE: You may get an outdated version, but, it may be more stable or not, your mileage may vary)
*### <code>sudo apt-get update</code>
*### <code>sudo apt-get install wine</code>
*# For POL, it's a bit easier
*## <code>sudo apt-cache search playonlinux</code>
*## If you see a result, then type: <code>sudo apt-get install playonlinux</code>
*## If you do not see a result, then something went wrong; visit [https://wiki.playonlinux.com/index.php/Installing_PlayOnLinux POL's website] or your distribution's website to figure out why
* Arch/Arch-based distros
*# Enable multilib support, or ensure it is enabled <code>vim /etc/pacman.conf</code>
*## Search for the line <code>#Include = /etc/pacman.d/mirrorlist</code> and remove the crunch ('#') from in front of the word 'Include'
*## It should now look like
*##::<code>[multilib]</code>
*##::<code>Include = /etc/pacman.d/mirrorlist</code>
*# Complete a system upgrade <code>sudo pacman -Syu</code>
*# Install wine <code>pacman -S wine</code>
*# Install wine-gecko and wine-mono <code>pacman -S wine-gecko wine-mono</code>
*# Note, after the above install, you may see a list of uninstalled dependencies; I recommend installing them, especially the 32-bit packages
*# Check that you have successfully installed it <code>wine --version</code>
*# Install POL: <code>sudo pacman -S playonlinux</code>
* Void Linux
*# If you're using Void Linux, I'm assuming you will know what to do; but, to be thorough
*# Install necessary repositories
*## <code>sudo xbps-install -Sy void-repo-nonfree void-repo-multilib void-repo-multilib-nonfree</code>
*## Update the repository list and check for upgrades: <code>sudo xbps-install -Suv</code>
*# Install wine <code>sudo xbps-install -Sy wine wine-32bit winetricks wine-mono wine-gecko</code>
*# Check your wine installation: <code>wine --version</code>
*# Install POL: <code>xbps-install -Sy playonlinux</code>
* OpenSUSE: TBD
* Solus: TBD