search

chicory-pizza / chicory-macaroni

Convert the Mac edition of Chicory: A Colorful Tale to be playable on Windows
https://macaroni.chicory.pizza
GNU General Public License v3.0
0 stars 0 forks source link

readme

Chicory Macaroni

This script automates the process of converting the Mac edition of Chicory: A Colorful Tale to be runnable on Windows.

The main reason to do this is that the Windows edition is compiled using YYC which makes game scripts uneditable, however the Mac edition somehow wasn’t compiled with YYC.

If you have trouble getting this to work, check out our Chicory fan Discord!

How to use

First of all, make a backup of your save!! You can find it at %localappdata%\paintdog\, zip it and upload to your Dropbox/Google Drive/whatever for safekeeping.

  1. Obtain the Windows and Mac editions of the game, you need both data.win and game.ios

    If you don’t have a spare Mac, follow these steps to download the Mac edition (only available through Steam)

    1. Press Win+R to open the Run dialog
    2. Enter steam://open/console and click OK
    3. Enter download_depot 1123450 1123452 in the Steam console
    4. Wait for a “Depot download complete” message
    5. Once finished, you can locate the download at C:\Program Files (x86)\Steam\steamapps\content\app_1123450\depot_1123452

  2. Download UndertaleModTool and extract it, despite its name, it’s not just for Undertale!

  3. Download the Macaroni script and extract it

  4. Run UndertaleModTool

  5. Click Scripts > Run other script...

  6. Find and select ConvertChicoryMacaroni.csx

  7. Select data.win from the Windows edition

  8. Select game.ios from the Mac edition

  9. Once finished, copy RunMacaroni.bat and Runner.exe to the Windows edition

You’re all done! You should be able to open macaroni.win in UndertaleModTool to start editing game scripts.

To run the game, just open RunMacaroni.bat

Non-Steam players The Mac edition is only available on Steam, if you obtained the game outside Steam, please contact our [Chicory fan Discord](https://discord.chicory.pizza) which we can try other methods.
Game Pass/Microsoft Store players It's possible to convert the Game Pass/Microsoft Store edition to use Macaroni, however you will lose Xbox integration such as achievements and save files.
Troubleshooting The script was originally built for UndertaleModTool v0.5.1.0, using older or newer versions may or may not work correctly. The script was tested against the game data files of Windows edition v1.0.0.66 and Mac edition v1.0.0.66, using other versions may or may not work correctly. The script is only tested on Windows and the UndertaleModTool GUI, using other operating systems or the CLI are not guaranteed to work.
Manual steps Everything that the automated script does can be done manually if you have trouble with the script, please do [file a GitHub issue](https://github.com/chicory-pizza/chicory-macaroni/issues) or [contact our Discord](https://discord.chicory.pizza) so the script can be fixed though! 1. Obtain the Windows and Mac editions of the game 2. Merge the shaders from the Windows edition to the Mac data 1. Open `data.win` (Windows edition) in UndertaleModTool 2. Click Scripts > Unpack assets > ExportShaderData.csx 3. Select an export folder 4. Open `game.ios` (Mac edition) in UndertaleModTool 5. Click Scripts > Repack assets > ImportShaderData.csx 6. Select the previous export folder 7. Save the newly modified data as `macaroni.win` next to `data.win` (Windows edition) 3. Obtain GameMaker runner version 2022.9.1.66 1. Download the Windows edition of GameMaker at [https://gamemaker.io/en/download](https://gamemaker.io/en/download) 2. Once GameMaker is installed and running, click File > Preferences 3. Go to Runtime Feeds > Master 4. Install version 2022.9.1.66 5. Go to `C:\ProgramData\GameMakerStudio2\Cache\runtimes\runtime-2022.9.1.66\windows\x64` and copy `Runner.exe` next to Chicory's `data.win` 4. Create a batch file with this contents and save as `RunMacaroni.bat` inside the game folder ```batch start .\Runner.exe -game macaroni.win -debugoutput %temp%\macaroni.log ``` To run the game, just open `RunMacaroni.bat`

How to tell it’s working

How to revert

Delete macaroni.win, RunMacaroni.bat and Runner.exe

If you want to be really sure, you can also use Steam’s “verify integrity of game files” feature and restore your saved game backup (you did back up your saved games, right?)

Why this name

I asked on the modding Discord for a good food pun, and Somewhat immediately suggested Macaroni, because Mac-and-Windows, get it...?

Special thanks

License

This script is open-sourced on GitHub!

Licensed under GPL v3.0, same as UndertaleModTool.