Skip to content

danielah05/UndertaleDecomp

Repository files navigation

Undertale-DC

- PLEASE NOTE THIS IS STILL A WORK IN PROGRESS! -
A decompilation of the latest version of UNDERTALE for the Nintendo Switch ported to the latest Gamemaker Studio 2 with many added toggleable enhancements
(If you are toby fox please hmu I'd love to talk :3)

Recommended Branches

Branch Description
main Main branch with many enhancements and bug fixes, this is the most recommended one for a stable and improved modding/playing experience. View a list of enhancements here!
vanilla Version of the main branch but with any of the decomp exclusive features and enhancements removed. Recommended for a as vanilla as possible UNDERTALE modding experience.

Main Contributors

Vultumast - Project Lead - Code Cleanup, Bug Fixing, Some Sorting
Daniela - Main Project assistant - Code Cleanup, Bug Fixing, Most Sorting, Most Testing

Asset Extraction Script Creator

Marioalexsan

Contact

Discord: vultumast
Email: [email protected]

Discord

Do you have permission to share this?

We originally emailed the fangamer UNDERTALE contact for permission, but due to some misunderstanding on both sides, we had to take down this project.
HOWEVER: after some more communication, fangamer did allow us to make this a public project as long as it does not bundle any UNDERTALE-specific assets.

Thanks for your coorperation! You could put up a decomp on the following conditions:

- It would need to be a new repository so that the previous upload is no longer in the git history
- All UNDERTALE-specific assets (graphics, music, etc) would need to be removed from the codebase
- Assets can't be distributed with either the source code itself, or included in any compiled executables, etc.

Developers who own a copy of the game should then be able to import the assets from their copy, but those who don't already have one wouldn't have downloaded a functional and complete copy of UNDERTALE.

(If you represent Toby Fox, or any assets in this repository and need to contact me, please do so at [email protected])

How do I use this?

  1. You will need to own UNDERTALE on the Nintendo Switch, dump your OWN rom, and extract the RomFS.
  2. Clone the repo.
  3. Download the latest version of UndertaleModTool (GUI, NOT CLI), you will need it to run the asset extractor script.
  4. In the place you extracted the games RomFS to, locate the game.win file and load it with UndertaleModTool.
  5. After loading the file, in UndertaleModTool, go to Scripts -> Run other script... and load the UndertaleDecompAssetImport.csx script that can be found in the utils\asset_importer folder.
  6. Once the script is done running, just simply open NXTale.yyp inside of Gamemaker Studio 2 (latest!)

Dependencies (Native Linux Build)

libcurl-gnutls lib32-libcurl-gnutls lib32-libpulse lib32-alsa-lib lib32-openal lib32-glu lib32-openssl-1.0

How do I obtain the Switch data?

This repo will not explain how to mod a Switch and how to make dumps from it. If you wanna look into that, here is a list of resources that could help:
Modding your Switch: https://nh-server.github.io/switch-guide/
Dumping and Extracting Games: https://github.com/DarkMatterCore/nxdumptool/releases

nxdumptool allows you to directly extract the RomFS onto your SD Card, if you however wanna extract the RomFS outside of your Switch, look into either one of these (this will require a copy of prod.keys too):
https://github.com/SciresM/hactool/releases
https://github.com/Myster-Tee/NxFileViewer/releases

Can I use this without owning the Switch version of UNDERTALE?

Yes! But it is HIGHLY recommended to use the Switch version of the game.
This should work on any version of the game that you own, however any Switch exclusive content will be missing from the project and will instead be replaced with placeholder assets.
Just run the UndertaleDecompAssetImport.csx script on whatever version of UNDERTALE you own, just like you would with a Switch copy, and you still should be able to compile.

Special Thanks

UnderminersTeam - Made UndertaleModTool
MrPorkchop - Made the Icon
Ally - Made the Decomp Menu Music
TaiAurori - Android Port Testing
Invoxiplaygames - MacOS Port Testing
Clovercorp - Came up with the Name

PR Helpers

Zyle
Marioalexsan
EphraimBane
Nyako

About

UNDERTALE Switch v1.11 Decompilation

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •