VBA Memory Watcher Manual

Watch Variables

1. Run VisualBoyAdvance (rerecording v19.3) and open the target game
2. Run VisualBoyAdvance memory watcher (vbawatch.exe)
3. Edit and reload watch settings, if needed (see Edit Settings)

Edit Settings

1. Open the setting file (vbawcnf1.txt, vbxwcnf1.txt, vbawcnf0.txt, or vbxwcnf0.txt) (press Enter key in watch window)
2. Edit the setting file (see Syntax)
3. Reload settings (press F5 key in watch window)

Functions

Key	Function
ESC	Close watcher
Enter	Edit settings (open vbawcnf1.txt or vbxwcnf1.txt with associated application)
Space	Edit settings (open vbawcnf0.txt or vbxwcnf0.txt with associated application)
F1	Open manual
F5	Reload watch settings

Comments

; ASM style comment
/*
C style
comment
*/
// C++ style comment

Variables

[ROM Name / ROM Id]

Address1,Type1,Name1
Address2,Type2,Name2
----
Address3,Type3,Name3

ROM Name / ROM Id

String for identifying ROM, which written in ROM header (example: "ZEROMISSIONE" or "BMXE")

Address

Memory address of a variable (example: "03001536")

Type

Size and type of a variable, "[1-4][s|u|x|b]" (example: "1u", "2s*", or "4x") (* specifies that the variable is big-endian)

Name

Name of a variable (up to 15 chars) (example: "X Velocity" or "Y Position")

----

Separator

Note: Supports only GBA ROMs

Other Settings

:Key:Value1:Value2:...

Key

Setting type

Value

Value to set

Key	Value	Description
watchmax	decimal	Maximum count of the variables to display
procmax	decimal	Maximum count of the processes to display
graph	[true|false]	Use graph feature
interval	decimal (milliseconds)	Interval to update values
singlerun	[true|false]	Disable the second run
alwaystop	[true|false]	Display watch window always on top
fastwait	[true|false]	Use precise timer (default:false)
priority	[idle|even-lower|lower|normal|higher|even-higher|realtime]	Priority of watch thread (default:idle)

Key	Value	Description
colbg	hex (rrggbb)	Background color
colplain	hex (rrggbb)	Text color
coladdr	hex (rrggbb)	Text color for variable address
colformat	hex (rrggbb)	Text color for variable type
colvalue	hex (rrggbb)	Text color for variable value
coldesc	hex (rrggbb)	Text color for variable description
colgraph	hex (rrggbb)	Graph color
colgraphbg	hex (rrggbb)	Graph background color
colrominfo	hex (rrggbb)	ROM info text color
fontsize	decimal (pt)	Font size
fontfamily	string	Font family (must be monospace font)

Key	Value	Description
target (vbawatch)	string (filename), hex (vbaBIOS address), hex (vbaWORKRAM address), hex (vbaIRAM address), hex (vbaIOMEM address), hex (vbaPALETTERAM address), hex (vbaVRAM address), hex (vbaOAM address), hex (vbaROM address)	Define new VBA (advanced)
target (vbxwatch)	string (filename), hex (gbMemoryMap address)	Define new VBA (advanced)