TUTORIAL makeup file structure and *Instance Number Lists*, catalog icon replace, default replace, SimPE Resource Finder
Level 3 Intermediate, you should know
SimPE basics
----------------------------------------------------------------------------
This document presents information about three related topics:
1) The
filestructure of Maxis lipstick (other makeup is similar).
2) How to
default replace lipstick (or other stuff)
a) Maxis lipstick
texture (and other makeup or stuff)
b) Maxis lipstick
catalog icons (or other catalog icons)
3) How to use the
SimPE Resource List and Resource Finder tools to find
related resources, parts of the same lipstick (or whatever).
TXTR (makeup image) and IMG (catalog icon image) Instance Number Lists
+
Base Game lipsticks
+
OFB lipsticks
+
Base Game Eyeshadows and Eyeliners
+
OFB eyeshadows
+ Blushes (coming soon...)
+ Other Makeup (coming at some point...)
I learned these things while fixing a Maxis bug that made the sioux lipstick
not appear in the makeup catalog. Get the fix
here. Couldn't have done it without the Resource Finder.
-----------------------------------------------------------------------------
1) Maxis Makeup File Structure
-----------------------------------------------------------------------------
Maxis lipstick data is comprised of the following resources, scattered
across several files:
TXTR
texture, images of the lipstick makeup, mipmapped,
2 largest stored as LIFO references,
look for TXTRs named uuface-lip-COLOR_txtr
file: The Sims2/TSData/Res/Sims3D/Sims07.package
OFB lipsticks and makeup starts with uufaceonlynewmakeup
file: The Sims2 Open For Business/TSData/Res/3D/Sims07.package
(in general, OFB resources will be in OFB files)
LIFO
large image format, 256x256 and 512x512 lipstick images,
get instance numbers from TXTR LIFO references
or do a name map search for the lipstick name (COLOR above)
file: The Sims2/TSData/Res/Sims3D/Sims12.package
TXMT
material, reflectivity, alpha, ususal material properties
Maxis lipsticks seem to have one of two kinds of TXMT's,
see the ones for palepink and ice for examples of each
look for TMXTs named uuface_lip_COLOR_txtm (underscore, not dash),
or look for a specific COLOR like palepink
file: The Sims2/TSData/Res/Sims3D/Sims02.package
STR#
text lists, lipstick names, not seen by user in catalog,
but perhaps used by game to find other resources by name?
Useful for naming your package and searching for other stuff.
Lipstick name list has group 0x7F35994C, instance 0x00000002,
(I found this by searching for palepink, a lipstick color.)
file: The Sims2/TSData/Res/Catalog/Bins/globalcat.bundle.package
XTOL
texture overlay XML, has properties such as age, bin,
category, flags, layer, etc.
Lipstick XTOLs are named uuface_lip_COLOR,
where COLOR is lipstick name, like palepink,
but name map search did NOT turn this up for me.
Group search did, same group as the lipstick STR#, 0x7F35994C
file: The Sims2/TSData/Res/Catalog/Skins/Skins.package
3IDR
3D ID reference file, references to other resources,
The one in globalcat.bundle.package has lots of stuff,
like instance numbers of catalog icons and texture overlays.
Lipstick 3DIDRs have group 0x7F35994C,
Instance of 3DIRD and BINX matches for a specific lipstick.
file: The Sims2/TSData/Res/Catalog/Bins/globalcat.bundle.package
and other files, but we mostly care about globalcat
BINX
binary index, makeup catalog entry information
Lipstick BINXs have group 0x7F35994C,
Instance of 3DIRD and BINX matches for a specific lipstick.
file: The Sims2/TSData/Res/Catalog/Bins/globalcat.bundle.package
sortindex determines where the catalog entry (icon)
of this lipstick appears in the catalog, 0 is the first
Maxis lipstick, pale pink, 0x13 (decimal 19) is the last
lipstick you'll see without my bug fix,
0x14 (decimal 20) is really the last Maxis lipstick, sioux.
stringindex gives you the name of the lipstick.
Its an index into the STR# resource of lipstick names.
lipstick name line number = stringindex - 1
NOTE: The BINX for sioux lipstick was missing,
my
bug fix put it in, so sioux would show in the catalog.
IMG
icon image for makeup catalog (CAS, mirrors)
Found the instance number of the icon by looking
in the 3DIR, see the lines with jpg/tga/png, last # is instance.
To see which lipstick this goes with, find the BINX with the
same instance as the 3DIR (sort Resource List by Instance).
Then check the stringindex, see description of BINX above.
file: The Sims2/TSData/Res/UI/ui.package for basegame makeup icons
file: The Sims2 Open For Business/TSData/Res/UI/ui.package
for OFB makeup icons
-----------------------------------------------------------------------------
2) Default Replacement of Maxis Lipstick and Catalog Icon
-----------------------------------------------------------------------------
There is an easy way, modify someone else's default replace file,
and a harder way, make a default replace file from scratch.
Both techniques will also work for other makeup or stuff with a TXTR resource.
(There is an older default replace thread, but I wanted to give just current
info here, and make some makeup specific.)
EASY DEFAULT REPLACE - modify existing file
Open an existing default replacement file with SimPE.
It will contain texture (TXTR) resource and probably nothing else.
It might have other optional stuff like a material (TXMT)
and/or catalog icon (IMG).
Replace the Lipstick Texture Image
Select the TXTR in the Resource Tree and Resource List.
In the Plugin View, right click the picture, select Build DXT.
Use DXT5, smoothing None, levels 1 (not 10).
Open a 512x512 image. Click Build.
Commit. Save.
Replace the Catalog Icon Image (if its in the package already, otherwise, don't)
Select IMG in the Resource Tree and List.
Right click the IMG resource, select Replace.
Choose the 64x64 icon image you want to use.
Commit. Save.
Modify the Material (if its in the package already, otherwise, don't)
Modify the TXMT values how you want. The meaning of TXMT values
is beyond the scope of this document. There are other documents about TXMT.
Commit. Save.
HARDER DEFAULT REPLACE - make file from scratch
You'll need to replace the same resource(s) as in the easy technique,
usually just the TXTR, unless you want to change the TXMT and IMG too.
You just have to find them first, which is not really tricky if you
know what the makeup looks like or what its name is. (Or just check the instance number lists in posts 2-6.)
Find the TXTR to replace
Open the file TSData/Res/Sims3D/Sims07.package
In the Resource Tree, select Texture Image (TRXTR).
In the Resource List, make sure stuff is sorted by Name (click it if not).
To find lipstick textures, look for resources whose names are
uuface-lip-COLOR_txtr, where COLOR is the lipstick name, like palepink.
Extract the TXTR
Once you found the TXTR you want to replace, you need to extract it.
Do NOT modify Maxis files! Do NOT modify Maxis files! No no no no!
Right click the TXTR you want, select Extract and save it.
You can rename it something intelligible if you want, just keep the extention.
Close the Sims07.package file.
Create new package, add TXTR, replace texture image
Create a new *.package file, name is something intelligible, like
lipstickPalePink_DEFAULT_CatOfEvilGenius_MTS2.package
so people know what it is months after they download it.
In the Resource Tree, right click, select Add.
Now choose the TXTR resource file you extracted earlier.
Now replace the texture image just like in the easy method, see above.
Commit. Save.
Find and Replace Catalog Image and/or Material (optional)
You'll have to find the TXMT and IMG resources that go with your lipstick.
See the TXMT and IMG paragraphs of Section 1 to see how I found them,
and Section 3 for tips on searching with Resource Finder.
Then Extract, Add to your new file, and modify.
Commit. Save.
-----------------------------------------------------------------------------
3) SimPE Resource Finder / Resource List - finding related resources
-----------------------------------------------------------------------------
To find all the parts of something, like a lipstick, you may need to do a lot
of searches and instance number chasing.
* A Maxis lipstick (or whatever) is made of several resources, or parts,
scattered across several different files. See part 1) of this document.
* Instance (low) numbers, Group numbers, file names and strings are the keys to
finding the scattered resource parts of a lipstick (or Maxis thingie).
* In the Resource List, you can sort by Name to see similar items (like all
lipsticks). Lipstick resources are sometimes named uuface_lip...
or uuface-lip...
* In the Resource List, you can sort by Instance. Sometimes, related
resources may be in the same file, and share the same Instance number.
Sort by Instance helps you find such cases.
* Instance and group numbers can be found in the Resource Tab,
at the bottom of SimPE. This is the group/instance of this resource.
You may also find some in the Plugin View, if it has a All References subtab.
These would be instance numbers of related resources.
You can also find them in Plugin View, Content subtab sometimes,
like for 3DIRs, BINXs and such.
* In the Resource Finder, you can search for parts of names with NameMap search,
for instance and group numbers with TGI Search,
for parts of string in a text list with STR# Search, and more.
The Find box at the top of the Resource Filter selects the type of search.
* Good name map and STR# searches would be parts of the TXTR filename.
For lipsticks, uuface-lip, uuface_lip (underscore, not dash),
and COLOR are all good searches, where COLOR is the lipstick name,
like palepink. For eyeshadow, blushes, masks, try uuface_eyeshadow,
uuface-eyeshadow, uuface_makeup, uuface-makeup. Just uuface turns
up lost of stuff, including eyes, beards, stubble, etc.
* Search does not always find everything, at least for me it didn't.
Maybe my search directories are misconfigured???
You may need to manually look through your The Sims2/TSData/Res folder
and just look through files to see what's in them, I did.
For makeup though, if you look in the files listed in section 1,
you should find the important makeup stuff.
Please spay or neuter your pets. ---
Cat Music Video! ---
my meshes