From def9e91d80be44d13fd5cf698ec7dd58b93c9bd0 Mon Sep 17 00:00:00 2001
From: Un1q32 <joey.t.reinhart@gmail.com>
Date: Tue, 30 Jun 2026 20:23:34 -0400
Subject: [PATCH 1/5] update readme

---
 README.md | 85 +++++++++++++++++++++++++++++++------------------------
 1 file changed, 48 insertions(+), 37 deletions(-)

diff --git a/README.md b/README.md
index 6ec1ff36..fa4e02b7 100644
--- a/README.md
+++ b/README.md
@@ -100,43 +100,54 @@ Then run Butterscotch with `./butterscotch /path/to/data.win`!
 
 ## CLI parameters
 
-The GLFW target has a lot of nifty CLI parameters that you can use to trace and debug games running on it.
-
-* `--debug`: Enables debugging hotkeys.
-* `--speed`: Speed multiplier.
-* `--fast-forward-speed`: Speed multiplier when pressing TAB (toggle).
-* `--widescreen-hack`: Forces a game to run in widescreen (example: `--widescreen-hack=16:9`).
-* `--screenshot=file_%d.png`: Screenshots the runner, requires `--screenshot-at-frame`.
-* `--screenshot-at-frame=Frame`: Screenshots the runner at a specific frame. Can be used multiple times.
-* `--screenshot-surfaces=file_%d.%d.png`: Screenshots all surfaces (framebuffers), requires `--screenshot-surfaces-at-frame`.
-* `--screenshot-surfaces-at-frame=Frame`: Screenshots all surfaces (framebuffers) at a specific frame. Can be used multiple times.
-* `--headless`: Runs the runner in headless mode. When running in headless mode, the game will run at the max speed that your system can handle.
-* `--trace-variable-reads`: Traces variable reads.
-* `--trace-variable-writes`: Traces variable writes.
-* `--trace-function-calls`: Traces function calls.
-* `--trace-alarms`: Traces alarms.
-* `--trace-instance-lifecycles`: Traces instance creations and deletions.
-* `--trace-events`: Traces events.
-* `--trace-event-inherited`: Traces event inherited calls.
-* `--trace-tiles`: Traces drawn tiles.
-* `--trace-collisions`: Traces collisions between instances.
-* `--trace-opcodes`: Traces opcodes.
-* `--trace-stack`: Traces stack.
-* `--trace-frames`: Logs when a frame starts and when a frame ends, including how much time it took to process each frame.
-* `--always-log-unknown-functions`: When enabled, Butterscotch will always log unknown functions instead of logging them once per script.
-* `--always-log-stubbed-functions`: When enabled, Butterscotch will always log stubbed functions instead of logging them once per script.
-* `--trace-bytecode-after-frame`: When set, controls when `--trace-opcodes` and `--trace-stack` will start logging. Useful when debugging interpreter-heavy scripts.
-* `--exit-at-frame=Frame`: Automatically exit the runner after X frames.
-* `--seed=Seed`: Sets a fixed seed for the runner, useful for reproduceable runs.
-* `--print-rooms`: Prints all rooms to the console, along with all objects present in the room.
-* `--print-declared-functions`: Prints all declared GML scripts by the game.
-* `--print-objects`: Prints all objects definitions of the game.
-* `--disassemble`: Dissassembles a specific script.
-* `--record-inputs`: Records user inputs.
-* `--playback-inputs`: Playbacks user inputs.
-* `--os-type`: Allows changing the built-in `os_type` value. The default is Windows. Example: When running Undertale Xbox, you would need to set it to `--os-type xboxone`.
-* `--profile-gml-scripts`: Logs which GML scripts are the heaviest in terms of time and executed instructions.
-* `--profile-opcodes`: Ranks which GML opcodes were executed the most.
+The desktop target has a lot of nifty CLI parameters that you can use to trace and debug games running on it.
+
+* --help                                 - Show this message
+* --screenshot <filename>                - Specify the filename for screenshots
+* --screenshot-at-frame <frame>          - Take a screenshot at the specified frame
+* --screenshot-surfaces <filename>       - Take a screenshot of all surfaces at the specified frame
+* --screenshot-surfaces-at-frame <frame> - Specify the filename for surface screenshots
+* --headless                             - Launch without a window
+* --print-rooms                          - Print all rooms in the game and exit
+* --print-objects                        - Print all objects in the game and exit
+* --print-shaders                        - Print all shaders in the game and exit
+* --print-declared-functions             - Print all declared functions in the game and exit
+* --print-unknown-functions              - Print all unknown functions used by the game and exit
+* --trace-variable-reads                 - Trace variable reads
+* --trace-variable-writes                - Trace variable writes
+* --trace-function-calls                 - Trace function calls
+* --trace-alarms                         - Trace alarms
+* --trace-instance-lifecycles            - Trace instance creations and deletions
+* --trace-events                         - Trace events
+* --trace-collisions                     - Trace collisions between instances
+* --trace-event-inherited                - Trace event inherited calls
+* --trace-tiles                          - Trace drawn tiles
+* --trace-opcodes                        - Trace opcodes
+* --trace-stack                          - Trace stack
+* --trace-frames                         - Log frametimes
+* --always-log-unknown-functions         - Always log unknown function calls instead of once per script
+* --always-log-stubbed-functions         - Always log stubbed function calls instead of once per script
+* --exit-at-frame <frame>                - Exit at the specified frame
+* --trace-bytecode-after-frame <frame>   - Delay stack and opcode tracing until the specified frame
+* --dump-frame <frame>                   - Dump the runner state at the specified frame
+* --dump-frame-json <frame>              - Dump the runner state in json at the specified frame
+* --dump-frame-json-file <file>          - Specify an output file for runner state dumps
+* --speed <speed>                        - Set a normal speed multiplier
+* --fast-forward-speed <speed>           - Set a fast-forward speed multiplier
+* --seed <seed>                          - Seed for the random number generator
+* --debug                                - Enable debug mode
+* --disassemble <script>                 - Disassemble the specified script and print to console (\* disassembles all)
+* --record-inputs <file>                 - Record all keyboard inputs to a file
+* --playback-inputs <file>               - Playback input from file
+* --renderer <renderer>                  - Set the rendering API
+* --lazy-rooms                           - Lazily load rooms, increases load times but reduces memory usage
+* --eager-room <rooms>                   - When --lazy-rooms is set, keep these rooms always in memory
+* --os-type <os>                         - Set the reported OS type
+* --window-size <dimentions>             - Set a custom window size
+* --widescreen-hack <aspect ratio>       - Set a custom aspect ratio
+* --profile-gml-scripts                  - Log which GML scripts are the heaviest in terms of time and executed instructions
+* --save-folder <directory>              - Set the directory will save files will be stored
+* --game-args <args>                     - Arguments to pass to the game
 
 ## Debug Features
 

