Mac Client Instructions for moving the Splash Screens

From Lotro-Wiki.com
Revision as of 12:18, 27 February 2015 by Magill (talk | contribs) (Magill moved page Mac Client: Instructions for moving the Splash Screens to Mac Client Instructions for moving the Splash Screens without leaving a redirect: naming)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
[BentoIce:
I also see the old loading screens on my mac, but we have an old PC with lotro on it that I was using to move characters so I could play them on the mac, and on THAT system, the loading screens are the new ones (Gondor Aflame, etc). Some of these issues, with the differences between systems, are very strange. I bet Turbine are continually scratching their heads.
The Gory details and how to get the correct screens to display (but you can't prevent the download of all 30 screens).
Depending upon HOW you downloaded the Mac Client, the file locations are different.
This first set of instructions are for someone who downloaded the LOTRO client from Steam.
When you finish with this, you will know how an Apple Developer "sees" any given application program.

Moving the Transition screens (Splash Screens) for the Steam download

  1. Open a finder window - use the "Go menu" and press the "Alt" key. You will see an entry for "Library" appear -- select that entry.
  2. Select "Application Support"
  3. Select "Steam"
  4. Select "SteamApps"
  5. Select "common"
  6. Select "Lord of the Rings Online"
  7. Select "The Lord of the Rings Online™.app" - the .app may or may not appear depending upon your "Finder Preference" settings: Advanced - check "Show all filename extensions."
    Note that at this time all you get is an "info" window to the right of the app name.
  8. Right click on "The Lord of the Rings Online™.app" and select "Show Package Contents"
    The Finder window will jump to the left and you will see a folder labeled "Contents" and a file called "installscript_osx.vdf"
    The bottom of the screen will show the continued path you are navigating
  9. Continue to navigate "downward" by clicking on "Contents"
  10. Select "Resources"
    Here you will find those files which relate to the Launcher itself.
    Two folders are of particular interest -- your language file "de/en/fr" - each of these folders contain the exact same thing, translated into the appropriate languages. (The "ru" - Russian - folder is different.)
    The second folder of interest is "raw" - This folder DOES NOT belong here. It is created when the splash screens are dowloaded by the Launcher. Again, "raw" contains 3 language folders, which in-turn contain another folder called "logo."
    Within this "logo" folder are the splash screens which have been downloaded by the Launcher.
    THEY ARE IN THE WRONG PLACE AND NEED TO BE MOVED!
    Now the Fun Part...
  11. Do NOT close this finder window.
  12. use the "File" Pulldown at the top of the screen and select "New Finder Window"
  13. perform steps 1-10 all over again with this new window -- but keep going.
  14. Now within "Resources" you will see the file "The Lord of the Rings Online™.app" AGAIN! -- This is the actual Game Client
  15. Again right click on the client
  16. Select "Contents/Resources"
    Lo and behold, here are the game data files! and another "raw" directory.
    This time, the contents of the "raw" directory are different. They include more than just the "logo" directory.
  17. Select "logo" and you will note the same file names as in the earlier directory plus one additional file - turbine_logo.bik. That is the WB logo which morphs into the Turbine Logo when you launch the game.

Now position this second Finder window to the right of the first window so that this last column is at the right edge of your screen. Return to the first finder window and position it so that the contents of that window are on top of the second window, but to the LEFT of the second Finder window. You should now have TWO columns of the contents of the "logo" folder side by side. In the first finder window, highlight everything - position the cursor in the pane, and press cmd-A Drag and drop that entire stack of files into the second finder window. You will get a pop-up "An item named "lotro_ad_pregame.jpg" already exists in this location. Do you want to replace it with the on you're moving? Check the box "Apply to all" and click "Replace."

Now the new splash screens are located where the Game-Client can find them and display them.


The procedure is identical for a Happy Cloud download. Or for a game client stored on an external disk. Only the path names will change.



File locations:

All support files are being stored in:

~/Library/Application Support/com.turbine.lotroclient/

Or when using the Wine wrapper used by Steam:

~/Library/Application Support/com.standingstonegames.lotro/common/wineprefix/drive_c/<username>/My Documents/The Lord of the Rings Online
  • 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.standingstonegames.lotroclient.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?

Steam

  • 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.

Happy Cloud Installation: File Locations

NOTE: There is no longer a Happy Cloud installer available for LOTRO.


SSG

  • /Users/<username>/Library/Logs/DiagnosticReports/ -- Standard Apple location for dump files
  • /Users/<username>/Library/Logs/LotroLauncher.log -- LOTRO Launcher log file (Typically contains no useful information)
  • For the SSG 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.


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

  • As of Yosemite (OSX 10.10) and El Capitan (OSX 10.11) there is a new method for exposing the user's Library directory.
How to Always Show the User Library Folder in OS X El Capitan & Yosemite the Easy Way - OSX Daily.
https://osxdaily.com/2014/12/16/show-user-library-folder-os-x-yosemite/


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

15.3

As of 15.3 - 30 March 2015:

  • The OSX Launcher will no longer download all the splash screens every time you start it. It does make an HTTP request for each splash screen to see if you have the most recent one on disk each time.
20 December 2014 - NOTE: These instructions no longer work. Turbine has changed the way the screens are downloaded and as yet a way to prevent the 30 screen download has not been found.
  • 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