Skip to content
This repository has been archived by the owner on Dec 11, 2024. It is now read-only.

danielah05/UndertaleDecomp

Repository files navigation

Undertale-DC

Archive Notice

This project was originally started for fun and has made huge advancements since first created, things like XBOX content being ported over, the massive work put into macros, etc, but has become a nightmare to maintain, things constantly break due to new Gamemaker Studio 2 updates and it is honestly pretty hard to keep up at this point.
Anyone can feel free to pick up this project and continue it, but this repo is no longer maintained, hopefully this is understandable.

A decompilation of the latest version of UNDERTALE for the Xbox One ported to the latest Gamemaker Studio 2 with many added toggleable enhancements

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 a copy of UNDERTALE, can be any version but the XBOX version is HIGHLY recommended!
  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 data to, locate the data.win or 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 Xbox data?

Currently there is no easy guide on how to dump Xbox games and get the game data from them, so this is something you will need to look into yourself.
Alternatively, we recommend using the Switch version of the game instead, as that is the closest you will get to the Xbox version.

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 or Xbox version of UNDERTALE?

Yes! But it is HIGHLY recommended to use the Switch or Xbox version of the game.
This should work on any version of the game that you own, however any Switch or Xbox 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 or Xbox copy, and you still should be able to compile.

Special Thanks

UnderminersTeam - Made UndertaleModTool
MrPorkchop - Made the Icon
Julie578 - 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
Sadie
AveryMadness

About

UNDERTALE Xbox v1.13X Decompilation

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published