From 330524a2b4cfc77ea66b745a8572f9638f588214 Mon Sep 17 00:00:00 2001
From: Un1q32 <joey.t.reinhart@gmail.com>
Date: Tue, 30 Jun 2026 20:24:38 -0400
Subject: [PATCH 2/5] add

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index fa4e02b7..bcfcbd3a 100644
--- a/README.md
+++ b/README.md
@@ -148,6 +148,7 @@ The desktop target has a lot of nifty CLI parameters that you can use to trace a
 * --profile-gml-scripts                  - Log which GML scripts are the heaviest in terms of time and executed instructions
 * --save-folder <directory>              - Set the directory will save files will be stored
 * --game-args <args>                     - Arguments to pass to the game
+* --profile-opcodes                      - Rank which GML opcodes were executed the most
 
 ## Debug Features
 

From 340dad60accb798bd5bdae1e225b1f9a4912d65c Mon Sep 17 00:00:00 2001
From: Un1q32 <joey.t.reinhart@gmail.com>
Date: Tue, 30 Jun 2026 23:32:20 -0400
Subject: [PATCH 3/5] how does this look

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index bcfcbd3a..153091e1 100644
--- a/README.md
+++ b/README.md
@@ -102,6 +102,7 @@ Then run Butterscotch with `./butterscotch /path/to/data.win`!
 
 The desktop target has a lot of nifty CLI parameters that you can use to trace and debug games running on it.
 
+```
 * --help                                 - Show this message
 * --screenshot <filename>                - Specify the filename for screenshots
 * --screenshot-at-frame <frame>          - Take a screenshot at the specified frame
@@ -149,6 +150,7 @@ The desktop target has a lot of nifty CLI parameters that you can use to trace a
 * --save-folder <directory>              - Set the directory will save files will be stored
 * --game-args <args>                     - Arguments to pass to the game
 * --profile-opcodes                      - Rank which GML opcodes were executed the most
+```
 
 ## Debug Features
 

From 8c17944da54a061aa941b2fbbf7f7bbe5f62905d Mon Sep 17 00:00:00 2001
From: Un1q32 <joey.t.reinhart@gmail.com>
Date: Tue, 30 Jun 2026 23:32:47 -0400
Subject: [PATCH 4/5] how does this loook

---
 README.md | 94 +++++++++++++++++++++++++++----------------------------
 1 file changed, 47 insertions(+), 47 deletions(-)

diff --git a/README.md b/README.md
index 153091e1..04476226 100644
--- a/README.md
+++ b/README.md
@@ -103,53 +103,53 @@ Then run Butterscotch with `./butterscotch /path/to/data.win`!
 The desktop target has a lot of nifty CLI parameters that you can use to trace and debug games running on it.
 
 ```
-* --help                                 - Show this message
-* --screenshot <filename>                - Specify the filename for screenshots
-* --screenshot-at-frame <frame>          - Take a screenshot at the specified frame
-* --screenshot-surfaces <filename>       - Take a screenshot of all surfaces at the specified frame
-* --screenshot-surfaces-at-frame <frame> - Specify the filename for surface screenshots
-* --headless                             - Launch without a window
-* --print-rooms                          - Print all rooms in the game and exit
-* --print-objects                        - Print all objects in the game and exit
-* --print-shaders                        - Print all shaders in the game and exit
-* --print-declared-functions             - Print all declared functions in the game and exit
-* --print-unknown-functions              - Print all unknown functions used by the game and exit
-* --trace-variable-reads                 - Trace variable reads
-* --trace-variable-writes                - Trace variable writes
-* --trace-function-calls                 - Trace function calls
-* --trace-alarms                         - Trace alarms
-* --trace-instance-lifecycles            - Trace instance creations and deletions
-* --trace-events                         - Trace events
-* --trace-collisions                     - Trace collisions between instances
-* --trace-event-inherited                - Trace event inherited calls
-* --trace-tiles                          - Trace drawn tiles
-* --trace-opcodes                        - Trace opcodes
-* --trace-stack                          - Trace stack
-* --trace-frames                         - Log frametimes
-* --always-log-unknown-functions         - Always log unknown function calls instead of once per script
-* --always-log-stubbed-functions         - Always log stubbed function calls instead of once per script
-* --exit-at-frame <frame>                - Exit at the specified frame
-* --trace-bytecode-after-frame <frame>   - Delay stack and opcode tracing until the specified frame
-* --dump-frame <frame>                   - Dump the runner state at the specified frame
-* --dump-frame-json <frame>              - Dump the runner state in json at the specified frame
-* --dump-frame-json-file <file>          - Specify an output file for runner state dumps
-* --speed <speed>                        - Set a normal speed multiplier
-* --fast-forward-speed <speed>           - Set a fast-forward speed multiplier
-* --seed <seed>                          - Seed for the random number generator
-* --debug                                - Enable debug mode
-* --disassemble <script>                 - Disassemble the specified script and print to console (\* disassembles all)
-* --record-inputs <file>                 - Record all keyboard inputs to a file
-* --playback-inputs <file>               - Playback input from file
-* --renderer <renderer>                  - Set the rendering API
-* --lazy-rooms                           - Lazily load rooms, increases load times but reduces memory usage
-* --eager-room <rooms>                   - When --lazy-rooms is set, keep these rooms always in memory
-* --os-type <os>                         - Set the reported OS type
-* --window-size <dimentions>             - Set a custom window size
-* --widescreen-hack <aspect ratio>       - Set a custom aspect ratio
-* --profile-gml-scripts                  - Log which GML scripts are the heaviest in terms of time and executed instructions
-* --save-folder <directory>              - Set the directory will save files will be stored
-* --game-args <args>                     - Arguments to pass to the game
-* --profile-opcodes                      - Rank which GML opcodes were executed the most
+--help                                 - Show this message
+--screenshot <filename>                - Specify the filename for screenshots
+--screenshot-at-frame <frame>          - Take a screenshot at the specified frame
+--screenshot-surfaces <filename>       - Take a screenshot of all surfaces at the specified frame
+--screenshot-surfaces-at-frame <frame> - Specify the filename for surface screenshots
+--headless                             - Launch without a window
+--print-rooms                          - Print all rooms in the game and exit
+--print-objects                        - Print all objects in the game and exit
+--print-shaders                        - Print all shaders in the game and exit
+--print-declared-functions             - Print all declared functions in the game and exit
+--print-unknown-functions              - Print all unknown functions used by the game and exit
+--trace-variable-reads                 - Trace variable reads
+--trace-variable-writes                - Trace variable writes
+--trace-function-calls                 - Trace function calls
+--trace-alarms                         - Trace alarms
+--trace-instance-lifecycles            - Trace instance creations and deletions
+--trace-events                         - Trace events
+--trace-collisions                     - Trace collisions between instances
+--trace-event-inherited                - Trace event inherited calls
+--trace-tiles                          - Trace drawn tiles
+--trace-opcodes                        - Trace opcodes
+--trace-stack                          - Trace stack
+--trace-frames                         - Log frametimes
+--always-log-unknown-functions         - Always log unknown function calls instead of once per script
+--always-log-stubbed-functions         - Always log stubbed function calls instead of once per script
+--exit-at-frame <frame>                - Exit at the specified frame
+--trace-bytecode-after-frame <frame>   - Delay stack and opcode tracing until the specified frame
+--dump-frame <frame>                   - Dump the runner state at the specified frame
+--dump-frame-json <frame>              - Dump the runner state in json at the specified frame
+--dump-frame-json-file <file>          - Specify an output file for runner state dumps
+--speed <speed>                        - Set a normal speed multiplier
+--fast-forward-speed <speed>           - Set a fast-forward speed multiplier
+--seed <seed>                          - Seed for the random number generator
+--debug                                - Enable debug mode
+--disassemble <script>                 - Disassemble the specified script and print to console (\* disassembles all)
+--record-inputs <file>                 - Record all keyboard inputs to a file
+--playback-inputs <file>               - Playback input from file
+--renderer <renderer>                  - Set the rendering API
+--lazy-rooms                           - Lazily load rooms, increases load times but reduces memory usage
+--eager-room <rooms>                   - When --lazy-rooms is set, keep these rooms always in memory
+--os-type <os>                         - Set the reported OS type
+--window-size <dimentions>             - Set a custom window size
+--widescreen-hack <aspect ratio>       - Set a custom aspect ratio
+--profile-gml-scripts                  - Log which GML scripts are the heaviest in terms of time and executed instructions
+--save-folder <directory>              - Set the directory will save files will be stored
+--game-args <args>                     - Arguments to pass to the game
+--profile-opcodes                      - Rank which GML opcodes were executed the most
 ```
 
 ## Debug Features

