Mac Client

From Lotro-Wiki.com
Jump to: navigation, search

Mac Client System Requirements

  • Turbine has not made any official statements as to hardware system requirements however, from the Beta:
  • The only KNOWN restriction is: the client will only run under Lion (OSX 10.7), Mountain Lion (OSX 10.8), or Mavericks (10.9) It will not run under Snow Leopard (10.6).
Performance under Lion (OSX 10.7) and Mountain Lion (OSX 10.8) is "acceptable," but not stellar.
Note that this restriction in itself will limit the hardware on which the Client can Run, as Lion and Mountain Lion are restricted to certain Intel based Macs.
See Apple: OSX Mountain Lion - how to updgrade for hardware information (Nominally a mid-2007 or later iMac).
(Personally, I would recommend a minimum of 4GB of system memory. Any Mac capable of running Mountain Lion has more than adequate Graphics capabilities.)
At this point in time, the Retina Displays are NOT supported at full resolutions... there is no matching Text Font. So, while the Graphics are gorgeous at full Retina resolution, you cannot read any Text!)
Minimum Recommended*
Processor: Processor: 2.0 GHz Intel Core i5 Processor: 2.0 GHz Intel Core i7
Video: Intel HD Graphics 3000 or better NVIDIA® GeForce® GT 650M or better
OS: OSX 10.7.5 OSX 10.7.5
Memory: 2 GB 4 GB
Disk Space: 25 GB available 25 GB available
Internet: 56kbps Modem Broadband DSL/Cable
Sound: Integrated Sound Integrated Sound
Minimum Recommended*
OS: Windows XP Windows Vista 64-bit
CPU: Intel Pentium 4 3.0GHz or AMD Equivalent Dual Core 2.66 GHZ
System Memory: 1GB (2GB for Windows Vista) 2GB
Graphics Card: at least 128MB Onboard graphics memory 512MB dedicated discrete card
Internet Connection: Cable or DSL Connection Cable or DSL Connection
Direct X Version: Directx 9.0c
Disk Space: 12 GB (+3 GB for international clients) 20 GB (+3 GB for international Clients)

Notes from Turbine Technical support team on their new hardware specs:

  • Please keep in mind that these are requirements we (Turbine) feel should allow you to run the game reliably at low to moderate settings.
If you wish to experience the game at the highest settings, additional system memory and higher end graphics cards should be considered.

About Graphics cards

  • The recommendations in the post above mention memory suggestions for discrete graphics cards, but please be aware that we suggest you have a video card that at least falls into the Nvidia 7000 series or the ATI equivalent range. Card falling under those performance levels may not offer sufficient performace, despite meeting the stated onboard memory requirements.
  • Intel integrated chipsets are good basic graphics solutions, but not ideal for gaming. If you’re using an older Intel integrated video solution you may experience poor performance and low frame rates on even modest settings. If you are using a newer Intel chipset, and the game reports that you can use DirectX 10 or 11 modes, we recommend not enabling these. Doing so may cause some graphical elements to display oddly or not display at all.

Use a 64 bit OS

  • Although LOTRO is a 32bit application we strongly encourage players to use a 64 bit OS like Windows Vista or Windows 7 (Please note that Windows 8 and 8.1 are not officially supported). 32bit operating systems may encounter memory limitations when the game client is running and stability issues may result. This is especially true for those using the High definition installation which uses significantly larger amounts of graphics and system memory due to larger textures. Those who choose not to or cannot upgrade to a 64bit OS are encouraged to use the standard resolution client install to reduce memory usage and avoid the memory limits for applications on 32bit versions of Windows. (If you have already installed the High Resolution version, lowering “Texture Detail” in Options > ADV Graphics to medium or lower can also aid in avoiding this memory limitation and improving game stability and performance on 32bit systems.)

Direct X vs OpenGL

  • Note that the Mac Client has native OpenGL support.
OpenGL is the native Graphics language of OSX.
The Mac Client does NOT recognize DirectX -- 9, 10 or 11.
  • The side effect of this is that many Options settings in Graphics and Advanced Graphics have no effect (i.e. they do not work).
In particular, the "Detect Optimal Settings" button is normally "grayed out."

Download information

Update 13 - 14 April 2014

The new Mac download on "lotro.com" is now up and running.

The U13 release notes state:

Akamai Netsession
With today’s release of Update 13: The Breaking of Isengard, we have introduced a replacement for our Pando-enabled client and downloader. We now use a non-peer-to-peer version of the Akamai NetSession client for the LOTRO launcher, and wanted to update you on how we plan to utilize this service in the future.
The Akamai NetSession client allows us to quickly and reliably deliver fresh LOTRO client installations to you, and assist in the repair of missing or corrupted files in current game installations. The client utilizes Akamai’s large network of edge servers to deliver this content to you from a location which is deemed geographically closest to you, and ensures that we are able to efficiently and effectively get you what you need to play LOTRO.
Although some versions of the Akamai NetSession client used by other software providers utilize Peer-to-Peer technology, we have decided not to use P2P for LOTRO. What this means is that Akamai NetSession will NOT use peer-to-peer when delivering LOTRO-related content.
Once you install the LOTRO client, or patch your game to Update 13, it will be possible to uninstall Akamai NetSession from your computer, and NetSession will not reinstall unless it is necessary to deliver a deleted file or a fresh installation. Typical game updates will not require the use of Akamai NetSession.
In reality, the Mac Client download uses the Happy Cloud system, which grabs its data from Akamai. See:
and
for more information


LOTRO Mac Client is also available as a download via STEAM

  • This download has not been updated. Consequently after the Steam Download, an extended Patch (Update) session is needed to bring the client current.
This "patch" frequently takes longer than the original download, as it includes both Expansions (Update 8 - Riders of Rohan; and Update 12 - Helm's Deep) as well as the various updates along the way.
  • The Steam download of LOTRO of the Mac Client for LOTRO requires roughly 20GB of disk space. Download time is approximately 2.5 - 3 hours depending upon your communications speeds.
NOTE: The Mac Client downloaded via Steam is identical to the Mac Client downloaded from lotro.com. Steam is simply a download mechanism.


Support for the Mac Client

  • Turbine support links
Turbine Support | Knowledgebase | How to Get Help on the Tech Forums | Common Tech Issues | New Player Help

Note:

Disclaimer
This site, "Lotro-Wiki.com," is for players by players, dedicated to LOTRO!

This site is neither endorsed by, nor associated with, Turbine.
Content at this page is copied from Turbine, "as-is," with minor wiki adaptions.
See also our general disclaimer.

  • The LOTRO Customer Support forums are for Player-to-Player help!
  • For official support, please submit a ticket to the appropriate team via the form here.
  • After contacting support, log into your email webpage to add noreply@turbine.com and accountsupport@turbine.com to their "safe senders" list and your contacts list/address book.
  • Be sure to check Spam/Junk Mail folders as well since most email providers do not let external email programs or cell phones download mail flagged this way.

Player created Support and Information


Turbine Customer Support: Accounts

  • For problems not specifically related to the Mac Client, but relating to the Account (myaccount.turbine.com), Financial, etc.:
(From CarpeNocturm - Turbine Customer Support - signature)
LOTRO SUPPORT Page & Knowledge Base
  • To request a Paid Service or support from a specific team, click the "Support Center" tab, then "Submit a Ticket"
  • English Account/Store Support is available from 10:00 am to 7:00 pm, 7 days a week. (GMT -5). 855-WBGAMES (855-924-2637)
Support Portal - Deutsch
Portail de support - Français


Important Notes about OSX

  1. The Tilde character, "~" is shorthand for "<your home directory>". (This is classic UNIX(tm), OSX Terminology.)
  2. Beginning with OSX Lion (10.7), and continuing under Mountain Lion (10.8) and Mavericks (10.9) the Library directory (folder) is no longer normally visible in the finder.
    You can change this Finder behavior with a terminal command or simply use the Finder "pull-down" menu "GO" and select "Go To Folder" (Keyboard shortcut = Cmd-Shift-G).
    This will open a window which defaults to "~/Library" and open a finder window to that location. You can then simply continue to navigate from there as you normally would.
  3. There are two "library" directories: "/Library" and "~/Library".
    "/Library" is the root or System Library. You will "GO" here if you forget the Tilde!
    "~/Library" is your userid's personal library and where all of the LOTRO Mac Client information is stored.
  4. Case-Sensitivity - HFS+ (the Mac filesystem) is usually configured to be Case-Insensitive but Case-Preserving. This means that "hello.txt," "Hello.TXT", and "HELLO.txt" all refer to the same file. This is the same behavior found in the normal FAT32 File system in Windows. Since Tiger, it has been possible to create a Case-Sensitive File system for OSX. Most users will never do this, hence this note is somewhat superfluous, however it is more likely under OSX, and because of it's Unix(tm) background. All Unix(tm) file systems are Case-Sensitive.
  5. Filename extensions, ".app" for example -- By default these are turned off. In the Finder under Preferences, Advanced, you can display them by checking the box "Show all filename extensions."

The Mac Client and Gatekeeper

Note that Gatekeeper is a security feature introduced by Apple in OSX Lion (10.7).
Gatekeeper is documented by Apple at: http://support.apple.com/kb/HT5290 Learn about Gatekeeper.
Turbine is not recognized by Apple as a "Known Developer." This means that the OSX Download security - Gatekeeper - will not allow the downloaded .dmg file to mount or the Client to launch.

  • In Mountain Lion (OSX 10.8.2), Gatekeeper has a "known bug" in that the error message output when attempting to verify and mount a downloaded .dmg file is NOT the correct error message. It incorrectly indicates a corrupt download file, and the appropriate Gatekeeper dialog is not displayed.
  • Images of Gatekeeper windows are here: Mac Client Gatekeeper Information
  • To work around this (until Turbine becomes a Registered Developer with Apple and/or Apple fixes Gatekeeper):
  1. Under the Apple menu, select System Preferences
  2. Under "Personal" (top row) select "Security & Privacy"
  3. Select: the General Tab
    • You will likely need to "Click on the lock to make changes" and supply your Administrator Name and Password to enable the change.
  4. Select: Allow applications downloaded from: "Anywhere"
    • Answer the pop-up box ... NOTE that the "Allow From Anywhere" box is NOT highlighted (meaning, you MUST click on it, not simply hit return) and that it is on the LEFT side of the alert box.
    Now the .dmg file should mount and verify with no problems.
  5. When you launch the Game Client the first time, Gatekeeper will generate a pop-up window asking you, "The Lord of the Rings Online™.app is an application downloaded from the Internet. Are you sure you want to open it?" Simply click Open. (Note that THIS pop-up is the one you should have gotten when you tried to mount and verify the .dmg file.)
  6. Once you have verified the .dmg file and launched the game client the first time, you can reset this to the default setting: Mac App Store and identified developers
  • Note that this only needs to be done once. Gatekeeper will remember that you have authorized this application to run.



The Mac Client Communication Notes

General Communications issues

Many problems seen with both the Mac and PC Clients are truly caused by "Communications issues."
The nature of the Internet and the encrypted UDP (see next section) used by LOTRO and DDO cause untold "non-obvious" problems.
  • The first step to fixing most of these communications issues is to get "new addresses and routes" (ARP and DHCP).
  1. Power OFF your system (Do not just close the lid, shut it down completely and do not leave any programs running.)
  2. Power OFF your router - unplug the power cord if you can't find a switch.
  3. Wait at least one full minute!
  4. Power up your router and wait until it is completely booted (typically between one and two minutes).
  5. Power up your computer.
  6. Launch LOTRO and try again.
This process "forces" your Router to clear its ARP cache and usually, acquire a new address from your ISP; and then your Mac or PC to obtain a new DHCP address from your router.
The few of you who have "Static Addresses" already know what I'm talking about and this article won't try to elaborate as it doesn't know your specifics.

The Mac Client and Firewalls (Port Forwarding)

Note especially: Depending upon your home networking setup you may simply want to disable the Firewall option in OSX -- System Preferences / Security & Privacy / "Firewall tab" and allow your Router to be your firewall. (Configuring two firewall devices can lead to significant confusion. This is especially true when your ISP provides you with a "Router.")
  • LOTRO and DDO both use the same two sets of Firewall ports.
Normally, you don't need port forwarding because the client always sends to the server before the server tries to respond. In most NAT firewalls, this implicitly triggers a port forward from that server to your client.
A "NAT" (Network address Translation) router or firewall device will typically be your home Internet connection offered by your ISP. This is frequently a WI-FI device.
  • Port 80 - TCP
  • Ports 9000-9010UDP - Server Port
  • Ports 2900-2910UDP - Server Port
These ports need to be opened out-bound
Note that the following is rarely necessary:
  • With the Windows Client, when configuring port forwarding explicitly, you need to specify the CLIENT's port. By default, the client lets the operating system choose its port. If you edit your UserPreferences.ini (My Documents\Lord of the Rings Online\UserPreferences.ini), you'll see a section titled [Net]. There's an entry there for "UserSpecifiedPort", which defaults to 0. Set that value to something else (like 9000), and then forward that port to your computer (either by port forwarding or by a trigger).
Two files may also need to be added to your firewall exceptions list. These two files are "launcher.exe" and "lotroclient.exe". Both of the files need to have full permission in the firewall to access the servers.
See: Turbine's Knowledge Base http://support.turbine.com/link/portal/24001/24001/Article/347/Port-forwarding-and-LOTRO
  • For the Mac Client, the preferences file is "~/Library/Preferences/com.turbine.lotroclient.plist", which is a binary file that must be edited with Xcode or TextWrangler. TextEdit CANNOT be used to edit the file. "Net.UserSpecifiedPort" is assumed to be the equivalent variable. (This has not been verified.)
The two file names are: "LotroLauncher.app" and "lotroclient.app"

Encrypted UDP

  • Both DDO and LOTRO connect using encrypted UDP (User Datagram Protocol) packets over ports 9000 to 9010 (for the general data communication) and 2900 to 2910 (for the chat and voice chat connections) and they use "loose" routing methods, usually referred to as "asymmetrical packet routing". What this means is that while the game client sends data outbound (upstream) on port 'x', the response packets coming back from the server inbound (downstream) are using port 'y'.
  • Whenever there is an issue with these ports being accessible, the two-way data method being supported, or the inbound/outbound data being mis-routed then connection issues at these stages can and do occur.

The Mac Client and anti-malware (anti-virus) software

  • It has been determined that if you use any of the various anti-virus software packages which ALSO check for "malware" from websites, the Mac Client will encounter problems in the initial phases of loading resulting in the error: "An Update Error Occurred."
  • If you use the avast! for Mac product, it is known that this will prevent the Mac Client from contacting patch.lotro.com and updating. The end result is the "classic" error: "An Update Error Occurred."
In the System Preferences control panel for avast!, [B]"Web Shield"[/B] is the culprit.
If you have it enabled, the Mac Client will not get started!
  • You can either disable "Web Shield" completely, or select "Advanced" and add "patch.lotro.com" (HTTP) to the list of exclusions.
(For the Bullroarer client also add "moria.patch.lotro.com" (HTTP) )

Communication related Knowledge Base articles

The Turbine Support Knowledge base at support.turbine.com has information related to communications issues in many articles. While much of the information is technical, and generally written from a Windows point of view, an understanding of many different things is necessary to troubleshoot your problems.
NOTE: It is not possible to "check for the latest drivers" or "update your graphics drives" with OSX. No third-party drivers exist. Apple purchases the technology from the Graphics vendors and integrates it directly into OSX and then releases it along with any other OSX Updates.



What happens when you launch the Mac Client?

  • As with the Windows Client, the first thing which the Mac Client will do is to download the English, French and German "teleport screens."
At present, the Mac Client downloads all 30 screens (10 for each language) every time it is launched. This is a "Known Issue."
  • Next the client patches the patcher, launcher, and game engine as necessary. Then if necessary, reboots the Launcher and downloads the "teleport screens" again.
  • At which point the patcher will begin patching in earnest... as with the windows client, depending upon what needs updating since the "app" was built.
    This is a good time to right-click on the ring icon in your dock, select options, "keep in dock" To make it easy to launch the application the next time you want to play.
  • Enter Userid
  • Enter Password
  • Respond to EULA (Must scroll to end of text to make Accept button "live.")
  • Respond to Terms of Service (Must scroll to end of text to make Accept button "live.")
  • Select World
  • Game launches in fullscreen mode
  • Intro Movie plays (you can hit escape to skip to the end of it)

Assorted notes about the Mac Client

  • Note: many of these "notes" are "design" items which (hopefully) will change as the Client becomes more "mature." However, they are currently "issues."
  • If you use the Finder to view the LOTRO Mac Client, you will find the name of the Mac Client to be: "The Lord of the Rings Online™.app" (the .app suffix may or may not be visible depending upon the settings of your Mac's preferences).
However, if you use the Terminal window to view the Mac Client, you will discover the name to be: "LotroLauncher.app".

Allowing multiple users on a single machine

Permissions and protections have changed in OSX over the releases, from a very wide-open environment when it was known as Darwin, to a very restrictive one today. Setting up multiple users on a "non-server" implies that everybody is in their own "pigeon-hole," and not sharing things with other users on the same system.

This is compounded by the fact that the Mac Client Application is NOT quite multi-user. That is to say, It suffers from several "Windows-isms" in file names -- Back-slashes "\" , in path names which cause path names to break and therefore reads and writes to fail. And makes assumptions that only one person will be using the Mac, which impacts how Updates are processed.

  • In ~/Library, the Preferences, Log and Application Support folders are written to regularly.

Each user should have their own. This appears to happen with no problems. ("~/Library" is the User's Library directory, not "/Library" which is the system Library.)

  • However, the application itself (The Lord of the Rings Online™.app) and its contents DO need to be readable, writeable and executable by all users in your "Group."
This is because of the way the launcher updates files each time it is launched -- all of the "transition" screens are downloaded each and every launch and are written into the ".app" file! AND, there is a second executable buried inside the first!

In theory, you should be able to set User and Group to [B]"Read & Write"[/B] and everything should work.

  • You need to use the Terminal (Utilities/Terminal) and enter the command:
chmod -R ug+rwX <path to your installation>/LotroLauncher.app

This will take care of the corresponding issue of Directories not being searchable by Group, and the fact that there is a second executable buried down inside the ".app" structure: lotroclient.

To verify success:

ls -al <path to your installation>/LotroLauncher.app/Contents/Resources/lotroclient.app/Contents/MacOS/lotroclient
Note: If you have installed LOTRO in "Applications," the <path to your installation> will be "/Applications".

You should see something like this (all on one line):

-rwxrwxr--@ 1 user group 56458116 Nov 4 22:16 <path to your installation>/LotroLauncher.app/Contents/Resources/lotroclient.app/Contents/MacOS/lotroclient
rwx = Read, Write, Execute in three groups - User, Group, Others

This verifies that the embedded executable "loroclient" is in fact executable by everyone in your Group.

You should now have all of the permissions necessary to allow any user in Group staff (or whatever your Group name is) to read and update the various "transition" screens and other files.

Internal Error on Logging in (German and French users)

This applies to folks who are not using the American English language selection.

You get all the way to entering your userid and password and selecting a server when you get the error: "Internal Error. Please contact customer support."

This happens on your FIRST login, when you have not yet accepted the EUL and T&C.

  • The solution/work-around is to "Select a Language" -- In the upper right corner of the Client is a little blue box with a downward pointing arrow. When you mouse over it, you get "Select a Language" in German, English and French. Click on that button and select "English."
  • The Client should re-launch, and you will be presented with the EULA and TOC to accept.
  • Once you have accepted the two agreements, you can switch back to your preferred language at any time.

How can I get F1 - F12 to work in game?

If you are using an Apple keyboard:

  • Open System Preferences.
  • Click on Keyboard.
  • Click on the checkbox next to Use all F1, F2, etc, keys as standard function keys.

The Function buttons will now work as you want.

To use the special features instead of F1 etc. then just press the fn key at the same time as the F key as before, except the function is now reversed.

F16 > F19 do not map in LOTRO even with this selected on the Apple extended keyboard.

"Standard" ANSI 101-key and 102-key keyboards (such as Logitech) should "just work."

Assorted Mac Client Messages (including errors)

Images and interpretations of various messages generated by the Mac Client can be found on this page: Mac Client Messages.

Turbine Knowledge Base Articles

Note that many of these articles refer to both LOTRO and DDO, both Turbine games.

Turbine Knowledge Base Articles related to the Mac Client

Note: This article is not accurate for Mountain Lion.
  • Under Mountain Lion, there is no longer a "Save as" option. The document can NOT be saved as an RTF document, only as ".spx".
  • The default location to save the document is in your "Documents" folder. The Desktop option may not be visible.
  • The save can take a while as it includes log files. It may also be a LARGE file as a result.
An alternative is to
  • Select print
  • In the Print window select PDF
  • Select Save as PDF
  • The default location to save the document is in your "Documents" folder. The Desktop option may not be visible.

File locations:

All support files are being stored in:

~/Library/Application Support/com.turbine.lotroclient/
  • lotro.keymap
  • lotroclient.log
  • Chat logs (Capture Chat)
  • Screenshots (F11)
  • Music (folder) -- ABC Music files
  • Plugins (folder) -- Lua Plugins
  • PluginData (folder) -- Lua Plugins Data
  • ui (folder) -- Skins and Layouts

The "UserPreferences.ini" file (as found in the Windows Client) is stored as a plist file:

~/Library/Preferences/com.turbine.loroclient.plist

And the launcher

~/Library/Preferences/com.turbine.lorolauncher.plist

Note that .plist files are "binary" files which need to be read and converted into readable text. Xcode (free from the App Store for Mountain Lion users) does a fine job as do other third party text exiting programs. TextEdit cannot read or convert them. (TextWrangler - Bare Bones Software can convert them into XML form, however the resulting file contains all of the Apple plist boilerplate which tends to make the resulting file less than readable and therefore useful.)

Where are the .dat files?

  • For the Steam installation of the Mac client, they are located here:
Open the Finder to: ~/Library/Application Support/Steam/SteamApps/common/Lord of the Rings Online/The Lord of the Rings Online™.app
  • Right click on "The Lord of the Rings Online™.app"
  • In the pop-up menu select: "Show Package Contents"
  • Select "Contents"
  • Select "Resources"
  • Right click on "The Lord of the Rings Online™.app" (Yes this is the same name. This is the actual game-client.)
  • Select "Contents"
  • Select "Resources"
All of the .dat files will be visible in this folder.
  • For the Turbine installation of the Mac client, they are located here:
Open the Finder to: <path to your installation>/The Lord of the Rings Online™.app
Note: the <path to your installation> will typically be /applications -- /Applications/The Lord of the Rings Online™.app
  • Right click on "The Lord of the Rings Online™.app"
  • In the pop-up menu select: "Show Package Contents"
  • Select "Contents"
  • Select "Resources"
  • Right click on "The Lord of the Rings Online™.app" (Yes this is the same name. This is the actual game-client.)
  • Select "Contents"
  • Select "Resources"
All of the .dat files will be visible in this folder.
  • Note that in both cases here, the file names are as seen from the Finder. If you use the Terminal App, the file names ARE DIFFERENT.
See the example in Video files and transition screens below.

The Turbine LOTRO Game Manual:

A PDF copy of the Turbine LOTRO Game Manual is included in every download (PC or Mac). The current version (Update 9) is still entitled: "Siege of Mirkwood." However, this "Treasure" is "buried" in the download!

As the Mac Client is distributed as a single ".app" file, the file is "Buried Treasure" within this single file.

To access the Game Manual via the Finder,
  • Navigate to where the Mac Client App is stored, typically in /Applications;
  • Locate the The Lord of the Rings Release(tm).app file and right click on it.
  • From the pop-up menu select, "Show Package Contents."
  • Navigate from "Contents" to "Resources," and as with the PC client choose your language: de, en or fr. (Deutsch de, Français fr or English en)

In that directory you will also find copies of the EULA and TOS documents AND the "LOTRO Game Manual.pdf." The EULA and TOS documents are in html format and will display in your browser if double-clicked on. NOTE: the EULA and TOS are in their respective languages, however, the Game Manual in each directory is in English.

TIP: as this is a PDF file, you can view it in either Preview or your Browser, depending on how your system is configured. Either mechanism allows you to navigate to individual pages, and to print single pages if you wish.

TIP: Because of the complexity of accessing this manual, it is recommended that you create an alias and drag that alias to your desktop rather than printing it. (Right click on the .pdf file, and select "Make Alias" from the pop-up menu.) The PDF file is 5.7MB in size and 42 pages in length.

Log files:

Client: ~/Library/Application Suport/com.turbine.lotroclient/lotroclient.log

This file can be clicked on and read via the Console app, however it is usually only a report of events taking place AFTER login credentials have been validated. It is overwritten at each launch.

Launcher (Patcher): ~/Library/Logs/LotroLauncher.log

This file can be clicked on and read via the Console app. It is normally quite short, as it is usually only a report of password failures and its full text can be read in the Finder preview window. (It represents the initial dialog between the Launcher(Patcher) and the GLS data center.)

Launcher (Patcher): ~/Library/Logs/com.turbine.lotroclient/PatchClient.log

This file can be clicked on and read via the Console app. It is appended to at each launch or patch session.

This log is the most useful for diagnosing patching and other issues. It records activity during the patching phase of the client, both when patches actually exist as well as for each launch when LOTRO checks the files (including .dat files). If there is any issue it usually will be indicated in this log.

However, in classic Unix fashion, this file is not normally created for you. You need to create a blank file to "initialize" it. (Note that it is also never truncated an can therefore grow infinitely.)

You can most easily create the file from the Terminal window the "classic" Unix way :

$ touch ~/Library/Logs/com.turbine.lotroclient/PatchClient.log
Yes that is a tilde, shift of the key to the left of 1 on the top row.

You can also create it using Text Exit or any other text editor (such as Text Wrangler or Emacs).

  • Launch Text Edit;
  • Create a New document making sure it is in plain text format;
Textedit > Format menu drop down > Make Plain Text
NOTE: You may only have "Make Rich Text" as option if you have chosen the Preference:"New Document - Format - Use the Format menu to choose settings for an open document. -Plain text."
  • Enter nothing, just Save with the name;
Library/Logs/com.turbine.lotroclient/PatchClient.log
Important Note: if you are running Mountain Lion (10.8.x), your default may be to save the document to iCloud AND you may discover that you do not have Library as a visible folder (directory)! If that is the case, you may NOT be able to save the file in this manner using Text Edit. (Apple re-defined how the "Save/Save as" options in Mountain Lion work, as well as removing Library from the normally visible list of folders.) You will need to either use the Terminal window (/Applications/Utilities/Terminal) and the "touch" command listed above. Or use a different Text Editor which does make your Library folder visible.
To "truncate" this log file, you can simply erase it (Move to Trash), in which case no further logging will take place until you re-create it. Or, again in classic Unix fashion, use the Terminal and the command:
> cat /dev/null > ~/library/logs/com.turbine.lotroclient/PatchClient.log

Lua plugins:

For Lua plugins, I recommend using LPC - LOTRO Plugin Compendium (Mac / Linux) - http://www.lotrointerface.com/downloads/fileinfo.php?id=689 This is a Java program which allows one to easily install and update Lua Plugins. You simply point it at the directory mentioned above and it will create the Plugins Folder and generate a list of available plugins for you to "pick and choose" -- then it will track updates to your installed plugins for you. (You simply launch it, and let it do its check prior to launching the game.)

  • The Plugins folder is not created for you. You need to create the "Plugins" folder, or allow LPC to create it.
  • An important Note about using LPC with the new Native Mac Client:
Because the Native Mac Client is storing the Plugins in a place different from Windows, you need to make certain that you Configure LPC before you use it -- ESPECIALLY, if you have previously used it with a WINE based distribution. LPC will look for, and find, its old settings information, and store the Plugins in the wrong location. It is not known if Turbine will change the location for the Native Mac client to match the Windows location at this time. We have bugged it and asked them to change it... but nobody knows if they will or not.


Music:

Work-aounds for Play bugs: Mac Client - Music work-around

ABC Music files go here for use with /play (/playlist /playstart) commands.

UI Layouts:

This is the default location where the in-game command /ui stores its output. /UI allows you to save and restore (across characters) the placement of UI (User Interface) elements on your screen.

  • The "ui" folder will only be created for you if you use the in-game command /ui. This will also create the folder "layouts" within that folder.

Note that these files are plain text files in XML format. They also contain all of the aliases defined for a character. This provides a mechanism to also make your aliases common across all your characters. The files are visible to all characters on all servers when using a game-client accessed from the Mac. (I.e. they are not restricted by either account or server.)

  • Note also: This command is currently (Update 9) broken in the Mac Client Beta Version, one needs to use the FULL PATH NAME for <filename>.
For example, to save a layout to the same location as all other Mac Client support files use:
/ui layout save "/Users/<userid>/Library/Application Support/com.turbine.lotroclient/ui/layouts/<layoutname>"

If you are doing this frequently, you can assign this command to a shortcut (i.e. create an alias). Replace <userid> and <layoutname> with your values:

/shortcut xx /ui layout load "/Users/<userid>/Library/Application Support/com.turbine.lotroclient/ui/layouts/<layoutname>"
where xx = the desired quickslot number (The version in the shortcut example loads the UI layout)
usage /ui [layout [<save|load> [<filename>]]]
This command can be used to save or load a UI layout.

To save a ui layout use:
: /ui layout save <filename>

To load a ui layout use:
: /ui layout load <filename>

In the file name you can use %r to substitute in the current resolution and %c to substitute in the character's name.

If no filename is specified, a default filename of the form Default_%r is used.

Skins:

Skins change the visual appearance of your User Interface. They go in a folder called "skins" located inside the "ui" folder.

  • The "ui" folder will only be created for you if you use the in-game command /ui (see "Layouts" below).
  • The "skins" folder is not created for you. You need to create the "skins" folder inside the "ui" folder.
  • See: [www.lotrointerface.com www.lotrointerface.com] for available skins

Video files and transition screens

The Video vignette files and the Transition screens are located inside the .app bundle. As most users are not expected to need to access these files, this information is primarily for debugging purposes.

You need to be familiar with the Terminal or adept at the Finder.

1- Navigate to wherever you have LOTRO.app installed (nominally in /applications) and select it.

2- In the Finder toolbar click on the "Gear" to get the pull-down; then select "show package contents" (You can get that same menu as a pop-up by right-clicking on the filename.) A "new" finder window will appear to show the "Contents;" you navigate down from there.

3- In terminal, simply keep CDing your way down:

LotroLauncher.app/
                Contents/
                        Resources/
                           Lotroclient.app/
                                      Contents/
                                           Resources/
                                                    raw/
                                                      en/    (or de or fr)
                                                           vignette_videos

At that point, you can simply select the file you want to trash, right click on it "move to trash" or simply drag it "up a level."

Note that from the Finder, the top-level application name is different from that which is seen in Terminal.

Yes, you do wind up passing through two ".app" files and using the "show package contents" twice.

This is because the Mac Client is actually two nested applications -- the launcher/patcher and the game-client itself.

FWIW, this is actually the same location as in the Windows version -- just with the Mac "bundle" around it. All three languages tress are symmetrical.

How to find LOTRO files on a Mac

Apple in their infinite wisdom decided back about Lion, that the User never needed to visit the Library directory (folder) and hid it from from the Finder. -- However at the same time "The Apple Way" promulgated to Developers advocated that all application program support functions be placed in "~/Library/Application Support" -- which the user can't see! Duh!

Let me describe the two situations as relating to the LOTRO Mac Client.

1- Note also that there are TWO libraries -- /Library (slash Library), the System Library and ~/Library (tilde Library) the User's Library. Needless to say both Libraries have "Application Support" directories.

It is easiest visit them via the Terminal window, but that requires Unix (OSX) command line expertise.

To access them via the Finder, use the "Go" drop-down menu. Pressing the Command (alt) key while that menu is down, will add "Library" to the list. That entry will take you directly to the User's Library.

Alternately, you can use the "Go to Folder" option (Apple-Shift-G). This will generate a pop-up "Go to Folder" which ill be automatically filled in with "~/Library"... the User's Library.

Once there, you are "halfway" there... "Application Support" will contain "com.turbine.lotroclient" -- this is where your screenshots are stored, and where you create the "Plugins" folder for Luas, or "Music" folder for ABC files, etc.

Note that it is also possible to make the Library directory permanently visible again. In terminal, issue the command: chflags nohidden ~/Library

2- Again in their advocating of the "The Apple Way" to developers, primarily so that Applications can be distributed through the "App Store," all Application programs are "bundled."

In "Finder Preferences,' "Advanced," if you have "Show all filename extensions" checked, you will see the extension ".app" at the end of each application in "/Applications." (Note that while there are again TWO -- "/Applications" and "~/Applications." The User's ~/Applications directory is rarely used by third-party developers.)

Once in /Applications, select "The Lord of the Rings Online™.app" and Right-Click, select "Show Package Contents." You are now "inside" the "application bundle" of the "Launcher" for the LOTRO Mac Client.

This top level folder "Contents," contains a number of other folders: "Resources" being the one of interest. Inside the "Resources" folder, you will find ANOTHER "The Lord of the Rings Online™.app" -- this is the actual game client.

Another Right-click and "Show Package Contents" and you will find another set of folder including another "Resources."

Inside this second "Resources" folder you will find all of the Game's data files, and the file : "DownloadFilesList.xml".

Stopping the constant downloading of the Transition Screens

  • The Mac Client constantly downloads the "Transition" screens every time it is launched, if they have been changed or not!

To stop that behavior and dramatically shorten launch time, follow the instructions below.

  • This set of commands is for a STEAM installation. The "standard" installation location is slightly different. (see below)

Note that this is a single line for use in the Terminal window. Each "\ " represents and "escaped" space. There is a single space after "Rings".

ls -als ~/Library/Application\ Support/Steam/SteamApps/common/Lord\ of\ the\ Rings\ Online/LotroLauncher.app/Contents/Resources/lotroclient.app/Contents/Resources/DownloadFilesList.xml

This is a list command: which will return something like:

12 -rw-r--r-- 1 User staff 8703 Feb 22 13:51 /Users/User/Library/Application Support/Steam/ ...

If you get "No such file or directory" you most likely have one of the escaped spaces wrong.

Once you have verified that you have the ls command "spelled correctly" and gotten the list response back, change the command to:

cd ~/Library/Application\ Support/Steam/SteamApps/common/Lord\ of\ the\ Rings\ Online/LotroLauncher.app/Contents/Resources/lotroclient.app/Contents/Resources

This will Change your Directory to "Resources" where a simple "ls -l" command will return something like,

> ls -l
-rw-r--r--  1 User  staff        8703 Feb 22 13:51 DownloadFilesList.xml
-rwx------  1 User  staff           3 Feb 22 12:13 ProjectVersion
drwxr-xr-x  2 User  staff          68 Feb 22 13:55 bindat
-rwx------  1 User  staff   567279616 Mar 11 23:12 client_anim.dat
-rwx------  1 User  staff   331350016 Mar 11 23:12 client_cell_1.dat
-rwx------  1 User  staff   201326592 Mar 11 23:12 client_cell_2.dat
-rwx------  1 User  staff   502267904 Mar 11 23:12 client_gamelogic.dat
-rwx------  1 User  staff   367001600 Mar 11 23:12 client_general.dat
-rwx------  1 User  staff  4287627264 Mar 11 23:12 client_highres.dat
-rwx------  1 User  staff  1329594368 Mar 11 23:12 client_highres_aux_1.datx
-rwx------  1 User  staff   558891008 Mar 11 23:12 client_local_DE.dat
-rwx------  1 User  staff   667942912 Mar 11 23:12 client_local_English.dat
-rwx------  1 User  staff   504365056 Mar 11 23:12 client_local_FR.dat
-rwx------  1 User  staff    23068672 Mar 11 23:12 client_map_1.dat
-rwx------  1 User  staff    23068672 Mar 11 23:12 client_map_2.dat
-rwx------  1 User  staff  1419771904 Mar 11 23:12 client_mesh.dat
-rwx------  1 User  staff  2657091584 Mar 11 23:12 client_sound.dat
-rwx------  1 User  staff  3792699392 Mar 11 23:12 client_surface.dat
drwxr-xr-x  4 User  staff         136 Feb 22 12:52 de.lproj
drwxr-xr-x  4 User  staff         136 Feb 22 12:54 en.lproj
drwxr-xr-x  3 User  staff         102 Feb 22 12:54 en_gb.lproj
drwxr-xr-x  4 User  staff         136 Feb 22 12:23 fr.lproj
drwxr-xr-x  3 User  staff         102 Feb 22 12:23 ja.lproj
drwxr-xr-x  3 User  staff         102 Feb 22 12:23 ko.lproj
-rwx------  1 User  staff     1666634 Feb 22 12:52 lotroclient.icns
drwxr-xr-x  5 User  staff         170 Feb 22 10:30 raw
drwxr-xr-x  4 User  staff         136 Feb 22 13:04 ru.lproj
drwxr-xr-x  4 User  staff         136 Feb 22 13:08 zh_cn.lproj
If you examine the contents of the file: "DownloadFilesList.xml," you will discover that all of the file names are in "Windows" format, with "\" instead of "/" as the path separator. Consequently, the launcher cannot find them, and assumes that they must be downloaded again.

Next backup (Copy) the file: "DownloadFilesList.xml"

cp DownloadFilesList.xml backup.xml

Then run the following SED command:

sed -i .bak -e's/\\/\//g' DownloadFilesList.xml

Yes, this does create a backup file: DownloadFilesList.xml. -- belt and suspenders :)

  • For the standard installation in /Applications, the process is identical, just the initial path is somewhat simpler.

Start off with ~/library again, but leaving out the "Steam Parts" :

ls -als ~/Library/Application\ Support/LotroLauncher.app/Contents/Resources/lotroclient.app/Contents/Resources/DownloadFilesList.xml
cd ~/Library/Application\ Support/LotroLauncher.app/Contents/Resources/lotroclient.app/Contents/Resources/

and continue as above.

Misc Notes

Capturing Screen Shots on the Mac OUTSIDE of the game

This can be used to capture a particular window on your Mac.

  • The resulting file will be placed on your desktop as "Screenshot <date>


  1. Position the cursor over the window you wish to record. (The cursor does not appear in the screenshot.)
  2. Hold down the APPLE [Command] and SHIFT keys
  3. Press 4 to get "Crosshairs" so you can select just the section of the screen you want in your screenshot.
  • You can drag the crosshairs around the object you wish to capture.
  • Note that you only get one try to select an area. As soon you release the mouse, the screenshot is taken.

Alternately:

  • Press the space bar after you press 4 to automatically size the screenshot so that it matches the window the cursor is over.
  • After you press the space bar, the window under the cursor window is highlighted, and a camera icon should appear.
  • Click the mouse to take the screenshot.

You can also easily capture the entire screen:

  1. Hold down the APPLE [Command] and SHIFT keys
  2. Press 3 for a screen shot of the entire screen