Configuration

The primary way to configure JACE is via the config window, available by pressing the F4 key.  From here you can see the entire emulator structure on the left.  By clicking on one of the emulator objects, you can alter its properties.  For example, if you click on "Computer (Apple //e)" you can change what "cards" are inserted into each slot.  When you click Apply, the emulator processes all of your changes and updates the config screen, as well as the internals of the emulator while it's running!  If you switch cards, you must click Apply before the cards themselves will be configurable in the config window.

Remember, any changes you make to the configuration have to be applied before they can take effect.  So, for example, if you are using the cheat feature with Prince of Persia you may want to consider leaving the configuration window open so you can quickly make changes and apply them without getting too distracted from your... ahem... fun.  

Another very common scenario is inserting disk images.  By clicking on "Disk ][ Controller (Slot 6)" you can select what disk images you want to use for Drive 1 and Drive 2.  If you have a Disk ][ Controller inserted into slot 6, you can also use F1 and F2 to swap disks without opening the configuration screen.  Likewise, if you have a Mass Storage device (for hard drive or 800kb floppy emulation) in slot 7, you can swap S7 disk 1 by pressing F3.  Lastly, if you press F5, you can load a binary file and execute it directly.  It must be named as such: "filename#06xxxx" where xxxx is the hexadecimal location in memory to load and start the program. 

If you save changes in the configuration screen, the emulator will start with the same settings (including disk images) the next time you launch the program.  However, if you use hot-keys to change disk images those settings will not be saved.

Command-line usage:

You can also configure JACE from the commandline using the following syntax:

java -jar jace.jar -option value -option value ... where option is any of the following options (it is NOT case sensitive, by the way) and value fits the criteria described in the value column below. T/F values are assumed to be true if left blank, and also true/false are not case sensitive values either.  The option MUST start with the hyphen (dash) character otherwise JACE will think you've misplaced a value argument.  The following is an example of how to start the 3-disk version of Prince of Persia using joystick emulation (arrow keys) and the "hog" feature so that PoP doesn't misinterpret arrow keys as CTRL+J and CTRL+K.

java -jar jace.jar -computer.s6card disk -s6.d1 ~/Documents/pop1.dsk -s6.d2 ~/Documents/pop3.dsk -joy0.enabled -joy0.usekeys -joy0.hog