Bleeding Edge

This is an automatically updating bleeding edge build of UndertaleModTool. There will be bugs! If you encounter any, please make an issue on GitHub or join the Underminers Discord for more help!

UndertaleModTool v0.6.1.0

This is the 0.6.1.0 UndertaleModTool release, for 64-bit Windows. Downloads can be found at the bottom of this release.

Changelog

Note: This is a minor release. To see the changes in major release 0.6.0.0, click here.

Changed

• The RunSwitchOnPC.csx script now helps with running the Switch and Xbox versions of Undertale on PC. It has thus also been renamed to RunSwitchAndXboxOnPC.csx

Fixed

• Fixed the EmSize field on font assets always being loaded as the number 0, in games where it was a floating point number.
• Fixed GameMaker version 2023.1 getting misdetected when loading, due to some unnecessary leftover code.

Full Changelog:

0.6.0.0...0.6.1.0

UndertaleModTool v0.6.0.0

This is the 0.6.0.0 UndertaleModTool release, for 64-bit Windows. Downloads can be found at the bottom of this release.

Changelog

Added

• Added GameMaker 2023.4, 2023.6, 2023.8, and 2024.2 support.
• Added GameMaker 2022.0.2+ LTS support.
• Added partial save/load support for GameMaker 2024.6.
• The GUI will now show extension options from GameMaker 2022.6.
• A new tooltip explains what the asset index shown in the bottom right corner means.
• Profile mode support has been added for GameMaker 2.3+ games.
• YYSWF support has been added for GameMaker 2022.1 games
• The "ImportGMS2FontData" script is now able to handle font data from GameMaker 2023 IDEs.
• A "TouchControlsEnabler" script has been added, which allows enabling touch controls in an Undertale game.
• Added Spine sprite support for GameMaker 2023.1.
• Struct support has been added.

Changed

• The "ImportGraphics" script has been changed to accept sprites with zero-padded indices (e.g. spr_abc_001.png).
• The "SpriteOriginCopy2_3" script has been removed, as its behavior was merged into the "SpriteOriginCopy" script.
• The "ApplyBasicGraphicsMod" script will no longer tell you that image dimensions are not the proper size, as the check for it was faulty.
• The "NewTexturePacker" script has been improved to bin pack better, as well as have the ability to change the bin sizes for both dimensions.
• Decompiling and disassembling code entries will now be slightly faster and use a lot less RAM.
• The "ImportAllEmbeddedTextures", "ImportAllStrings", "ExportAllStrings", "ExternalizeAllOGGs", and "ExportAllSounds" scripts are no longer Windows-only.
• The "TTFFonts" script now makes it clearer that it's only meant for Undertale.
• Removed redundant .NET localization folders (e.g. "cs", "de", "es"...) for the non-single file version.
• When failing to fetch a localization comment for Undertale or Deltarune, it is now shown as // <localization fetch error>.
• More assets in Deltarune will now be shown correctly rather than as numbers.
• When using scripts with the CLI, the "Newtonsoft.Json" library is now added as a reference.
• The "ExportAllSprites" script will now ask you if you want each sprite in a subfolder.
• The "DebugMsg" script can now be used again.
• A message box is no longer shown when saving a profile for profile mode.
• Updated GitHub URLs to point to the new organization's version of the repository.
• Some discrepancies between Debug and Release builds have been removed, when loading data files.
• The Git commit hash is now shown in the title bar of bleeding edge builds produced by GitHub Actions.
• Exception messages in the GUI, as produced by C# scripts, have been improved to look better with multiple scripts in the stack trace.
• The line numbers in search results are now clickable.
• API: Multiple public lists now have a setter.
• API: Add a lot more documentation.
• API: Small documentation revisions made to some models in the library.

Fixed

