Skip to content

2024-09-13-linux-and-steam-deck-install-guide.md

Latest commit

 

History

History
187 lines (147 loc) · 9.27 KB

2024-09-13-linux-and-steam-deck-install-guide.md

File metadata and controls

187 lines (147 loc) · 9.27 KB
Raw
sitemap true
published true
toc true
title Linux (and Handheld) Install Guide
description Step-by-step guides to help you install and configure Project Quarm and related software for Linux devices.
keywords Project Quarm, Quarm, Quarm installation, TAKP, EverQuest, Zeal, game client, dgVoodoo2, eqgame.dll, linux, Steam Deck
author Pastrami
date 2025-04-23 13:42 -0400
Originally inspired by this guide, updated with correct links and more current instruction

NOTE: If you already have Quarm running on Linux, you still may be interested in Step 8 below that gives instructions on a useable controller format for playing in handheld mode.

Step Sub 0 Create a TAKP/Quarm Account

  1. Guide

Step 0 Boot into Desktop Mode (Steam Deck/Handheld only)

  1. Press Steam button
  2. Select Power
  3. Select Switch to Desktop

Step 1 Download/Install prerequisites

  • Flatpak (Already present on Steam Deck)
  • Lutris (From the Discover store)
    • Start Lutris to Initialize
  • ProtonUp-Qt (From the Discover store)

Step 2 Install GE-Proton Version(s)

  1. Open ProtonUp-Qt.
  2. Choose Lutris in the Install for: dropdown
  3. Select Add Version
  4. Choose Wine-GE in the Compatiblility Tool: dropdown
  5. Choose GE-Proton8-7 in the Version: dropdown
  6. Select Install
  7. Repeat the above steps to install GE-Proton8-26
    • I have no idea why this is required, but Quarm won't install without it

Step 3 Download All Appropriate Files

  1. Download windows client from TAKP

  2. Quarm patch files

    1. Go to Quarm Discord
    2. Go to #server-files channel
    3. Download pq_files_[date].zip

  3. Download the most recent Zeal

  4. Download Zeal compatible UI (skip step if using default ui)

    1. Go to Quarm Discord
    2. Go to #ui-discussion
    3. Download Zeal Compatible UI

    Warning - If you try to load a UI without zeal compatiblity your client will crash character select screen or when you type /loadskin with non zeal compatible UI

  5. Download custom dgvoodoo conf

    • You can close the Login modal to download if you don't have a dropbox account

Step 4 Install Quarm

  1. Open Lutris.net/games/everquest

  2. Click Install On the "Quarm Version"

  3. Choose Install when prompted by Lutris program

  4. Select the desired shortcuts to desktop, steam, or application menu.

    • Make sure Create steam shortcut is checked for steamdeck

  5. Click `Continue``

  6. Select ... and choose the appropriate zips for TAKP client zip file and Quarm zip file we downloaded above

    • The file names and version numbers may not match the examples provided in the popup, this is okay

  7. Keep dg_voodoo2_79_3.zip Selected as downloaded from installer.(See below)

  8. Click Install

    1. Click Install on any additional requirement popups
    2. Once Installation completed! is displayed, select Close

Step 4.5 Switch/Update to use the Quarm Patcher

  1. Quarm patch files
    1. Go to Quarm Discord
    2. Go to #server-files channel
    3. Download QuarmPatcher.zip
  2. Extract the contents of QuarmPatcher.zip to /home/USERNAMEHERE/Games/everquest/client
  3. In Lutris, right click Everquest Quarm and select Configure
  4. Navigate to Game Options
  5. Change the executable to /home/USERNAMEHERE/Games/everquest/client/eqemupatcher.exe

Step 5 Install Zeal and dgVoodoo.conf

  1. Right click Everquest in lutris
  2. Select Browse files
  3. Replace /home/USERNAMEHERE/Games/everquest/dgvoodoo/dgVoodoo.conf with the one downloaded in #3.5
    • Select Overwrite option
  4. Install Zeal compatible UI files /home/USERNAMEHERE/Games/everquest/client/uifiles/ with the files in #3.4
  5. Double click zeal_v[#].zip we downloaded in #3.3
  6. Drag uifiles from the zip directory to /home/USERNAMEHERE/Games/everquest/client
    • Select Overwrite option
  7. Drag Zeal.asi to /home/USERNAMEHERE/Games/everquest/client

Step 6 PLAY!

  • Click play button in Lutris or another shortcut like desktop shortcut. If you do not need to launch the game from steam/steamdeck you are done.

OR

Continue for Steam Deck/Steam

  1. Right click Everquest in lutris
  2. Select 'Create Steam Shortcut`
  • This may take a few tries or require you to restart Steam to take effect
  1. Open Steam
  • Or select the Return to Gaming Mode icon on your desktop if you're on Steam Deck
  1. Find Everquest Quarm in your library
  • In Non-Steam for the Steam Deck handheld library
  1. Click Play!
  • You MAY need to add ENABLE_GAMESCOPE_WSI=0 to the Options->Properties->Launch Options on Steam Deck