From d3febe587956089c614fa47eb3525e6fc73f99b9 Mon Sep 17 00:00:00 2001
From: Un1q32 <joey.t.reinhart@gmail.com>
Date: Wed, 1 Jul 2026 02:49:31 -0400
Subject: [PATCH 5/5] properly document missing options

---
 README.md          | 2 ++
 src/desktop/main.c | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 04476226..ef4d7e23 100644
--- a/README.md
+++ b/README.md
@@ -150,6 +150,8 @@ The desktop target has a lot of nifty CLI parameters that you can use to trace a
 --save-folder <directory>              - Set the directory will save files will be stored
 --game-args <args>                     - Arguments to pass to the game
 --profile-opcodes                      - Rank which GML opcodes were executed the most
+--lazy-textures                        - Load textures into VRAM on first use, improving startup times
+--load-type <type>                     - Specify how data.win is loaded, per-chunk or all at once
 ```
 
 ## Debug Features
diff --git a/src/desktop/main.c b/src/desktop/main.c
index 87502a0c..d7df47c1 100644
--- a/src/desktop/main.c
+++ b/src/desktop/main.c
@@ -392,6 +392,8 @@ static void printUsage(const char *argv0) {
         "    --profile-gml-scripts                  - Log which GML scripts are the heaviest in terms of time and executed instructions\n"
         "    --save-folder <directory>              - Set the directory will save files will be stored\n"
         "    --game-args <args>                     - Arguments to pass to the game\n"
+        "    --lazy-textures                        - Load textures into VRAM on first use, improving startup times\n"
+        "    --load-type <type>                     - Specify how data.win is loaded, per-chunk or all at once\n"
 #ifdef EABLE_VM_OPCODE_PROFILER
         "    --profile-opcodes                      - Rank which GML opcodes were executed the most\n"
 #endif