Prevent bundled song copy overwriting user songs

Normalize source/destination paths and skip copying when they resolve to the same directory. Only copy bundled .nbs files if the destination file is missing (never replace existing songs) and emit a debug message when skipping self-copies. Bumped macros version to 3.12.0-beta.5 and added a changelog entry describing the fix.

Author: OctoFlareDev

datafiles/Data/changelog.txt

@@ -1,3 +1,10 @@
+Changes in v3.12.0-beta.5 (2026.08.05):
+
+* Fixed bundled song copying deleting non-demo songs from the user-data Songs
+   directory during updates.
+
+
+
 Changes in v3.12.0-beta.4 (2026.08.05):
 
 * Added Litematica-compatible .nbt output to schematic and track export. This

scripts/copy_bundled_files/copy_bundled_files.gml

@@ -15,12 +15,32 @@ function copy_bundled_file(source, destination, nocopy=0) {
 }
 
 function copy_bundled_songs(source, destination) {
+	var source_path = string_replace_all(source, "\\", "/")
+	var destination_path = string_replace_all(destination, "\\", "/")
+	if (os_type == os_windows) {
+		source_path = string_lower(source_path)
+		destination_path = string_lower(destination_path)
+	}
+
+	// Newer runtimes can resolve working_directory to the save area. Never
+	// enumerate and copy a Songs directory onto itself.
+	if (source_path == destination_path) {
+		show_debug_message("Skipped bundled song copy because source and destination are the same directory.")
+		return
+	}
+
 	if (!directory_exists(destination)) directory_create(destination)
 
 	var song = file_find_first(source + "*.*", 0)
 	while (song != "") {
 		if (string_lower(filename_ext(song)) == ".nbs") {
-			copy_bundled_file(source + song, destination + song)
+			var source_song = source + song
+			var destination_song = destination + song
+
+			// GameMaker file searches can expose both bundled and saved files.
+			// Existing songs may contain user work, so bundled songs only fill
+			// missing destinations and are never allowed to replace them.
+			if (!file_exists(destination_song)) file_copy(source_song, destination_song)
 		}
 		song = file_find_next()
 	}

scripts/macros/macros.gml

@@ -1,7 +1,7 @@
 function macros() {
 #macro gm_runtime_version "2022.0.3 LTS"
 #macro version_date "2026.8.5"
-#macro version "3.12.0-beta.4"
+#macro version "3.12.0-beta.5"
 #macro is_prerelease 1 // remember to change to 0 in the release!
 #macro is_development 0 // the more frequent versions that are not on github (no auto update)
 #macro nbs_version 6