Optionally switch name and sequence number in screenshot filenames

Author: veger

changelog.txt

@@ -1,4 +1,9 @@
 ---------------------------------------------------------------------------------------------------
+Version: 2.2.1
+
+  Minor Features:
+    - Optionally switch name and sequence number in screenshot filenames (player settings).
+---------------------------------------------------------------------------------------------------
 Version: 2.2.0
 Date: 17-11-2025
   Features:

locale/en/locale.cfg

@@ -102,6 +102,7 @@ tlbe-take-screenshot=Take a screenshot
 
 [mod-setting-name]
 tlbe-save-folder=Save location
+tlbe-save-name-first=Save files have name prefixed
 tlbe-sequential-names=Sequential names
 tlbe-show-stats=Show camera status
 tlbe-use-interval=Use interval as speed setting
@@ -111,6 +112,7 @@ tlbe-save-format=Image format
 
 [mod-setting-description]
 tlbe-save-folder=Relative from 'User Data Directory'
+tlbe-save-name-first=When enabled, save files will have the camera name before the sequence number.
 tlbe-sequential-names=Use sequential numbering per camera for the screenshot numbers. When disabled, game ticks are used for screenshot numbering.
 tlbe-show-stats=This requires the Stats GUI mod to be loaded.
 tlbe-use-interval=Use intervals (between frames) instead of speed gain in the camera settings. When this setting is changed, reopen camera settings to update the UI.

scripts/config.lua

@@ -13,6 +13,7 @@ local Tracker = require("scripts.tracker")
 --- @field saveFolder string
 --- @field seedSubfolder boolean When true, the seed is used as an additional subfolder
 --- @field saveFormat string File format/extension of the screenshots
+--- @field saveNameFirst boolean When true, save files have the camera name before the sequence number
 --- @field sequentialNames boolean
 --- @field useInterval boolean When true, use interval (between frames) instead of speed gain
 --- @field noticeMaxZoom boolean When true the warning about the max zoom is already raised
@@ -47,6 +48,7 @@ function Config.reload(event)
 
     ---@diagnostic disable: assign-type-mismatch
     playerSettings.saveFolder = guiSettings["tlbe-save-folder"].value
+    playerSettings.saveNameFirst = guiSettings["tlbe-save-name-first"].value
     playerSettings.sequentialNames = guiSettings["tlbe-sequential-names"].value
     playerSettings.showCameraStatus = guiSettings["tlbe-show-stats"].value
     playerSettings.useInterval = guiSettings["tlbe-use-interval"].value

scripts/main.lua

@@ -166,25 +166,19 @@ function Main.takeScreenshot(player, playerSettings, camera, activeTracker, forc
     end
 
     local savePath
+    local basePath = string.format("%s/%s", playerSettings.saveFolder, camera.saveFolder)
+    local filename
+
+    if playerSettings.saveNameFirst then
+        filename = string.format("%s-%010d.%s", camera.saveName, screenshotNumber, playerSettings.saveFormat)
+    else
+        filename = string.format("%010d-%s.%s", screenshotNumber, camera.saveName, playerSettings.saveFormat)
+    end
+
     if playerSettings.seedSubfolder then
-        savePath = string.format(
-            "%s/%s/%d/%010d-%s.%s",
-            playerSettings.saveFolder,
-            camera.saveFolder,
-            game.default_map_gen_settings.seed,
-            screenshotNumber,
-            camera.saveName,
-            playerSettings.saveFormat
-        )
+        savePath = string.format("%s/%d/%s", basePath, game.default_map_gen_settings.seed, filename)
     else
-        savePath = string.format(
-            "%s/%s/%010d-%s.%s",
-            playerSettings.saveFolder,
-            camera.saveFolder,
-            screenshotNumber,
-            camera.saveName,
-            playerSettings.saveFormat
-        )
+        savePath = string.format("%s/%s", basePath, filename)
     end
 
     game.take_screenshot {

settings.lua

@@ -21,6 +21,13 @@ data:extend(
             default_value = true,
             order = "6"
         },
+        {
+            type = "bool-setting",
+            name = "tlbe-save-name-first",
+            setting_type = "runtime-per-user",
+            default_value = false,
+            order = "7"
+        },
         {
             type = "bool-setting",
             name = "tlbe-use-interval",