User scripts will be executed similar to bash or console commands. You can run any compiler and / or emulator in the same way you would do when calling these tools from the console or a batch file.
You can define several actions that should be executed. Use multiple lines in your script to define multiple actions.
To add a new script, simply change the script name (in the related text field). Once you changed the script name, the apply-button's text will change to Add script. Edit the script in the text area below and add the script by clicking on the button.
If you press the New Script button, all fields will be cleared and you can enter script name and script lines.
To change or update an existing script, simply select the script from the dropdown list, but do not change the script name (in the related text field). Edit the script in the text area below and save the changes by clicking on the button Update script.
To specifiy directories or input and output files, there are following constants that should be used:
Note 1: In some cases you may have to add the "open" command to the command line (e.g., on OS X, starting Vice will throw an access denied error without the open-parameter). See examples below.
Note 2: If you specify full pathes to your compiler or emulator and the path contains whitechars (spaces), you need to set the path in quotes (see examples below). Placeholders like SOURCEFILE or OUTFILE, however, will be automatically quoted if necessary. You don't need to quote the placeholders.
Note 3: To make use of the START placeholder, you have to specify the start address in
a comment line with following syntax:
<comment sign> start=<start address>, for instance:
// start=$c000 (for Kick Assembler)
; start=12288 (for ACME)
You can drag & drop executables from compilers, crunchers and emulators from the explorer (or file browser) window onto the script text field. Relaunch64 will then automatically generate a proper scriptline, including recommended parameter settings (in case the compiler, cruncher or emulator is recognized and supported).