The Command Button allows you to create and run shell commands (other programs) from Tiled.
You may setup as many commands as you like. This is useful if you edit maps for multiple games and you want to set up a command for each game. Or you could setup multiple commands for the same game that load different checkpoints or configurations.
The ‘Edit Commands’ dialog contains a list of commands. Each command has several properties:
- The name of the command as it will be shown in the drop down list, so you can easily identify it.
- The executable to run. It should either be a full path or the name of an executable in the system PATH.
- The arguments for running the executable.
- Working directory
- The path to the working directory.
- A custom key sequence to trigger the command. You can use ‘Clear’ to reset the shortcut.
- Output in Debug Console
- If this is enabled, then the output (stdout and stderr) of this command will be displayed in the Debug Console. You can find the Debug Console in View > Views and Toolbars > Debug Console.
- Save map before executing
- If this is enabled, then the current map will be saved before executing the command.
- A quick way to disable commands and remove them from the drop down list. The default command is the first enabled command.
Note that if the executable or any of its arguments contain spaces, these parts need to be quoted.
In the executable, arguments and working directory fields, you can use the following variables:
- the full path of the current file (either map or tileset).
- the path in which the current file is located.
- the path in which the current project is located.
- the type of the currently selected object, if any.
- the ID of the currently selected object, if any.
- the name of the currently selected layer.
For the working directory field, you can additionally use the following variable:
- the path to the executable.
Launching a custom game called “mygame” with a -loadmap parameter and the mapfile:
mygame -loadmap %mapfile
On Mac, remember that Apps are folders, so you need to run the actual
executable from within the
open (and note the quotes since one of the arguments contains
open -a "/Applications/CoronaSDK/Corona Simulator.app" /Users/user/Desktop/project/main.lua
Some systems also have a command to open files in the appropriate program:
- GNOME systems like Ubuntu:
- FreeDesktop.org standard: