Installing Undertale mods for mac
This is a guide/tutorial for installing Undertale mods on mac.
Generally, mods come in four types: Music mods, QuickBMS mods, Translatale mods and UTpatcher mods. Mods may be combinations of these, especially music + one of the others.
Music mods
Mods that only change the .ogg music files. An example is MidiTale v1.0
- Make a copy of your UNDERTALE.app. The Steam version is located at "~/Library/Application Support/Steam/SteamApps/common/Undertale".
- Right (ctrl) click the copied .app and choose "show package contents".
- Open "Contents" and then "Resources".
- Copy all of the mods .ogg files into the folder, replacing when prompted.
- That's it. Close the folder and you're done.
QuickBMS mods
Mods that were made with QuickBMS. Can be recognized by the fact that the filenames of the files are long numbers like "00002a00.wav" or "0000297c.png". Exampled include MidiTale v1.1 and JpegTale.
- Install WineBottler: Download from here.
- Make a copy of your UNDERTALE.app. The Steam version is located at "~/Library/Application Support/Steam/SteamApps/common/Undertale".
- Right (ctrl) click the copied .app and choose "show package contents".
- Open "Contents" and then "Resources".
- The mod probably came with QuickBMS, and some kind of Readme file.
When the Readme file talks about putting "data.win" somewhere, take the "game.ios" file from the "Resources" folder instead and rename it to "data.win".
Then, follow the rest of the instructions from the Readme. (usually something like running some .bat file).
If you get a "file not found" error, put the files in a place without spaces in the path.
- Take the (now patched) "data.win" file, and rename it back to "game.ios".
- Copy it back to the "Resources" folder.
- That's it. Close the folder and you're done.
TranslaTale mods
Mods that usually come with a folder containing .png files named 0.png to 15.png and/or some kind of .txt that contains strings. A example is the colored sprites mod.
- Install WineBottler: Download from here.
- Make a copy of your UNDERTALE.app. The Steam version is located at "~/Library/Application Support/Steam/SteamApps/common/Undertale".
- Right (ctrl) click the copied .app and choose "show package contents".
- Open "Contents" and then "Resources".
- Download this. It contains WinExtract and WinPack. Put it in a place without spaces in the path.
- Copy the "game.ios" file from the "Resources" folder into the folder containing WinPack and WinExtract.
- Run "unpackmac.bat".
- Copy the .png-s from the mod into the "TXTR" folder within the "assets" folder (if the mod has them), replacing when prompted.
- Rename the .txt with the strings into "translate.txt" and copy it into the "assets" folder (if the mod has it), replacing when prompted.
- Run "repackmac.bat".
- Copy the (now patched) "game.ios" file back into the "resources" folder.
- That's it. Close the folder and you're done.
UTpatcher mods
Sorry, I have yet to find a reliable way to install such mods.
Apparently the .utp files are really just glorified bps patches, so you should be able to somehow get/extract a .bps file and use a bps patcher to patch it to "game.ios", ignoring the warnings that the checksum doesn't match.
I currently recommend to ask the mod creator for the files themselves and then use the TranslaTale guide.
If anyone has info on how to patch utp files on mac or how to extract a .bps from them, send me a message with the contact-form here.
If you have questions, recommendations or need help, send me a message with the contact-form found here.