FF7/Battle/Battle Animation/Animation Script

This page contains information related to the AB animation files of battle models.

Any code less than 8Eh is treated as a raw animation index to be executed.

Code	Arguments	Effect
8E		Turns some flag on (Can only be executed once)
8F		Unsets whatever flag 8E sets
90	byte, word	Something specific for Emerald weapon's eyes.
91	byte
92		Suspend ATB (Cannot undo)
93		Fade whole screen to black (battle still continues)
94	word, word, byte	Rotate [word0 - word1] units in steps of [byte] (a unit is 360/4096 degrees)
95		Used for escaping
96	byte, byte	Barret's muzzle flash beginning in byte0 frames lasting for byte1 frames
97	byte, byte
98	byte	Displays action's name in [byte] frames
99	byte, word, word, byte	Used only by some of Yuffie's and Cid's Limit breaks?
9A	word, word	Unused, but same as FB
9B		Sets a flag that BD also sets (unknown effect)
9C		Sets min;max volume to 1;127
9D	byte (0-6 inclusive)	Something to do with Tifa's limits
9E		Pause here until all animation/damage handlers are finished.
9F		Unused to unset flag that 9B and BD set
A0	byte	Used by Carry Armor's Left Arm's 'Grab'
A1	byte, byte	Do [byte0?] at [byte1] frame intervals (byte1 definitely increases frequency of damage counter appearance during multi-hit actions)
A2	byte	Performs transformation a la Vincent's Limit Break set by AC and play animation script [byte] of new model
A3	byte	Looks like it should change effect volume to [byte]/128, but in practice seems to mute them.
A4		E.Skill charge effect (remains stationary on actor's position when called)
A5		Summon charge effect (remains stationary on actor's position when called)
A6		Return defending actor to original position (slightly different from FA)
A7	byte
A8	byte, byte	Wait for [byte0] frames then interpolate actor's current position back to original position in [byte1] frames
A9		Used in idle animations*
AA		Enables camera scripts.
AB	word, word	Move to position [word0, 0] relative to target of current action (word1 is ignored; used during "Cover")
AC	byte	Set character transformation to [byte]
AD	byte, word, byte, byte	Causes muzzle flashes, but not sure what the arguments mean
AE		Removes target from battle and resets some things
AF	byte	Used by Carry Armor's Right Arm's 'Grab'
B0		No noticeable effect while used in a script
B1		Almost identical to B0, still no effect
B2		Duplicate of C9; could be considered a NOP
B3		If actor does not have Small, loop until B2 is found (never used)
B4		If Back attack or Pincer attack, make actor face appropriate direction.
B5	word, word, word, byte, word, word	Only used by Mu and Trick Play. Something about positioning.
B6	byte	Pause camera scripts and play animation [byte] one time
B7		Forces Death Animation (actor is still present and can function)
B8
B9	byte	Run init battle cam script [byte]
BA	word	Forces idle rotation to [word0]?
BB		DUMMY; treated like animation script (might crash)
BC	byte	Set idle cam index to [byte]
BD	word, word
BE	byte	Queue sound to be played and target reaction in [byte] frames (for multiple strike actions [unless Frog status?])
BF	byte, byte
C0		DUMMY; treated like animation script (might crash)
C1		Unconditional "Jump to C9"
C2	byte	Queue damage display in [byte] frames (does not play sound)
C3
C4	word, byte	In each of the next [byte] frames, move [word] units along the X-axis
C5
C6	byte
C7	word, byte	Force enemy in relative formation position [word] to perform their [byte] animation script
C8	word, word, byte
C9		Jump destination
CA		While Magic thread is active, jump to C9
CB	byte, word, byte, byte, byte, byte, byte
CC	byte
CD		Jump Destination (CE only); DUMMY; treated like animation script (might crash)
CE	byte	If actor is enemy jump to CD
CF	word, word, word, byte, byte
D0	word, byte (0-7 inclusive)
D1	word, word, byte
D2		DUMMY; treated like animation script (might crash)
D3		DUMMY; treated like animation script (might crash)
D4	word, byte
D5	word, word, word, byte, byte
D6	byte
D7	byte, byte
D8	byte, word
D9		DUMMY; treated like animation script (might crash)
DA	byte
DB	word, byte, byte
DC	byte, word
DD	byte, byte
DE	byte, byte
DF
E0		Limit charge effect (remains stationary on actor's position when called)
E1
E2
E3
E4
E5		Reset actor's standing position
E6		Magic charge effect (remains stationary on actor's position when called)
E7	byte
E8		Choose magic thread handler?
E9	word, byte
EA		Display Action's name
EB
EC		Pause until active magic thread completes, then run action animation
ED
EE		Run Idle Animation script
EF		DUMMY; treated like animation script (might crash)
F0
F1
F2
F3		decrement wait time until 0, then continue script
F4	byte	Set wait period [byte] (frames?)
F5	byte
F6
F7	byte	Play sound effect, queue reaction, and display damage [byte] frames from this point
F8
F9
FA		Return actor to previous position
FB	word, word	Move to [word, word] position relative to target
FC		Effect depends on battle formation type
FD	word, word, word
FE	byte	If byte is C0h, End of script.
FF		Duplicate of EE

NOTES: A9 - This skips the next byte and causes it to play the animation in the byte afterwards before moving the script pointer to the third byte. It looks like this does some "clear state" action every time the idle script is executed, but the idle scripts all cause loops so this is executed after returning from any other animation. Most enemy idle scripts are

A9 C9 00 C1

while a few enemies and all playable character's idle scripts read

00 FE C0

They seem to translate to the same thing.