EXTCMD
extcmd( string , [param1], [param2] )
Some of the commands accept parameters (shown as "param1" and "param2" above).
| Command Strings Simple | |
|---|---|
| "pause" | request the pause menu be opened |
| "reset" | request a cart reset |
| "go_back" | return to the previous cart if there is one |
| "label" | set cart label |
| "shutdown" | quit cartridge (from exported binary) |
| "folder" | open current working folder on the host operating system |
| "audio_rec" | start recording audio |
| "rec" | set .gif video start point (F8) |
| "rec_frames" | set video start point in frames mode |
| Command Strings with Parameters | param1 | param2 | |
|---|---|---|---|
| "screen" | save a screenshot (F6) | number, scaling factor | save location, 0 = desktop, 1 = current folder |
| "video" | save a .gif to desktop (F9) | number, scaling factor | save location, 0 = desktop, 1 = current folder |
| "audio_end" | save recorded audio to desktop (no supported from web) | save location, 0 = desktop, 1 = current folder | |
| "set_filename" | set the filename for screenshots / gifs / audio recordings | "filename" | |
| "set_title" | set the host window title | "title" | |
Here is an example of how to use extcmd() with appropriate parameters.
extcmd("video", 4 , 1)
This will record a .gif, with a scaling factor of 4 (512x512 pixels), and save to the currently opened carts folder (user data). Useful for adding an easy button in the game for players to save a gif of the last things that happened in your game without teaching players what keyboard buttons to press, or for players who aren't using a keyboard.
Images in this Guide by NerdyTeachers is licensed under CC BY-SA 4.0

2201
31 May 2025

