Difference between revisions of "Getting Started on Mac (Intel based)"

From The Al`Kabor Project Wiki
Jump to navigation Jump to search
(→‎EQClient.ini settings: removed pc client ini settings)
 
(13 intermediate revisions by the same user not shown)
Line 3: Line 3:
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
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):'''
'''On Mac OSX v10.14.x or prior ([https://www.takproject.net/forums/index.php?threads/mac-users-do-not-upgrade-beyond-macos-10-14-mojave.14464/ Catalina v10.15.x or newer 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/w007o7eecv23n2q/EverQuest.app.zip?dl=0 The original 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]
* [https://www.dropbox.com/s/31so572kljebgk9/EverQuest.app.zip?dl=0 Macintosh client with added 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.
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.
Line 29: Line 29:
* [https://drive.google.com/open?id=0B5FZHGN6aazfZUotcUJDQ2h4TGs Loading screens available here]
* [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
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
=== Log monitoring and alerting ===
On PC, people are probably used to software like Gina, however a Mac version doesn't exist.  There are some scripts available to monitor logs and alert on certain events when found however:  [https://www.takproject.net/forums/index.php?threads/charm-break-notifications-for-mac-example.23098/#post-113500 Charm Break Notifications for Mac - Example thread]


=== EQClient.ini settings ===
=== EQClient.ini settings ===
Line 60: Line 63:
LoadArmor23=TRUE</pre>
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.
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 ==  
== Known Issues and Troubleshooting ==  
Line 88: Line 79:


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.
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>SISATEXT connect failed error</strong>'''
This can be caused by a corrupted ini or eqhost.txt file. 
*Right click the EverQuest.app and select 'show contents'.
*Find eqclient.ini and all character ini files.
*Copy those to a different folder and delete the ones in the EQ folder.
*Restart the game. It should launch.
*Then shut it down again.
*Then one by one starting with the eqclient.ini copy them back and restart the client.
*Which ever ones you copy one at a time and relaunch and it fails, that is your bugged file and it has to be remade.
The cause is unknown but what happens is the client writes the file and fails to write it in the proper utf8 text format.
'''NOTE''':  To stop the eqclient.ini from being corrupt, get things set the way you want it and right click the ini file and set to read only.


<strong>See also this post summarizing connection issues:</strong><br />
<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]
[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 ==
== Issues running the game ==
If you receive a an error mentioning the resolution such as in the following image:
'''If you receive a an error mentioning the resolution such as in the following image:'''


[[Image:DrawSproket.jpg]]
[[Image:DrawSproket.jpg]]


Switch the video mode to 32 bit in the eqclient.ini by changing VideoModeBitsPerPixel to equal 32
Switch the video mode to 32 bit in the eqclient.ini by changing VideoModeBitsPerPixel to equal 32
'''If you find you are crashing when you try to log in, verify that you didn't bind one of the keys [ or ] in your previous session or directly in the .ini files.  You will have to remove these from your ~/Library/Application Support/EverQuest/eqclient.ini file.'''


== Other general issues ==
== Other general issues ==

Latest revision as of 11:34, 22 October 2022

Obtaining the Client[edit]

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 v10.14.x or prior (Catalina v10.15.x or newer not supported, need one download):

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

If you have any issues, check the Known Issues and Troubleshooting section.

Launching the Game in OS X[edit]

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):


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[edit]

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.

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

Log monitoring and alerting[edit]

On PC, people are probably used to software like Gina, however a Mac version doesn't exist. There are some scripts available to monitor logs and alert on certain events when found however: Charm Break Notifications for Mac - Example thread

EQClient.ini settings[edit]

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]:
Width=1920
Height=1080
(match your display settings with the proper height and width prior to launching the game)
  • Velious armor textures:
LoadVeliousArmorsWithLuclin=TRUE
LoadArmor17=TRUE
LoadArmor18=TRUE
LoadArmor19=TRUE
LoadArmor20=TRUE
LoadArmor21=TRUE
LoadArmor22=TRUE
LoadArmor23=TRUE

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.

Known Issues and Troubleshooting[edit]

Connectivity Issues[edit]

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

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.

SISATEXT connect failed error

This can be caused by a corrupted ini or eqhost.txt file.

  • Right click the EverQuest.app and select 'show contents'.
  • Find eqclient.ini and all character ini files.
  • Copy those to a different folder and delete the ones in the EQ folder.
  • Restart the game. It should launch.
  • Then shut it down again.
  • Then one by one starting with the eqclient.ini copy them back and restart the client.
  • Which ever ones you copy one at a time and relaunch and it fails, that is your bugged file and it has to be remade.

The cause is unknown but what happens is the client writes the file and fails to write it in the proper utf8 text format.

NOTE: To stop the eqclient.ini from being corrupt, get things set the way you want it and right click the ini file and set to read only.


See also this post summarizing connection issues:
Connection Issues for TAKP

Issues running the game[edit]

If you receive a an error mentioning the resolution such as in the following image:

DrawSproket.jpg

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


If you find you are crashing when you try to log in, verify that you didn't bind one of the keys [ or ] in your previous session or directly in the .ini files. You will have to remove these from your ~/Library/Application Support/EverQuest/eqclient.ini file.

Other general issues[edit]

Pauses or lag when opening bags or opening UI elements.

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