Editing Getting Started on Mac (Intel based)

== Obtaining the Client ==

TAKP's client is from the December 2002 era. This is the actual client used in the era TAKP is emulating, and the oldest client in use for any emulated server. Please familiarize yourself with the differences on this page http://wiki.takp.info/index.php?title=Server_Comparison

'''On Mac OSX (Catalina not supported, need one download):'''
* [https://www.dropbox.com/s/w007o7eecv23n2q/EverQuest.app.zip?dl=0 The Macintosh client is available here]
* [https://www.dropbox.com/s/31so572kljebgk9/EverQuest.app.zip?dl=0 Beta Macintosh client with music fixes is available here]

For OSX users, the game is launched with a [[#Launching_the_Game_in_OS_X|launcher]].  Once you have the client, it must be moved into the Applications folder in order for the [[#Launching_the_Game_in_OS_X|launcher]] to recognize it.

'''If you have any issues, check the [[#Known_Issues_and_Troubleshooting|Known Issues and Troubleshooting]] section.'''

== Launching the Game in OS X ==

TAKP cannot be launched by simply running EverQuest.app. You will need to choose from a variety of scripts or applications the community has created with the intent to simplify not only running the game, but also running multiple instances of it (boxing up to 3):

* [https://www.takproject.net/forums/index.php?resources/cross-platform-launcher.10/ Cross Platform Launcher By Speedz]
* [http://www.takproject.net/forums/index.php?threads/getting-takproject-up-running-for-osx.153/ EverQuestLaunch by Speedz]
* <s>[http://www.takproject.net/forums/index.php?resources/osx-takp-launcher.4/ Official TAKP Launcher by Speedz]</s> '''''dead link'''''
* <s>[http://www.takproject.net/forums/index.php?threads/launcherfrien-v1-06-a-launcher-for-the-osx-client.2297/ Launcherfrien by Zamiel]</s> '''''dead link'''''


Each launcher has its own pros, cons, and instructions. Please review all options and choose the one that looks best for you. Once you’ve chosen a launcher you’ll be able to login and join us!

== Optional Steps ==

The supported client comes with several additional custom UIs.  To switch to one of these, run the slash command '''/loadskin ''<ui>'' 1'''.  The 1 is optional-- it will keep your current window positions.  Loading UIs via the options window will not work.

* [https://drive.google.com/open?id=0B5FZHGN6aazfZUotcUJDQ2h4TGs Loading screens available here]
To use another loading screen, grab the file above and extract it to your desktop. You'll see folders for classic + the 4 expansions. Choose the loading screen you want to use, and copy the bmpwad8.s3d file there to your client's directory, overwriting the existing file. The .bmp files in each directory are only for reference and are not needed by the client. This works for both the PC client and OSX. The location of your client files under OSX is normally /Applications/EverQuest.app/Contents/Resources

=== EQClient.ini settings ===

The eqclient.ini file contains a list of settings that can be changed to suit your preferences, many of which cannot be changed in-game through the options window.

In OS X, the eqclient.ini file is located in your user's ~/Library/Application Support/EverQuest/ directory. The Library directory is hidden by default, and is most easily accessed by having Finder active, hold '''OPTION''' and click on the 'Go' menu item, then down to Library.

Some commonly changed settings include:

* '''WindowedMode=TRUE/FALSE''' - This line must be typed out at the top but below [Defaults].
* '''NewUI=TRUE/FALSE''' - Our client still has the old pre-Luclin UI for nostalgia mode.
* '''Log=TRUE/FALSE''' - Setting this true will automatically turn your log file on when entering the game.
* '''CombatMusic=TRUE/FALSE''' - Enable or disable melee combat music.
* '''ChannelAutoJoin=alliance''' - The Alliance channel is used as the global chat channel for the server.
* '''TargetGroupBuff=1''' - This will allow you to buff groups with group buff spells from outside the group by targeting a member of the group.
* '''AttackOnAssist=FALSE''' - This will allow you to assist another player without automatically enabling auto attack.
* '''MouseRightHanded=1''' - Switches mouse button orientation.
* '''[VideoMode]:'''
<pre>Width=1920
Height=1080
(match your display settings with the proper height and width prior to launching the game)</pre>
* '''Velious armor textures:'''
<pre>LoadVeliousArmorsWithLuclin=TRUE
LoadArmor17=TRUE
LoadArmor18=TRUE
LoadArmor19=TRUE
LoadArmor20=TRUE
LoadArmor21=TRUE
LoadArmor22=TRUE
LoadArmor23=TRUE</pre>
Velious armor textures are not enabled by default as they can cause an issue with Vah Shir armor not displaying.  Most players would probably prefer them on however.

=== EQClassicHD - higher resolution texture pack ===

A port of the EQClassicHD is available for TAKP [https://drive.google.com/open?id=0ByJldqMGux7CVUh6a2taTWlndmM HERE].

Prior to installation, verify you're using the latest version of the client linked above.

There are two installation methods. Windows users can utilize the install.bat file and point to their TAKP directory.

Alternatively, the .s3d files can be copied into a TAKP directory, overwriting the old files (make a back up of your old files!)

If you notice coloring issues or other oddities, it is advised to DISABLE texture caching within the eqclient.ini file: TextureCache=FALSE. Once the issue is resolved and the texture mod is working properly, you can reenable texture caching.

== Known Issues and Troubleshooting == 

=== Connectivity Issues ===

<strong>'''"Sometimes my character's spell gems stay greyed out and the server stops responding to my client."'''</strong>

This is what is commonly referred to as 'desyncing'.  The precise cause(s) of the problem are unknown (else they would get fixed up) but there are things that can be done to reduce the chance of this occurring.

* Ensure that your internet connection is uncongested.  Try using a wired connection to your router instead of wifi.
* Make sure your firewall isn't blocking client ports.
* Make sure your frame rate is limited if running the Windows client.
* Use one of the clients linked above if you're using a different one.
* Try connecting over a VPN.  Some users claim this helps.

Reports from users experiencing this issue are important in order for developers to identify the cause.  If you experience this issue, please report it on the forum and explain what you were doing at the time it occurred.

<strong>See also this post summarizing connection issues:</strong><br />
[http://www.takproject.net/forums/index.php?threads/connection-issues-read-this.4488/#post-24796 Connection Issues for TAKP]

=== Chat channel drops ===
If your chat channels regularly drop, you can try adding ChatKeepAlive=1 in the defaults section of the eqclient.ini, this will increase frequency the keepalives are sent to every 15 seconds.

If one packet is dropped that is the keepalive from Client to Server, you will time out before it triggers again, if the ChatKeepAlive=1 is not set. So this specific condition can contribute to chat channels dropping.

== Issues running the game ==
If you receive a an error mentioning the resolution such as in the following image:

[[Image:DrawSproket.jpg]]

Switch the video mode to 32 bit in the eqclient.ini by changing VideoModeBitsPerPixel to equal 32

== Other general issues ==

<strong>Pauses or lag when opening bags or opening UI elements.</strong>

* Ensure that your antivirus software has exclusions set for the EQ folder and the UI files underneath it.