Bonus Step 7 Edit eqclient.ini

  1. Open [quarm-directory]/client/eqclient.ini
  2. Under [VideoMode] change to monitor specifications
    • Below is Optimal for Steam Deck, may need different values on other systems
    1. Width=1440
    2. Height=900
  3. Under [Defaults] you can toggle
    1. CombatMusic= to 1 for on, 0 for off
    2. ShowDyanmicLights= to TRUE for the best quality, or FALSE if you notice light flickering
    3. AllLuclinPcModelsOff= to TRUE for Classic models, FALSE for Luclin models
    4. EnableClassicMusic= to TRUE for Classic MIDI, FALSE for MP3s
  4. Under [Defaults] you can set
    1. ClipPlane=20 to set farthest view distance
    2. InspectOthers=FALSE as TRUE can cause a lot of accidental inspections as in annoying

Bonus Step 8 Import Character Settings

Note: This is for players who were playing elsewhere on another device

  1. Via the old device - Open [quarm-directory]/client

  2. Via the old device - Upload [charactername]_pq.proj.ini to a cloud service (like Google Drive)

  3. Via the old device - Upload UI_[charactername]_pq.proj.ini to a cloud service (like Google Drive)

  4. Via linux device - Download both files

  5. Via linux device - Place in [quarm-directory]/client

    • Warning - Importing from a client without zeal installed can cause issues if the character previously loaded with a non supported UI. If you are crashing from character select or while using /loadskin it is reccomended you change UISkin=Default to troubleshoot as seen below.

Bonus Step 9 Adopt an actual useable controller profile (Steam Deck)

Note: I didn't create this layout. This layout was originally created by Yuuhi for P99, I've simply exported it to Quarm. You can read more about this layout via this Reddit post. This profile is AMAZING and really pushes the bounds of what a Steam controller profile can do by exploring layers, hover and radial menus, and providing a 'touchpad' keyboard.

Note: As you play and explore this profile, edit it to make different versions and share your different templates with the community!

  1. Open Steam in handheld mode
  2. Rename Game to Everquest Quarm (EXACTLY)
    • You can rename to Everquest, EverQuest, Project 1999, or EverQuest Free-to-Play to see other appropriate controll profiles, feel free to explore! Mine is just shared under Everquest Quarm
    1. Click Settings cog
    2. Select Properties
    3. Rename the shortcut to Everquest Quarm
  3. Navigate to Everquest Quarm in your library under Non-Steam games
  4. Close Properties window (Press B)
  5. Select the Controller icon
  6. Press Up Arrow once to Browse Community Layouts ... above View Laytout/Edit Layout
  7. Hit R1 to Community Layouts
  8. Hit X to Show All Layouts
  9. Press Down Arrow to Pastrami's Layout with workable keyboard (based off Yuuhi's P99)
  10. Press A to Select
  11. Press X to Apply Layout
  12. Boot up the game and play!

Bonus Step 10 Remove dgVoodoo Watermark Through Lutris

  1. Open Lutris and Select Everquest
  2. Select run exe in wine prefix (second arrow to the right of Play)
  3. Select dgVoodooCpl.exe from the correct folder(lutris does not store this in the client folder like on windows). It's default location is "/home/USERNAMEHERE/Games/everquest/dgvoodoo/"
  4. Uncheck dgVoodoo watermark in the "directx" tab of dgvoodoo options
  5. Click Apply and Ok to close out program.

Backup download for dgVoodoo

https://archive.org/details/dgvoodoo2_78_2_202205 OR dgvoodoo (Download entire Zip on the top right)