A fairly primitive MacEasyTutu install guide - v 2.3

2007-10-27 by Gorilym



Miscellaneous notes


I. About this guide:

This document is best considered as a sort of MacEasyTutu appendix to I Rahn Maedin's BG1TuTuFAQ - so if something is not covered here, check to see if it's covered there. At some point I hope to combine the FAQ & this guide into a single unit.


II. BG1Tutu itself:

BG1Tutu is basically a 'total conversion' that allows the original 'Baldur's Gate' to be played with the improvements and features of the 'Baldur's Gate II' engine (BG1Tutu - BG1-To-2). Once installed, you won't be able to start BGII games with the MacEasyTutu installation - so maintaining separate BG II & MacEasyTutu installations is highly recommended. To save HD space, you can make symbolic links to share duplicate data between the two installations - doing so is particularly worthwhile with the 'CD2' through 'CD5' folders, because their content is 100 % static. An example of symbolic link creation: To link the CD2 folder from 'BG2_Base' to 'BG2_Clone', I would first remove the CD2 folder from folder 'BG2_Clone', then launch the Terminal and type "ln -s /Applications/BG2_Base/CD2 /Applications/BG2_Clone/CD2" (without the quotes, of course).


III. EasyTutu itself:

Macready's streamlined EasyTutu distribution is renowned for its stability and overall quality, and the Mac version essentially adheres to it completely. In general, following these steps will result in a stable build which is quite simply superior to conventional D-I-Y Tutu conversions. However, due to local variables being involved, I can't guarantee it will work perfectly for everyone. If you do encounter any problems with MET, please notify me and I'll try to help. At the time of writing MacEasyTutu is a conversion of Macready's 23 Dec 2006 release of EasyTutu_ToB and EasyTutu_SoA - refer to the EasyTutu changelog for the version specifics. The Easy Tutu FAQ may also be of interest - bear in mind though, that some of the information therein only applies to the (original) PC version of EasyTutu.


IV. MacEasyTutu requirements:

MacEasyTutu is currently configured to work with either a TotSC-SoA or a TotSC-ToB setup. In other words, you will need copies of both 'Baldur's Gate', 'Baldur's Gate II' & the expansion pack 'Tales of the Sword Coast' to use it, while ownership of the BG II expansion 'Throne of Bhaal' is not required. At some point a non-TotSC MacEasyTutu may also be possible.


V. Very important note about character creation and ToB MacEasyTutu:

The ToB version of MacEasyTutu is inevitably subject to the behaviour described in the BG1TuTuFAQ. Most importantly this means that a workaround is necessary for all classes and kits to be available for player character selection, as the attempted creation of single-class characters (excepting barbarians, mages, monks, and sorcerers) will result in immediate crashes. The presence of an additional, 'non-Tutu-ed' BG II installation is required to be able to completely circumvent this behaviour, but it's not strictly necessary - the full details are in the "Character Creation Work-around" & "How To Create & Play A Wild Mage Character" sections of the FAQ.


VI. General troubleshooting:


The following troubleshooting notes apply generally to installations of BG II, whether BG1Tutu-ed or not.

- If you get an error message when attempting to save your game to disk, check your BG II folder for the presence of a file named 'temp' - if it's present, delete it and put a new folder with the same name in its place.

- If running BG II on a dual processor system you may experience some oddities when saving games and loading areas. In my experience disabling the second processor for the duration of play effectively eliminates such quirks.

- If running OS 10.4.x Spotlight indexing has been known to interfere with the saving of games to disk. To circumvent this launch System Preferences, navigate to the Spotlight preference pane and exempt your BG II folder from Spotlight indexing (under the Privacy tab).


VII. Mods compatible with MacEasyTutu:

The Tutu Fixpack, all the mods with an EasyTutu prefix, The BG1NPC project, Lure of the Sirines Call, Finch NPC, Indira NPC, Mur'Neth NPC, Herbs Add-in, The Grey Clan Episode 1, Song And Silence, Sword Coast Stratagems, The D0Tweak Pack, The BG2 Tweak Pack, One Pixel Productions, TutuGUI & TutuGUIFont (note: a mod not listed here isn't necessarily incompatible, it might simply be untested).


VIII. Fixpacks: (Baldurdash etc.)

