FF7/Battle/Battle Animation/Animation Script

From Final Fantasy Inside
< FF7‎ | Battle
Revision as of 21:29, 6 August 2014 by my_wiki>NFITC1 (Several more)

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
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.