Custom busts

From Trials in Tainted Space Wiki
Jump to navigation Jump to search

Custom busts are a feature that allows players to change the busts displayed in the upper left corner without compiling the game/using a resource editor. You can think of it as adding an additional artist to the game whose busts are always used when a matching bust is found (ie has been added by the player).


Enable

How do I use it?

Download the game's swf file (eg TiTS_x.y.z.swf - You need v0.7.82 or newer)

Copy the file into a folder on your computer (eg tits_folder)

Create another folder inside the tits_folder that is named custom_busts - this folder will contain all the busts you want to replace

Copy the replacement image into the custom_busts folder - they should match the existing busts (png format, 150px tall, transparent background) and need to be named the same as the internal bust reference. The bust selector dialog will show the name of the current bust if you press the "Bust Name" button.


Bust Name reveal
Bust Name reveal


To replace the the Flahne bust shown in the above picture the file in the custom_busts folder needs to be named Bust_FLAHNE.png

After adding/removing busts reload the game/swf file as the existence of replacement busts is cached.

Now the game should replace the bust with the custom image - a message indicating that the replacement is active will be shown in the bust selector dialog.


Bust Name reveal with custom bust
Bust Name reveal with custom bust

Example

To get the old Syri bust back download the old bust from here.

Rename the file to Bust_SYRI.png and put it into the custom_busts folder.

To additionally replace the naked Syri bust copy the file and name the second copy Bust_SYRI_NUDE.png

So you'll end up with three files organized like this:

tits_folder\TiTS_x.y.z.swf
tits_folder\custom_busts\Bust_SYRI.png
tits_folder\custom_busts\Bust_SYRI_NUDE.png

Disable

How do I NOT use it?

Don't add a custom_busts folder next to the swf file and the bust display should behave as it used to - if it doesn't please report the bug.

To temporarily disable all replacement busts rename the custom_busts folder, to temporarily disable a single replacement rename the file or move it to a different location. Don't forget to reload the swf file.

Errors

Flash displays a security error - What's wrong?

The latest versions of the flash player plugins don't allow access to local files anymore - the requested security model/sandbox is silently replaced by the flash plugin. To play the game you need to download the stand alone player from adobe.

Extra information can be found at the fenoxo.com forums here.

Updates

An update was released - what now?

Simply copy the new swf file into the tits_folder and you should be good to go. The existing bust names will rarely change so everything should be set up correctly. If you want to change a newly added bust just get the bust name from the dialog and add the image file as usual.

Limitations

Only busts in the upper left corner (the location header) are replaced. You can only change/replace busts - not add currently missing ones. There is a small delay/flicker when a custom bust is loaded - when the game 'shows' a bust the loading process is started in the background and the image is switched on once the loading is complete.