WooHoo: Ultimate Mac Hack for The Sims 2

Quick Start

Quick Start Manual

Posted here is information to get you started quickly with several WooHoo features.

Installing WooHoo

1) WooHoo requires OSX 10.3.9 (same as The Sims 2)
2) Move the WooHoo folder to the applications folder

Making a Smart Backup

1) From the main menu select ‘Tool->Smart Backup’.
2) Click the ‘New Smart Backup’ button.
3) Enter a good description of why you are making the backup. Or, leave the default. Click OK.
4) Watch the blinkin’ lights.

Restoring a Smart Backup

1) From the main menu select ‘Tool->Smart Backup’.
2) Select a backup from the table.
3) Click the ‘Restore Backup’ button.
4) Watch the blinkin’ lights.

Deleting a Smart Backup

1) From the main menu select ‘Tool->Smart Backup’.
2) Select a backup from the table.
3) Click the ‘Delete Backup’ button.
4) Watch the blinkin’ lights.

Notes About Smart Backups

The Backup files are put in the ~/Library/WooHoo folder. There is no need to do anything with these files. Doing so may cause one or more Smart Backups to become corrupted and WooHoo will automatically delete any corrupted backups.

If you suspect any problems with these files let me know and I will fix WooHoo.

Using the Browser And Installer Table

The Browser and Installer use a table and two controls to display files and thumbnails. This table functions nearly identical in both windows. So I will explain them here. And you only have to read it once.

1) Use the horizontal slider to make the table rows taller or shorter.
2) The vertical slider is a fine vertical scroller that is handy when the table is very large. It pops back to center when you let go.
3) Click the disclosure triangle to expand a package or folder. Expanding a package will show all the images in the package. Expanding a folder will show all the files in that folder. (Folders only occur in the Browser)
4) Double clicking a table item will open ANY item in the default application. Packages open in WooHoo. Folders will open in the Finder.
5) Double click a file name to rename it. (Only works in the Installer for now)
6) cmd-click to select multiple items or deselect items. cmd-A will select all items. shift-click to select a range of items.

Notes About the Browser And Installer Table

As you Browse WooHoo will automatically create and cache thumbnail images from the package files. Once the thumbs are cached the browser will be very fast.

In preferences you can set the size of thumbnails. If you change the size then the thumbs will be re-cached and the browser will slow down a bit until the thumbs are cached again. This will not affect thumbs that are already loaded into open tables. So, you might or might not have to close the window and open again to see the effect.

Also, In Preferences, you can change the default height of the table rows. This will not affect open tables, only new ones.

Using the Browser

1) From the ‘Browse’ menu select a folder to browse.
2) To browser a different folder select one from the popup button (top right of window).
3) To move browser item(s) select the item or items you want to move then click a folder button at the bottom of the Browser.

A really cool feature of the browser is that it watches all the items you are browsing. So, if you move any of the watched items all Browser windows are automatically updated. This even works if you move or rename an item using the Finder.

Using the Sims2Pack Installer

1) From the main menu select ‘File->Open…’ and select the Sims2Pack you want to install. (Hint: You can also double click it in the browser)
2) The Installer window will list all files in the pack.
3) Click a filter button. The Installer will list all files of that type.
4) Select any or all the listed files that you want to install.
5) Click Install button to install the items in the default or most useful location. Click one of the folder buttons to install the file where ever you want.
6) Un-installing a file is the same as installing it except you must click the Un-install radio button in the upper right. You must do this before closing the installer.
7) To rename a file double click on the file name.
8) Double click a file to open it in the package viewer. (not on the file name)

Notes About Installing Sims2Pack

segment type files (lots, families and persons) are installed in the teleport folder along with it’s import file and will be fully-installed by the game when you enter a neighborhood. For this reason it is highly advisable to make a fresh backup before installing segment files and test the lot to make sure it will not make your game crash by putting it in a neighborhood and entering it. See also Known Bugs and Caveats page.

The installer will not let you install files in useless locations. For instance, segment type files can only be installed in the default location (teleport folder).

Other non-segement files cannot be installed in the Teleport folder because if you do the game will rename them with incomprehensible names and then put it in the Downloads folder. Nothing else. If you really want to do that you can with the Other button.

Using the WooHoo Stuff Folders

The WooHoo Stuff folders are a convenience in the Browser and Installer. You can change the name or location of the WooHoo Stuff folder either from the Preferences control panel or using the Finder. If you move or rename WooHoo Stuff while WooHoo is not running WooHoo will find the WooHoo Stuff folder the next time it starts up. WooHoo watches this folder closely.