The EasyTutu distribution already includes both BG 1 & BG 2 Baldurdash fixes, so unlike conventional Tutu there is no need to install either. The BG2 Fixpack should not be installed on top of a MacEasyTutu installation at this time. Relevant Fixpack changes are being implemented by Macready into the core EasyTutu distributions.


IX. "Unconventional MacEasyTutu":

Reports indicate that game data from the PC versions of BG1 / TotSC can be combined with the Mac versions of BG II / ToB (should work without ToB as well, but that's untested) to create a fully functional MacEasyTutu. If you're a Mac BGII owner having trouble finding copies of the (now out of print) Mac versions of BG I and TotSC, a "PC -> Mac MET" setup may be your best option. Basically, instead of making a TotSC full install with the Assistant in Step II, you need to manually copy all the data and movie files from the PC game discs into folders named 'bg1data' and 'bg1movies' respectively; apart from that the guide's regular instructions should apply.


X. Support:

Please direct all questions, suggestions and feedback about MacEasyTutu and / or this guide to either The MacEasyTutu Forum, The BG1Tutu Forums, or contact me directly (note the mask).





The basic step-by-step guide to installation



Section A: If you have Throne of Bhaal


  • I: If you haven't already done so, download and expand these indispensable files: OSX-TutuCore_ToB, Tutufix v17 & the Baldur's Gate II ToB v2.1.2 update (General note: the free StuffIt Expander should be able to expand any compressed file mentioned in this guide, however - to avoid potential errors I highly recommend that you use an alternative utility like UnRarX to expand the TutuCore archive).

  • II: Make clean and full installs of Baldur's Gate & Baldur's Gate II - including Tales of the Sword Coast & Throne of Bhaal - and rename the resulting BGII folder to 'EasyTutu' (or whatever you like, but this guide will refer to it as 'EasyTutu'). It is important to note that in order to make a full install of Baldur's Gate & Tales of the Sword Coast you need to either use the BG1Tutu Assistant (but do not use the Assistant for actual conversion - the distributed EasyTutu files have already been converted) or assemble it manually - using the Assistant is much more practical, and is the recommended course of action. Consult I Rahn Maedin's BG1TuTuFAQ for further specifics if necessary.

  • III. Install the v2.1.2 update for Baldur's Gate II ToB that was downloaded and expanded in step 1 (Follow the instructions included with the update).


    Note: Standard BG II data will be overwritten by the installation of MacEasyTutu. If you wish to retain the option to revert your EasyTutu installation to standard BG II, I strongly recommend that you either make backups of all the files that will be overwritten by step 5, or - if you have the excess HD space and / or a DVD burner - to simply make an archive of the entire install before making any changes to it (You might also want to make a similar archive of the BG 1 installation, if only to save time in the future).


  • IV: Rename the 'data' & 'movies' folders (located in 'Tales of the Sword Coast/Game Data') to 'bg1data' and 'bg1movies' respectively and move them into your 'EasyTutu' folder.


    Note: with a full install of TotSC its 'data' folder should contain exactly 152 .BIF files. (in my case the total size of the folder is reported as 2352425630 bytes) The 'movies' folder should contain exactly 7 .BIF files, and 36 files in total. (in my case the total size of the folder is reported as 273108062 bytes) The previous figures are based on the original 5 disc BG1 set with separate 1 disc expansion - the figures for the 6 disc reissued set may differ, though it seems unlikely. If you use the 6 disc reissued set and the figures do differ from those detailed above, I'd be interested in hearing about it.


  • V: Move 'dialog.tlk', 'chitin.key' and the 'override', 'characters' and 'scripts' folders (all located inside the 'OSX-TutuCore_ToB.rar' archive that was downloaded and expanded in step 1) to your 'EasyTutu' folder - approve overwriting of files when asked. Now move 'Spawns.bif' (located inside the 'TutuCore/data' folder) into the 'data' folder located in your 'EasyTutu' folder - do NOT simply move the folder it's located in!

  • VI*: (optional) To play BG1Tutu with the original BG1 music, rename the 'Music' folder (located in your 'EasyTutu' folder) to 'BG2Music', and then move the BG1 'Music' folder (located in 'Tales of the Sword Coast/Game Data') into your 'EasyTutu' folder.


  • VII: Move the contents of the 'OSX-Tutufix_v17' folder (that was downloaded and expanded in step 1) to your 'EasyTutu' folder, and double-click 'install_tutufix.command', selecting 'Patches', then 'Patch the game', then 'Main Menu' (Do not select the option to add kits to NPCs, for this purpose use EasyTutuNPCKits (Step 8) instead). Now select either 'Quit' or 'Continue' to proceed with installation of any Tutu Fixpack components (all of which are optional).

  • VIII*: (optional) Move the contents of 'OSX-EasyTutuDegreenifier' folder to your 'EasyTutu' folder, and double-click 'Setup-EasyTutuDegreenifier.command' to make water blue when 3D Acceleration is enabled (Note: in my experience, when installed this feature will take up ca. 1.3 GB extra HD space, and with older hardware the installation process could take a considerable amount of time. If you don't use 3D Acceleration there's no reason to install this).

  • IX*: (optional) Move the contents of the 'OSX-EasyTutuNPCKits' folder to your 'EasyTutu' folder, and double-click 'Setup-EasyTutuNPCKits.command' to select BGII kits for NPCs.

  • X*: (optional) Move the contents of the 'OSX-EasyTutuSpawnRandomizer' folder to your 'EasyTutu' folder, and double-click 'Setup-EasyTutuSpawnRandomizer.command' to randomize the behaviour of spawn points.

  • XI*: (optional) Move the contents of the 'OSX-EasyTutuHotfixes' folder to your 'EasyTutu' folder, and double-click 'Setup-EasyTutuHotfixes.command' to install the latest EasyTutu bugfixes (Note: At the time of writing all hotfixes have been integrated into the core packages. Any future hotfix releases will be announced in this thread).

  • XII*: (optional) Install any other WeiDU mods. This list has the most up-to-date info on recommended mod install order and compatibility (I highly recommend The BG1NPC project and Sword Coast Stratagems - but before installing any mod, please examine its included documentation).

  • XIII: You're done, go play!

  • *: The optional steps 8 through 12 all require the applicable files to be downloaded and expanded. For more info on the 'official' EasyTutu add-ons detailed in steps 7-10 please visit the main EasyTutu site.




    Section B: If you don't have Throne of Bhaal


  • I: If you haven't already done so, download and expand these indispensable files: OSX-TutuCore_SoA, Tutufix v17 & the Baldur's Gate II v1.1.2 update (General note: the free StuffIt Expander should be able to expand any compressed file mentioned in this guide, however - to avoid potential errors I highly recommend that you use an alternative utility like UnRarX to expand the TutuCore archive).

  • II: Make clean and full installs of Baldur's Gate & Baldur's Gate II - including Tales of the Sword Coast - and rename the resulting BGII folder to 'EasyTutu' (or whatever you like, but this guide will refer to it as 'EasyTutu'). It is important to note that in order to make a full install of Baldur's Gate & Tales of the Sword Coast you need to either use the BG1Tutu Assistant (but do not use the Assistant for actual conversion - the distributed EasyTutu files have already been converted) or assemble it manually - using the Assistant is much more practical, and is the recommended course of action. Consult I Rahn Maedin's BG1TuTuFAQ for further specifics if necessary.

  • III: Install the v1.1.2 update for Baldur's Gate II that was downloaded and expanded in step 1 (Follow the instructions included with the update).


    Note: Standard BG II data will be overwritten by the installation of MacEasyTutu. If you wish to retain the option to revert your EasyTutu installation to standard BG II, I strongly recommend that you either make backups of all the files that will be overwritten by step 5, or - if you have the excess HD space and / or a DVD burner - to simply make an archive of the entire install before making any changes to it (You might also want to make a similar archive of the BG 1 installation, if only to save time in the future).


  • IV: Rename the 'data' & 'movies' folders (located in 'Tales of the Sword Coast/Game Data') to 'bg1data' and 'bg1movies' respectively and move them into your 'EasyTutu' folder.


    Note: with a full install of TotSC its 'data' folder should contain exactly 152 .BIF files. (in my case the total size of the folder is reported as 2352425630 bytes) The 'movies' folder should contain exactly 7 .BIF files, and 36 files in total. (in my case the total size of the folder is reported as 273108062 bytes) The previous figures are based on the original 5 disc BG1 set with separate 1 disc expansion - the figures for the 6 disc reissued set may differ, though it seems unlikely. If you use the 6 disc reissued set and the figures do differ from those detailed above, I'd be interested in hearing about it.


  • V: Move 'dialog.tlk', 'chitin.key' and the 'override', 'characters' and 'scripts' folders (all located inside the 'OSX-TutuCore_SoA.rar' archive that was downloaded and expanded in step 1) to your 'EasyTutu' folder - approve overwriting of files when asked. Now move 'Spawns.bif' (located inside the 'TutuCore/data' folder) into the 'data' folder located in your 'EasyTutu' folder - do NOT simply move the folder it's located in!

  • VI*: (optional) To play BG1Tutu with the original BG1 music, rename the 'Music' folder (located in your 'EasyTutu' folder) to 'BG2Music', and then move the BG1 'Music' folder (located in 'Tales of the Sword Coast/Game Data') into your 'EasyTutu' folder.


  • VII: Move the contents of the 'OSX-Tutufix_v17' folder (that was downloaded and expanded in step 1) to your 'EasyTutu' folder, and double-click 'install_tutufix.command', selecting 'Patches', then 'Patch the game', then 'Main Menu' (Do not select the option to add kits to NPCs, for this purpose use EasyTutuNPCKits (Step 8) instead). Now select either 'Quit' or 'Continue' to proceed with installation of any Tutu Fixpack components (all of which are optional).

  • VIII*: (optional) Move the contents of 'OSX-EasyTutuDegreenifier' folder to your 'EasyTutu' folder, and double-click 'Setup-EasyTutuDegreenifier.command' to make water blue when 3D Acceleration is enabled (Note: in my experience, when installed this feature will take up ca. 1.3 GB extra HD space, and with older hardware the installation process could take a considerable amount of time. If you don't use 3D Acceleration there's no reason to install this).

  • IX*: (optional) Move the contents of the 'OSX-EasyTutuNPCKits' folder to your 'EasyTutu' folder, and double-click 'Setup-EasyTutuNPCKits.command' to select BGII kits for NPCs.

  • X*: (optional) Move the contents of the 'OSX-EasyTutuSpawnRandomizer' folder to your 'EasyTutu' folder, and double-click 'Setup-EasyTutuSpawnRandomizer.command' to randomize the behaviour of spawn points.

  • XI*: (optional) Move the contents of the 'OSX-EasyTutuHotfixes' folder to your 'EasyTutu' folder, and double-click 'Setup-EasyTutuHotfixes.command' to install the latest EasyTutu bugfixes (Note: All hotfixes may have been integrated into the core packages at the time you are reading this. Hotfix releases are announced by Macready in this thread).

  • XII*: (optional) Install any other WeiDU mods. This list has the most up-to-date info on recommended mod install order and compatibility (I highly recommend The BG1NPC project and Sword Coast Stratagems - but before installing any mod, please examine its included documentation).

  • XIII: You're done, go play!

  • *: The optional steps 8 through 12 all require the applicable files to be downloaded and expanded. For more info on the 'official' EasyTutu add-ons detailed in steps 8-11 please visit the main EasyTutu site.




    Version History


    v 2.3 (2007-10-27)

    Maintenance. Many links updated, relatively minor

    changes to guide content. Guide now hosted at Macready's site.


    v 2.2 (2006-12-28)

    Updates related to Macready's new EasyTutu core release (23 Dec '06).

    Minor rewriting, typos fixed, changes to links, formatting etc.


    v 2.1 (2006-10-30)

    BG1 music instructions added. Various clarifications, typos fixed.

    Changes to formatting.


    v 2.0 (2006-10-15)

    Major revision to cover non-ToB MacEasyTutu.


    v 1.1 (2006-10-10)

    Minor changes to layout and content. Some notes expanded,

    added troubleshooting advice, and added a couple of mod recommendations.


    v 1.0 (2006-10-05)

    Initial release.



    Credits


  • BG1Tutu by japheth
  • The BG1TutuAssistant by DevArrah
  • The BG1TuTuFAQ by I Rahn Maedin
  • EasyTutu by Macready
  • EasyTutu OS X conversion by Gorilym
  • The Level 1 Fix by Loriel
  • The Tutu Fixpack by SimDing0, Ghreyfain, CamDawg and Andyr


  • Obligatory disclaimer


    Caveat lector - I accept no responsibility and cannot be held liable for any physical, mental, emotional or spiritual damage incurred using MacEasyTutu or this guide.