Groovie/T7G/Opcodes

Opcodes

NB: This list is not fully up-to-date. The source code contains the most recent version.

The first bit of each opcode is special (it sets "firstbit"), and removed before the opcode is read (e.g. 0x8A in the script is a call to opcode 0x0A).

In the executable, the script is read in and 1 subtracted from it, so in assembly language they appear to start at 0x00.

Meaning of the Imp? column: "y" means opcode fully implemented, "." means stub present, " " means correct number of script bytes skipped, "###" means none of the above). This column is now very out-of-date.

Opcode	Arguments (bytes)	Arguments (description)	Detail	Imp?
0x01	0	None	NOP: Does nothing	y
0x02	2	1 x 16bit	Load an xmi file from a GJD, using reference given in argument, and start sequencer	.
0x03	0	None	Turn on bit 9 of bitflags	y
0x04	0	None	Palette fade out	y
0x05	0	None	Turn on bit 8 of bitflags (Show first frame)	y
0x06	0	None	Turn on bit 6 of bitflags	y
0x07	0	None	Turn on bit 7 of bitflags (just audio?)	y
0x08	2	1 x 16bit	??? Set arg1 as the "loop" file to play when current xmidi file finished ??? (arg1 is definitely a reference to an xmidi file)	.
0x09	2	1 x 16bit	Play VDX file from a 16bit reference number. Does various things beforehand, depending on arg1 (needs a separate wiki page really...)	.
0x0A	0	None	Turn on bit 5 of bitflags (skip still frames?)	y
0x0B	0	None	Start the input loop	y
0x0C	3	1 x 8bit, 1 x 16bit	If the character pressed in the keyboard matches the first argument, does something	.
0x0D	11	5 x 16bit, 1 x 8bit	Mark the rectangle specified by arg1-arg4 as clickable: change the cursor to arg6 if hovering, and go to the address in arg5 if clicked.	y
0x0E	2	1 x 16bit	Mark the leftmost 100 pixels of game area as clickable: change the cursor to 1 if hovering, and go to the address in the first parameter if clicked.	y
0x0F	2	1 x 16bit	Mark the rightmost 100 pixels of game area as clickable: change the cursor to 2 if hovering, and go to the address in the first parameter if clicked.	y
0x10	2	1 x 16bit	Mark the centremost 240 pixels of game area as clickable: change the cursor to 0 if hovering, and go to the address in the first parameter if clicked.	y
0x11	2	1 x 16bit	(Same call as 0x10)	y
0x12	2	1 x 16bit	Mark the current position as clickable: change the cursor to 0, and go to the address in the parameter if clicked.	y
0x13	0	None	End the input loop - wait for mouse/keyboard input	y
0x14	3 (or 2)	1 x 16bit, 1 x 8bit (or 2 x 8bit)	??? Load a random number (up to a max value of arg2) into var1 ???	y
0x15	2	1 x 16bit	JMP: Jump to the address specified in the argument	y
0x16	Varies	1 x 16bit (or 1 x 8bit, depending on firstbit), n x 8bit	Reads a string into the script variable specified in the first 2 (or 1) bytes	y
0x17	1	1 x 8bit	RET: Returns from function, saving the return value to var 0x102	y
0x18	2	1 x 16bit	CALL: Calls function in argument	y
0x19	2	1 x 16bit	Sleep for arg x 3 milliseconds	y
0x1A	Varies	1 x 16bit (or 1 x 8bit, dependent on firstbit), n x 8bit, 1 x 16bit	Strcmp then JMP: Compares the string at script variable given in first argument (8bit if firstbit is set, otherwise 16bit) with the string that follows in script (terminated by a character with the firstbit set). If not the same, jump to address in argument following string	y
0x1B	Varies	1 x 16bit (or 1 x 8bit), n x 8bit	Obfuscate: Applies XOR to the array of variables that begins in var1 with the following script bytes until one of these bytes has bit 0x80 set	y
0x1C	2	1 x 16bit	Set bit 1, clear bit 7, set bit 2 if firstbit set. Play VDX
0x1D	4 (or 3, dependent on firstbit)	2 x 16bit (or 1 x 8bit, 1 x 16bit)	Swap the values of two script variables	y
0x1E	1	1 x 8bit	NOP: Does nothing	y
0x1F	2 (or 1)	1 x 16bit (or 1 x 8bit)	INC: Unary increment of a script variable pointed by the argument (8bit if firstbit is set, otherwise 16bit)	y
0x20	2 (or 1)	1 x 16bit (or 1 x 8bit)	DEC: Unary decrement of a script variable pointed by the argument (8bit if firstbit is set, otherwise 16bit)	y
0x21	Varies	Varies	Calls [AwkwardFunction awkward function]	###
0x22	0	None	Copy the back buffer to the front buffer	y
0x23	Varies	1 x 16bit (or 1 x 8bit, dependent on firstbit), n x 8bit, 1 x 16bit	Strcmp then JMP: same as 0x1A, but jumps on equal rather than not equal	y
0x24	4 (or 3)	2 x 16bit (or 1 x 8bit, 1 x 16bit)	MOV: Stores the value of the second variable to the first one: var2 = var1	y
0x25	4 (or 3)	2 x 16bit (or 1 x 8bit, 1 x 16bit)	ADD: Adds the value of the second variable to the first one	y
0x26	Varies	Varies	Calls the other [AwkwardFunction awkward function] to get a VDX file name, finds it and plays it	y
0x27	Varies	Varies	Turns on bit 1 of bitflags (and bit 2 if firstbit is set). VDX file name (in a .gjd) follows: find it, then play it	y
0x28	2	1 x 16bit	NOP: Does nothing	y
0x29	0	None	Stops the MIDI playback	.
0x2A	0	None	End script	.
0x2B	0	None	NOP: Does nothing (same call as 0x54)	y
0x2C	3	1 x 16bit, 1 x 8bit	Sets the action (arg1) and cursor (arg2) for the top hotspot	y
0x2D	3	1 x 16bit, 1 x 8bit	Sets the action (arg1) and cursor (arg2) for the bottom hotspot	y
0x2E	2 (or 1)	1 x 16bit (or 1 x 8bit)	Load game, getting number of load slot from the script variable in the argument	.
0x2F	2 (or 1)	1 x 16bit (or 1 x 8bit)	Save game, getting number of save slot from the script variable in the argument	.
0x30	2	1 x 16bit	Mark the 80 pixels under the game area as clickable: change the cursor to 4 if hovering, and go to the address in the first parameter if clicked.	.
0x31	4	2 x 16bit	Sets the MIDI volume. Stops the MIDI playback if the first argument is 0 (volume = 0?)
0x32	6 (or 5)	3 x 16bit (or 1 x 8bit, 2 x 16bit)	JNE: Jumps to the address of the third argument when *(var1 - 0x31) != var2	y
0x33	Varies	1 x 16bit (or 1 x 8bit, depending on firstbit), n x 8bit	Reads a string into the script variable number in the script variable specified in the first 2 (or 1) bytes	###
0x34	Varies	1 x 16bit (or 1 x 8bit, depending on firstbit), n x 8bit, 1 x 16bit	Check character (in second argument) to see if it's greater than the one in the indicated script variable (in first argument) (NB: if first bit of this char is not set, keep testing additional chars until it is (any match produces a positive result)). On positive, jump to address in final argument.	y
0x35	0	None	Turn off bit 7 of bitflags (just audio?)	y
0x36	Varies	1 x 16bit (or 1 x 8bit, depending on firstbit), n x 8bit, 1 x 16bit	Check character (in second argument) to see if it's less than the one in the indicated script variable (in first argument) (NB: if first bit of this char is not set, keep testing additional chars until it is (any match produces a positive result)). On positive, jump to address in final argument.	y
0x37	8	4 x 16bit	Copy rectangle from the game area into the screen	y
0x38	0	None	Re-load stored stack pointer	.
0x39	Varies	n x 8bit	Obscure swap: swap two script variables, addresses found by (arg1 - 0x30) * 10 + arg2 - 0x30 (and similar with arg3 & 4). Note that if one of the args is 0x23, then instead use the next byte of script - 0x61 as a script variable and use that (without subtracting 0x30)	y
0x3A	Varies	n x 8bit	Print out string (NB: not null terminated, but "null first bit" terminated)	###
0x3B	12	1 x 8bit, 5 x 16bit, 1 x 8bit	If within specified rectangle, get name of saved game, print it out (using sphinx.fnt). arg1 = save game number, arg2-5 = rectangle, arg6 = address to jump if clicked, arg7 = mouse pointer to use. Name of save game stored as first 15bytes of the file, minus 0x30.	.
0x3C	0	None	Check which savegames are valid (i.e. the file opens for reading), store boolean results in script variables 0x001 to 0x00A, and number of valid files in 0x104	y
0x3D	0	None	Reset script variables 0x000-0x0FF to zero	y
0x3E	3 (or 2, dependent on firstbit)	1 x 16bit, 1 x 8bit (or 2 x 8bit)	Performs var1 %= arg2	y
0x3F	variable	String	Load a script (just 1 sub-script is allowed). The filename is specified as a 0 ended character array	y
0x40	4	2 x 16bit	Two arguments are screen offset for VDX player	y
0x41	4 (or 3, dependent on firstbit)	2 x 16bit (or 1 x 8bit, 1 x 16bit)	SUB: Perform var1 -= var2.	y
0x42	1	1 x 8bit	Calculate a move in the microscope puzzle
0x43	1	1 x 8bit	Unloads the sub-script, returns to the main one. The argument number is saved as the script variable 0x102	y
0x44	2	1 x 16bit	Sets the action (arg1) for the right hotspot	y
0x45	2	1 x 16bit	Sets the action (arg1) for the left hotspot	y
0x46	0	None	NOP: Does nothing	y
0x47	0	None	NOP: Does nothing	y
0x48	1	1 x 8bit	NOP: Does nothing	y
0x49	0	None	NOP: Does nothing	y
0x4A	2	1 x 16bit	NOP: Does nothing	y
0x4B	1	1 x 8bit	NOP: Does nothing	y
0x4C	0	None	Saves the current CD (1/2/-1 if none) in variable 0x106	y
0x4D	1	1 x 8bit	If arg1 == 2 play vielogo, and stop sequencer & play CD	.
0x4E	2	1 x 16bit	NOP: Does nothing	y
0x4F	2	1 x 16bit	NOP: Does nothing	y
0x50	2	1 x 16bit	NOP: Does nothing	y
0x51	2	1 x 16bit	NOP: Does nothing (Loads argument into memory but it's unused)	y
0x52	1	1 x 8bit	Do loads with game area, dirty regions, palette (argument seemingly discarded)
0x53	10	5 x 16bit	Load arg5 if cursor is within rectangle specified by arg1-4	.
0x54	0	None	NOP: Does nothing (same call as 0x2B)	y
0x55	2	1 x 16bit	NOP: Does nothing (Loads argument into memory but it's unused)	y
0x56	6	1 x 32bit, 2 x 8bit	NOP: Does nothing	y
0x57	4	1 x 32bit	Turn on bit 5 of bitflags (skip still frames?), then lots more
0x58	Varies	Varies	Calls the other [AwkwardFunction awkward function]
0x59	3 (or two, dependent on firstbit)	1 x 16bit, 1 x 8bit (or 2 x 8bit)	NOP: Does nothing	y