• UTMT will no longer duplicate function names.
• UTMT will no longer randomly crash when attempting to save.
• The "ImportGMLFile" script will not prompt you to enter an object name when importing collision event scripts.
• UTMT will no longer sometimes open an incorrect tab, as opposed to the one you clicked on.
• UTMT will no longer scroll the tab view if the current tab is already fully visible.
• Some code entries which contained switch statements will no longer freeze the decompiler.
• The CLI will no longer crash when attempting to dump code from a YYC game.
• The warning that appears when a file has unexpected padding will no longer be shown in the CLI, when verbose is off.
• Fix edge case where pasting new code on top of a code entry that had an exception in its output will crash UTMT.
• Fix UTMT crashing in certain cases when exporting a room as a PNG ("ExportAllRoomsToPng.csx").
• Adding a new shader now properly allows you to edit it.
• The disassembly tab will no longer freeze on large code entries.
• UTMT will now properly discover GameMaker 2.3+ runtimes.
• When decompiling code, return statements will now be properly shown again.
• When decompiling certain code entries, parentheses will now be placed to prevent inaccurate decompilation.
• Fix decompilation errors from code entries using the Boolean type introduced in GameMaker 2.3.7.
• Fix an edge case where compiling a code entry that had boolean expressions inside of a binary operation would cause games to crash.
• Detecting GameMaker 2.2.2.302 no longer fails on certain edge cases.
• Fixed cases where games using shaders and bytecode 13 would not load correctly.
• Fixed background/tileset parsing for bytecode 12 games.
• Renamed the ClearDisplayBuffer flag to DoNotClearDisplayBuffer, as that's what it's actually doing.
• Fix the font size being inaccurately saved as whole numbers.
• Fix the CLI crashing when a warning or an error has occurred.
• Fixed an edge case where the built-in updater would crash.
• When using profile mode, fetching localization comments for Undertale or Deltarune will not endlessly append them.
• Allow some GameMaker 1.0.0.1250 games, which used builtin audio groups, to load.
• Fix a regression that led to GameMaker 2.3.1 detection not working correctly in some games.
• Fix external textures producing warnings when loading data files.
• Fix false-positive GameMaker 2022.1 version detection, which led to some early 2.3 games failing to load.
• Fix GameMaker 2.0.6 version detection occurring too late in the load process.
• Fixes in the decompiler involving parentheses and correctness of the right sides of arithmetic.
• Fix C# scripts being unable to use relative paths when using the #load preprocessor.

New Contributors

• @zxopink made their first contribution in #1351
• @Romualdo666 made their first contribution in #1424
• @nhaar made their first contribution in #1505
• @Yule42 made their first contribution in #1546
• @angelapuzzle made their first contribution in #1571
• @GitMuslim made their first contribution in #1415
• @filispeen made their first contribution in #1587
• @XdotCore made their first contribution in #1681
• @Marioalexsan made their first contribution in #1718
• @CST1229 made their first contribution in #1722
• @NC-devC made their first contribution in #1672
• @EvaxTheFox made their first contribution in #1481

Full Changelog: 0.5.1.0...0.6.0.0

UndertaleModTool v0.5.1.0

Overview

Additions:

• The dark mode setting (@VladiStep in #1141, #1221, #1273, #1336, #1342).
• Tabs content state saving and restoring (tab sessions) (@VladiStep in #1152).
• More ways of opening an object in a new tab (@VladiStep in #1232).
• The "Find all references" feature and the new "Find" menu: (@VladiStep in #1246)[0]
  Allows you to search for references of any common type asset by right-clicking:
  - An asset in the main list
  - An object reference in the "Object definition" fields
  - A tile on the GMS 2 tileset image (@VladiStep in #1288)
  - A texture page item on the embedded texture image (@VladiStep in #1293)[0]
• A support for the tile layer exported data (.csv) from "Tiled" (@VladiStep in #1280)[0].
• A proper support for code with multiple functions (@Jacky720, @VladiStep in #1191).
• Proper code editors for shaders (@VladiStep in #1294).
• A support for sequence text tracks (GM 2022.2 - e.g. "Dono’s Tale") (@VladiStep in #1197).
• New scripts - "SpriteOriginCopy.csx", "SpriteOriginCopy2_3.csx" (@fixdude in #1144).
• A support for GM 2023.1 games (e.g. "HoloCure", "Alien XENOCIDE") (@VladiStep in #1206).
• A support for some GMS 2.0 games (@VladiStep in #1205, #1329).
• A support for GM 2023.2 games (and particle systems) - e.g "The Slormancer", "Nova Drift" (@VladiStep in #1238, #1353, #1361).
• An indication for the sub-functions cache building on first decompilation and 3 minutes timeout for it (@VladiStep in #1241).
• Proper sequence model names for debugging and the "Find all reference" results (@VladiStep in #1254).
• A support for games with room path layers (@VladiStep in #1256, #1268).
• A possibility to delete room objects through context menu (@zivmaor, @VladiStep in #1301).
• The "Run other script..." option on missing "Scripts" folder (@VladiStep in #1364).
• An option to export one sprite with padding (@VladiStep in #1367).

Fixes:

• A memory leak of UTMT scripts and the command box (@VladiStep in #1220).
• A bug with textures not being displayed in GM 2022.3+ games; improvements of an "ImportGMS2FontData.csx" script (@Dobby233Liu, @Miepee, @VladiStep in #1048).
• A bug with PromptChooseDirectory() infinite loop in CLI (@VladiStep in #1183).
• An "ExportAllRoomsToPng.csx" script error (@VladiStep in #1164).
• A crash in CLI version on events replacing (@TheAwoo in #1174).
• A "Texture failed to loaded!" error in the embedded texture editor (@VladiStep in #1199).
• An extension file and function tab titles display (@VladiStep in #1200).
• A room background definition removing (@VladiStep in #1202).
• A crash in "Deltarune 1&2" after a "Ch2 Debug.csx" script (@Jacky720 in #1188).
• The "Gdip" crash in CLI version on loading GM 2022+ games (@VladiStep in #1302).
• An annoying XAML binding error in "Visual Studio" log (@VladiStep in #1228).
• Environment.ProcessPath warnings in "Visual Studio" (@VladiStep in #1234, #1258).
• A bug in the code editor that led to freezes on some errors (@VladiStep in #1243).
• The "FindUnusedStrings.csx" script (@VladiStep in #1246)[1].
• A rare crash on drag&dropping within the asset list and the tab panel (@VladiStep in #1264, #1289).
• A crash on the tileset image click (@VladiStep in #1274).
• Incorrect GMS 2 rotated/flipped tiles display (@VladiStep in #1280)[1].
• A bug that broke the "Disassembly" code editor tab on some localizations, e.g. Turkish (@VladiStep in #1298).
• A random SaveCodeChanges() crash on data saving (@VladiStep in #1304).
• A rare crash on opening the "Disassembly" code tab (@VladiStep in #1322).
• A crash on invalid entered color value (@VladiStep in #1357).

Changes:

• The version flags cleanup and proper GM(S) version in the title (@Jacky720, @Miepee, @VladiStep in #1047; @VladiStep in #1213).
• Game data loading is noticeably faster and uses less RAM (@VladiStep in #1161).
• Made the embedded texture image zoomable and more interactable (@VladiStep in #1293)[1].
• A lot of the font editor improvements: (@VladiStep in #1328, #1331, #1332, #1346)
  - Added the red marker for the selected glyph, made the font texture clickable.
  - Made the glyphs table show and accept actual characters.
  ... and more! See the PR description.
• Disabled room layers are highlighted with gray color (@VladiStep in #1201).
• The "Timestamp" value (in "General info") is in human-readable format (@VladiStep in #1226).
• An optimization of the "data.win" file context menu options - e.g. "Run game normally" (@VladiStep in #1245).
• An optimization of "ExportAllCode2_3.csx" script (@VladiStep in #1239).
• Room object names improvements (@VladiStep in #1246)[2].
• Made the room instance layer objects resolving safer - adds a support for a "Pizza Tower D3 v3.1" mod and "Heroine Conquest" (@VladiStep in #1266, #1299).
• Made the GMS debugger related things more distinguishable from the debug mode in some games; the GMS debugger file option is hidden by default (@VladiStep in #1330).
• Improved the object reference fields clarity (@VladiStep in #1363).

New Contributors

• @TheAwoo made their first contribution in #1174
• @fixdude made their first contribution in #1144
• @zivmaor made their first contribution in #1301

Full Changelog: 0.5.0.0...0.5.1.0

---

The CLI version has been moved to the Bleeding Edge release, if you need command line tools get it there, otherwise select "UndertaleModTool_v0.5.1.0.zip".

UndertaleModTool v0.5.0.0

The long awaited UndertaleModTool v0.5.0.0 is here! There are many many changes since the previous version. That should make sense since it has been about a year. Well, lets get started!

Go to the bottom to get the download.

Additions:

• The "+" (create new code) button for empty code fields (@NyakoFox, @VladiStep in #776, #955).
• The GMS 2.3 struct decompilation (@BenjaminUrquhart in #803; @steviegt6 in #1039).
• The "FindObjectsWithSprite.csx" script (@VladiStep, @Miepee in #813).
• The "Copy name to clipboard" context menu option (@VladiStep in #814).
• The game object tabs.
  - Original author - @SolventMercury in #777.
  - Separation of the changes and redrawing of the close icons - @Miepee in #824, #850.
  - Tabs code rewriting, improvements and fixes and the "Forward" button (bringing the tabs system to acceptable state) - @VladiStep in #831, #852, #873, #977, #988, #1003, #1008, #1092, #1148.
• The UndertaleModTool code documentation (@Miepee in #806, #874, #903, #904, #908, #912).
• The "Frame index" and "Image speed" fields for game object instances in the room editor (@VladiStep, @Miepee in #849).
• More features for CLI version of UndertaleModTool (@Miepee in #860, #862, #1064).
• The GitHub pull request and issue templates (@FriskTheFallenHuman, @Miepee in #840).
• The git commit+branch info in UndertaleModTool development build ("bleeding edge") title (@Miepee in #885).
• The updated "README.md" (GitHub main page of UTMT) (@FriskTheFallenHuman, @Miepee, @NyakoFox, @Grossley in #841; @Miepee in #894).
• Automatic building of pull requests changes for easier testing (@Miepee in #919).
• The "bleeding edge" version of UTMT (@Miepee, @Grossley in 94ea048; @Miepee in #952).
• The support for function scr_myscript() formatting in GMS 2.3+ (@Jacky720, @Miepee in #921; @steviegt6 in #1036).
• The support for game data files larger than 2 GB + some optimizations (@VladiStep, @Miepee in #960).
• The "Width" and "Height" UI fields for texture pages (@VladiStep in #995).
• The default "Filter by name…" for the search box (@VladiStep in #1009).
• Added the (global) settings for the room editor grid (@plrusek in #931 → @Miepee, @VladiStep in #1005).
• The "ImportGMS2FontData.csx" script (@Dobby233Liu in #1041).
• A better script debugging (@ngyikp in #1069).
• A support for version 3 of the spine sprites (@nkrapivin, @Miepee in #1097).
• Progress bar indication in a toolbar (@VladiStep in #1104).
• A support for 27-bit reference chain offset – e.g. "ZERO Sievert" (@colinator27 in c897860).
• Near-complete save/load support for GM 2022.2 to 2023.1 and LTS (@colinator27, @Jacky720 in 84e15d5, #793, #821, #902, #1043, #1046, 856041c, 68057e1, 39d6cf0).

Fixes:

• A crash on creating a new item with non-empty search box (@Jacky720 in #791).
• A crash on adding a game object to room and accessing it afterwards (@mandar1jn in #794).
• A bug in "ImportGraphics.csx" that prevented sprites import from wrongly-named folder (@NyakoFox in #795).
• Some crashes and bugs of the "Update app to latest commit" option (@VladiStep in #808, #811).
• A crash on adding a room assets or tiles layer (@VladiStep in #810).
• A crash in "ImportGML.csx" (@VladiStep in #809).
• The errors of "ImportFontData.csx" (@Miepee in #807, #920).
• A decompiler error - #798 (@BenjaminUrquhart in #817).
• A crash with empty sprite instance in a room (@VladiStep in #830).
• A minor compiler error in "SURVEY_PROGRAM" (@Jacky720 in #843).
• A crash on adding some sprite-based room objects without textures (@plrusek in #854; @VladiStep in #1103).
• A freeze on opening GMS 2 room without IsGMS2 flag (@VladiStep in #856).
• Some instances of "Object reference not set to an instance of an object" error on game data saving (@Jacky720 in #848).
• A lot of room editor issues (@VladiStep, @Miepee in #876, #884, #888).
• The errors related to UndertaleModTool folder path detection (@VladiStep, @Miepee in #946).
• QOI textures display on different system scale setting (@VladiStep, @Miepee in #948).
• The "Strings" list issues (@VladiStep, @Miepee in #954).
• The issues with some messages not showing up (@Archie-osu in #936; @Miepee, @VladiStep in #956, #987).
• A recognition of some GMS 2.3 keywords (@Miepee, @VladiStep in #968).
• The object ID display for code and strings (@VladiStep, @Miepee in #1004).
• The room editor grid size bugs (@VladiStep in #1014).
• The non-disappearing "Found no matches!" popup in the code editor (@VladiStep in #1017).
• The room object selection in the room preview (@plrusek in #931 → @VladiStep in #1019).
• The error in "ImportGML.csx" script with short-named code (@Miepee in #1063).
• The "ExtractEmbeddedDataFile.csx" script requires loaded game data (@VladiStep in #1109).
• A crash on a texture page item with zero source size (@VladiStep in #1093).
• The "NewTextureRepacker.csx" messing QOI textures up (@VladiStep in #1102).
• The "TTFFonts.csx" script not working in GMS 2 Undertale versions (@IruzzArcana in #1113).
• The rare "BadDeviceId calling waveOutOpen" sound error (@VladiStep in #1090).
• The progress bar position resetting (@VladiStep in #1106).
• The texture group editor unable to add any entry (@VladiStep in #1119).
• The broken file path in "ExportAllStrings.csx" and "ImportAllStrings.csx" (@Sonhonet in #1136).
• Some issues with "DeltaHATE.csx" and "DeltaMILK.csx" scripts (@Jacky720, @Miepee in #1085).
• The bug with lost code changes on Ctrl-clickling in the code editor (@VladiStep in #1160).

Changes:

• Code improvements of CLI version of UndertaleModTool (@Miepee in #812, #865, #911, #966).
• UndertaleModTool is upgraded to .NET 6 (C# version 9+) (@Miepee in #863, #905).
• Removed a custom Pair<> class (@Miepee in #881).
• General code cleanup (@Miepee in #897, #964, #967).
• Combined GetAssetTagID() methods into one (@Miepee in #907).
• Deprecated "AUMI" support (@Miepee in #909).
• Improved sprite texture entries removing (@VladiStep in #932).
• Reorganization of UndertaleModTool scripts and dynamic scripts menu (@Miepee in #935, #937, #978, #1006).
• Merged the "dna.txt" readme into the main readme (@Miepee in #961).
• Removed 32-bit support from the app updater (@Miepee in #980).
• QOI textures (de)serialization optimizations (@VladiStep, @Miepee in #963).
• Removed "GraphViz" from the code editor (@Miepee in #965).
• The "Settings" window is more compact (@plrusek in #931 → @Miepee, @VladiStep in #988).
• The room editor grid is in front (@plrusek in #931 → @Miepee, @VladiStep in #1001).
• Removed the GMS 2.3 warnings (@Grossley, @Miepee in #1000, #1013).
• The code editor scrolling optimizations (@VladiStep in #1158).

0.4.0.4

UndertaleModTool v0.4.0.4 has support for the newest Deltarune update. It can also do decompiled editing of code scripts for GMS 2.3+.

General changes:

• Fixed version detection for older games

Room editor changes:

• GMS 2 sprite instances and (basic) tile layers support.
• Fixed horizontal/vertical lines between tiles.
• Backgrounds and background layers are now working properly.
• Re-added "Save as PNG" button.
• Fixed room object selection (always opens clicked object properties).
• Following features now work with GMS 2 games: drawing with room object, room object order changing (with + or - key), automatic grid size calculation.
• When selected room object is not in the currently displayed room region, it shows that object by scrolling to it.

Other changes:

• Fixed various memory leaks.
• Fixed and optimized "ExportAllRoomsToPng.csx" script.
• Optimized font editor, so it opens faster.

All files in this release are for x64 computers and includes .NET bundled (no install necessary). This release contains UndertaleModTool single file, UndertaleModTool non-single file, and UndertaleModCLI. If you are encountering strange issues or glitches with the regular single file version, use the non-single file version (abbreviated to NSF).

0.4.0.3

UndertaleModTool v0.4.0.3 has support for the newest Deltarune update. It can also do decompiled editing of code scripts for GMS 2.3+.

All files in this release are for x64 computers and includes .NET bundled (no install necessary). This release contains UndertaleModTool single file, UndertaleModTool non-single file, and UndertaleModCLI. If you are encountering strange issues or glitches with the regular single file version, use the non-single file version (abbreviated to NSF).

0.4.0.2

UndertaleModTool v0.4.0.2 has much better support for newer games in general and many new features.

All files in this release are for x64 computers and includes .NET bundled (no install necessary). This release contains UndertaleModTool single file, UndertaleModTool non-single file, and UndertaleModCLI. If you are encountering strange issues or glitches with the regular single file version, use the non-single file version (abbreviated to NSF).

You can use CTRL+K to compile decompiled code you are editing without clicking out of the editor window.

---

Changelog

Additions:

• Added UndertaleModCLI.
• Added "NewTextureRepacker.csx".
• Added "SearchLimited.csx" (Search for terms within a limited code scope).
• Added "SearchASM.csx" (Search disassembly for text).
• Added "UndertaleRunButton.csx" (allows you to running faster in Undertale using the backspace button).
• Added "ScaleAllTextures.csx" (upscale or downscale all textures in a game).
• Added "SafeBlaster.csx" (make the Gaster Blaster more easily moddable into more battles).
• Add a README.txt file, additional opt out of file associations are available.
• Added "ExportAllTexturesGrouped.csx" (exports textures by texture group).
• Added "UndertaleDialogSimulator.csx", mod by Lil'Alien (thank you).

Improvements:

• Implemented FEDS chunk.
• Added support for new QOI+BZip2 image format.
• Allow opening files by drag and dropping them onto the window.
• Added (dis)assembler support for nullish operator.
• Changed all tab characters to 4 spaces.
• UndertaleModLib is now buildable into a Nuget package.
• Preserve temp file to mitigate data loss.
• Added a "Don't show me this again" option to the GMS 2.3 warning.

Decompiler Improvements:

• Rudimentary 2.3 (de)compiler fixes
• 2D array get/set fix
• "with (other)" + duplicate fixes
• Fixed decompiler fails on switch statements with conditionals.
• Fixed other objects' array "+=".
• Fixed stacktop/ternary operator combo decompilation.
• Fixed a typo TempVarAssigmentStatement => TempVarAssignmentStatement.
• Resolved local variable problems causing slowdown with AM2R modding and other games.
• Change type resolution rules in ExpressionConstant.ToString().

General search and script improvements:

• Improved speed of search scripts.
  • Code searching can be accelerated even more by enabling the code caching feature in Settings.
• Optimized script progress updating.
• New "ClickableTextOutput" window allows clicking on the code names for the search scripts.
• Improved scripts error handling, including line numbers.
• Use of the main UI after Search script results is now allowed.
• Added support for Scripts and GlobalScripts in "DumpSpecificCode.csx".
• Truncated exception output in general.
• Added "SyncBinding()" for possibilty to add/remove game resources from another thread.

Bug Fixes:

• Old scripts are now backwards compatible.
• Fixed error where certain text causes hard crash of tool.
• Fixed crash when attempting to run a new game using temp run feature
• Fixed erroneous attempt to write to protected areas using ImportGraphics.
• Fixed bugs in "EnableDebug.csx".
• Fixed regex error in "ExecutionOrder.csx"
• Fixed "DeltaruneClearShaderData.csx" to mitigate crashes.
• Fixed long file name issues in scripts.
• Adding a code entry from the context menu no longer crashes the app.
• Fixed "Delete" in the context menu of code entries.

0.4.0.1

UndertaleModTool v0.4.0.1 has much better support for Deltarune Chapter 2.

Release 1 of 0.4.0

This version can load and save Deltarune Chapter 2 to disk successfully.