ECL-MONITOR
===========

http://gbc.zorbus.net
joonas.hirvonen@pp.inet.fi


ECL-Monitor is a tool for live monitoring ECL bytecode scripts and flags of a running Gold Box game.

See GBC.txt if not already familiar with Gold Box Companion.

For more info on ECL scripts, see the documentation of ECL-Tool (ECL_Tool.txt).


Usage:
- Use Gold Box Companion to configure wanted game. GBC does not need to be running after this.
- Start the game, begin the game.
- Start ECL-Monitor. If it finds the game in memory, it parses and displays the ECL script and flags.


When the info bar is green, the script is focused to the line where the script PC (program counter) currently is.
You can toggle the PC focus with F9 or by clicking the info bar / script.

ECL-Monitor automatically detects and handles a script change, even when PC focus is not on.

Flags can be changed by pressing F2 or by doubleclicking with the mouse when on a flag.

ECL code can be changed by pressing F2 or by doubleclicking a wanted line.
This is a tedious way to change anything but just command parameters, so for larger editing use a hex editor that can edit 
the memory of an application (in this case, DOSBox.exe).
You can copy the memory address of the current command to clipboard by pressing ENTER or by mouse rightclicking.

For a hex editor, see HxD: http://mh-nexus.de/en/hxd/.


F5 = force refresh (search for the game and ECL again).

CONTROL + F = search for a string. F3 to search again.

CONTROL + RIGHT ARROW = follow a GOTO/GOSUB/ON GOTO/ON GOSUB address.

CONTROL + LEFT ARROW = return to previous location if you followed a GOTO/GOSUB/...