You can make any number of sub-folders within the WooHoo Stuff folder.

You can rename or trash folders inside the ‘WooHoo Stuff’ folder but they will be recreated with the original name. This is a handy way to get rid of Junk by trashing the whole Junk folder.

The idea of WooHoo Stuff is to help you manage your stuff. My idea is to download new stuff into the New folder. You can then decide to move stuff from the New folder to any other folder using the browser. Move stuff to the Hold folder if you don’t want to install it right now. Move stuff to the Junk folder if you don’t want it. Move stuff you want but need to temporarily disable to the Disabled folder. If you want to install your stuff move it to the Downloads or SavedSims folder.

Of course you can use the WooHoo Stuff folders any way you want or not at all.

Using the Package Viewer

This is an advanced window. If you are comfortable with it you likely do not need any explanation. This window will also be undergoing a lot of changes as new features are added. I will explain how to export a base texture.

1) From the main menu select ‘File->Open…’ (Hint: You can also double click a package from the Browser or Package Tester).
2) The typeID button should be selected.
3) In the table on the right select TXTR. That will display only TXTR files in the left hand table.
4) In the left hand table single click a TXTR file. This will open the TXTR Viewer.
5) Select File->Export. The base texture will be exported in tiff LZW format. A base texture is the level zero mipmap, the largest mipmap.

Notes on the Package Viewer

tiff is the native image format on Mac OS X so be proud. And LZW compression is very good and is loss-less too. So don’t worry about losing any image quality.

The holes button will show you all the dumb holes in the file format.

The Format button will list any file format errors.

The Makeup button will list any Package Makeup errors.

The Test Embedded Files button will test the package for makeup errors and test each embedded file for format and makeup errors. Embedded files that have faults will be noted in the left hand table.

The package is automatically tested for file format errors when it is opened. This is to prevent WooHoo from crashing due to a corrupt package.

Using the TXTR Viewer

Click View One to view the selected mipmap.

Test One and Test All work with the zoom buttons. And allows you to zoom in and out of one mipmap or the whole set at one time.

If you are a crusty creator you can test the base texture for sparkle.

1) Click Test One.
2) Select the largest texture image.
3) Then zoom out of the image with the Zoom Out (minus) button.

The sparkle test fails if it sparkles too much for your artistic sensibilities and you might considering creating a mipmap set. If the base texture passes the sparkle test then you don’t need to create a mipmap set and conserve video memory.

Testing sparkle for a complete mipmap set is the same except click Test All.

Crusty creators can also test for pixelation.

1) Click Test One.
2) Select the largest texture image.
3) Then zoom into the image with the Zoom IN (plus) button.

The pixelation test will test if your base image is big enough for your artistic sensibilities. As you zoom into an image it will become more pixelated. It’s up to you. Smaller textures use less video memory and the game will run faster. Larger textures look better close up. If you are making a painting of the Mona Lisa you might want it to look good close up. If you are making a garbage can a lot of pixelation might be acceptable. Nobody looks at a garbage can close up.

Using the Package Tester

1) From the main menu select ‘Tool->Package Tester’.
2) From the popup button select the folder you want to test. (Hint: you can select your home folder or The Sims 2 application folder by selecting Other…)
3) Select Deep or Shallow.
4) Click the Test button.
5) Watch the blinkin’ lights
6) While the test is running it will display files that fail.
7) You can double click the file name to open it while the test is still running to see why the package failed.

Notes on the Package Tester

The Package Tester tests for known problems. These tests are undergoing continuous refinement and udgrade. Right now there are close to a hundred tests run on each package and each supported embedded file.

Also note, the tests run by the package tester are the exact same tests run on a package when you open one in the Package Viewer and click the Test Embedded Files button.

The tests are of two types. File Format errors and Package Makeup errors.

A Format error violates the file’s format and will likely cause the game to crash or act strangely. For example, incorrect package identifier or version, package components that overlap each other, overrun the file, counts or offsets that are negative or astronomically large.

Makeup errors are more subtle. They do not violate the file format but are otherwise faulty. For example an empty package, duplicate embedded files, a TXTR (texture file) with no texture or an incomplete set of mipmaps. Makeup errors will ‘probably’ not make the game crash but are likely to make it act abnormally.

I hope you get the idea that package testing is not an exact science. But it should help a lot. If you find a package that fails in the game but is not identified by the Package Tester you can help the project by letting me know about it so I can create a test for that particular kind of failure.

Advertisements

Blog at WordPress.com.

%d bloggers like this: