MTS has all free content, all the time. Find out how YOU can help to keep it running. Tell me how...

Postal Package Editor (and API)

by Echo Posted 9th Aug 2009 at 4:27 PM - Updated 27th Nov 2013 at 4:14 PM by Nysha
176 Comments / replies (Who?) - 1 Feedback Posts, 1 Thanks Posts
Postal is a DBPF3 package editor. That means that it can open up Sims 3 package files, let you poke at their innards, change things around, then save them back into new package files.

Can I run it?
Postal is built on top of Java 6, so if you can run Java 6 then the answer is "yes". That includes Windows XP, Vista and Mac OSX. If you can run the Sims 3, you should be able to run this.
There is one caveat though. Because I'm running Windows, I cannot test well on Mac. Please let me know if you experience any issues.

What can it do?
Postal can navigate all kinds of Sims 3 package files, and parse/display/write many resources, including OBJDs, OBJKs, STBLs, XMLs, CSTRs, GEOMs, NMAPs, DDSs, PNGs, VPXYs, Texture Compositors and the various text-based formats. As time goes on, the number of resource types it can edit is growing.

Postal also has a filetable which keeps track of all the resources that can be used in game. You can use this to search for resources by type, group, or instance, wherever they come from. Postal has a scripting console, and a plugin architecture to allow you to add your own functionality to the application.

The Postal API
The Postal Editor is built on top of the "Postal API". This is a library which speeds up the process of writing custom tools which can read from and write to package files and the resource types inside them. The API is available under a BSD license, which essentially means you can use it however you like in your own tools as long as you acknowledge the original creator and point to a place where the original source can be downloaded. (The full Postal GUI is available under a GPL license)

The Postal API has already been used in other tools, including The Sims 3 Mod Generator and Merlin . There is some documentation on how to use it to build your own applications and how to extend the Postal environment attached.

- Go to and install the up-to-date version of Java for your operating system (if you don't already have it)
- Download the latest version of the Postal installer from
- Double click on the file you have downloaded, and follow the Wizard. Make sure you put in the correct path to your Sims 3 installation when it prompts you!

* Mac OSX users, please see this post regarding running Java 6

Additional Credits:
Most of the behaviour here is based directly off the wiki pages describing file formats and resource structures. Thanks to Rick, Karybdis, Delphy, WesHowe, Inge, Peter, Atavera, Pescado and the many others who have contributed their knowledge to that collective effort.
Tags: #Postal, #DBPF, #editor, #api, #stbl, #dds, #geom, #xml

Operating System: Windows Linux Mac OS X
Utility Type: CC Editors
Plugin Type: Not Applicable

You must have the expansion or stuff packs listed below installed to use this custom content. Please see the post text for any exceptions.

Sims 3
Key: - File was updated after upload was posted
Filename - Tip: You can click the magnifying glass to see the archive contents Size Downloads Date
user-installation.rar | Install instructions (same as in post)

Size: 388 Bytes · Downloads: 21,159 · 10th Aug 2009
388 Bytes 21,159 10th Aug 2009
FOR-DEVELOPERS-ONLY-Postal-developer-guide-PDF.rar | Documentation for developers interested in using Postal in their own tools

Size: 308.1 KB · Downloads: 10,153 · 10th Aug 2009
308.1 KB 10,153 10th Aug 2009
Don't forget to Thank the creator after downloading! Use the Thanks button located above the screenshots above.
Quick Guide:

1. Click the file listed on the Files tab to download the file to your computer.
2. Extract the zip, rar, or 7z file. Now you will have either a .package or a .sims3pack file.

For Package files:

1. Cut and paste the file into your Documents\Electronic Arts\The Sims 3\Mods\Packages folder. If you do not already have this folder, you should read the full guide to Package files first: Sims 3:Installing Package Fileswiki, so you can make sure your game is fully patched and you have the correct Resource.cfg file.
2. Run the game, and find your content where the creator said it would be (build mode, buy mode, Create-a-Sim, etc.).

For Sims3Pack files:

1. Cut and paste it into your Documents\Electronic Arts\The Sims 3\Downloads folder. If you do not have this folder yet, it is recommended that you open the game and then close it again so that this folder will be automatically created. Then you can place the .sims3pack into your Downloads folder.
2. Load the game's Launcher, and click on the Downloads tab. Find the item in the list and tick the box beside it. Then press the Install button below the list.
3. Wait for the installer to load, and it will install the content to the game. You will get a message letting you know when it's done.
4. Run the game, and find your content where the creator said it would be (build mode, buy mode, Create-a-Sim, etc.).

Extracting from RAR, ZIP, or 7z: You will need a special program for this. For Windows, we recommend 7-Zip and for Mac OSX, we recommend Keka. Both are free and safe to use.

Need more help?

If you need more info, see:
176 Comments / Replies (Who?) - 155 Feedback Posts, 10 Thanks Posts
Hide Thanks Posts for this thread (Show only feedback)
Page 8 of 8
Lab Assistant
#176 Old 16th Apr 2016 at 4:24 PM
in him Hash Disclosure?
Test Subject
#177 Old 30th Oct 2016 at 5:20 AM
Page 8 of 8