Changes

Jump to navigation Jump to search

FF8/Variables

6,679 bytes added, 00:06, 20 July 2019
no edit summary
== Standard MIDI File (SMF) Format ==By [[User:Shard|Shard]].
Game variables can be accessed using the PSHM family of script functions, and can be written to by using the POPM family of functions. Which one you use depends on the size of the variable.The <B>Standard MIDI File</B> variables are all stored in save files, with the save block starting at address 0xD10 on uncompressed PC saves. The parameter to access a variable in the game scripts is basically the offset from this point in the variable block. For example, getting main story progress (SMFword 256, which is word 0x100 in hex) just gets the two bytes starting at address 0xD10 + 0x100 = 0xE10. The varmap is continuous in memory while the game is a file format used to store MIDI data running as well. In the en-US version of the original and SE releases (plus someand likely most other kinds of data typically needed by a sequencerversions), the varblock begins at 0x18fe9b8. You can use [https://www.mediafire.com/?ucolf65ewq1yoty|this Cheat Engine table] to track them as you play.
This format stores the standard MIDI messages Items in grey are unused by field scripts (ie, status bytes with appropriate data bytes)plus a time-stamp for each message (ie, a series some of bytes that represent how many clock pulsesto wait before "playing" the eventthem may be used in battle scripts). The format also allows saving information about tempo,time and key signatures, the names of tracks and patterns, and other information typicallyneeded by a sequencer. One SMF can store information for numerous patterns and tracks so that anysequencer can preserve these structures when loading the file.
<B><FONT COLOR{| class=RED>NOTE"wikitable"|-! Var type! Var Number! Description|-! Byte| 0-3| unused in fields (always "FF-8")|-! Long| 4| Steps (used to generate random encounters)|-! Long| 8| Payslip|-! Byte| 12-15| unused in fields|-! Signed Word| 16| SeeD rank points?|-! Byte| 18-19| unused in fields|-! Long| 20| Battles won. (Fun fact:this affects the basketball shot in Trabia.)|-! Byte| 24-25| unused in fields|-! Word| 26| Battles escaped.|-! Word| 28| Enemies killed by Squall|-! Word| 30| Enemies killed by Zell|-! Word| 32| Enemies killed by Irvine|-! Word| 34| Enemies killed by Quistis|-! Word| 36| Enemies killed by Rinoa|-! Word| 38| Enemies killed by Selphie|-! Word| 40| Enemies killed by Seifer|-! Word| 42| Enemies killed by Edea|-! Word| 44| Squall death count|-! Word| 46| Zell death count|-! Word| 48| Irvine death count|-! Word| 50| Quistis death count|-! Word| 52| Rinoa death count|-! Word| 54| Selphie death count|-! Word| 56| Seifer death count|-! Word| 58| Edea death count|-! Byte| 60-67| unused in fields|-! Long| 68| Enemies killed|-! Long| 72| Amount of Gil the party currently has|-! Long| 76| Amount of Gil Laguna's party has|-! Long| 80| Counts the number of frames since the current movie started playing.|-! Word| 84| Last area visited.|-! Signed Byte| 86| Current car rent.|-! Signed Byte| 87| Built-in engine variable. No idea what it does. Scripts always check if it's equal to 0 or 10. Related to music.|-! Signed Byte| 88| Built-in engine variable. Used exclusively on save points. Never written to with field scripts. Related to Siren's Move-Find ability.|-! Byte| 89-103| unused in fields|-! Long| 104| Seems related to SARALYDISPON/SARALYON/MUSICLOAD/PHSPOWER opcodes|-! Long| 108| Music related|-! Long| 112| unused in fields|-! Byte| 116-147| Draw points in field|-! Byte| 148-179| Draw points in worldmap|-! Byte| 180-255| unused in fields|-! Word| 256| Main Story quest progress.|-! Byte| 258| not investigated|-! Byte| 259-260| unused in fields|-! Byte| 261| not investigated|-! Byte| 262-263| unused in fields|-! Byte| 264| not investigated|-! Byte| 265| not investigated|-! Byte| 266| World map version? (3=Esthar locations unlocked)|-! Byte| 267| unused in fields|-! Byte| 268| not investigated|-! Byte| 269| not investigated|-! Byte| 270| not investigated|-! Byte| 271| unused in fields|-! Byte| 272-299| SO MANY F***ING CARD GAME VARIABLES|-! Byte| 300| Card Queen re-cards.|-! Byte| 301-303| unused in fields|-! Byte| 304-305| Timber Maniacs issues found.|-! Byte| 306-319| Reserved for Hacktuar / FF8Voice|-! Byte| 320-332| Ultimecia Gallery related (pictures viewed?)|-! Byte| 333| Ultimecia Armory chest flags|-! Byte| 334| Ultimecia Castle seals. See [[FF8/Field/Script/Opcodes/159_SEALEDOFF|SEALEDOFF]] for details.|-! Byte| 335| Card related|-! Byte| 336| Deling City bus related|-! Byte| 338-340| Deling Sewer gates opened|-! Byte| 341| Does lots of things.</FONTsub>5</Bsub> A <|-! Byte| 342| Deling City bus system|-! Byte| 343| G-Garden door/event flags.|-! Byte| 344| B>-Garden / G-Garden event flags (during GvG)|-! Byte| 345| G-Garden door/event flags.|-! Byte| 346-349| FH Instrument (346 Zell, 347 Irvine, 348 Selphie, 349 Quistis)|-! Word| 350-356| Health Bars (Garden mech fight)|-! Byte| 358| Space station talk flags, Centra ruins related (beat odin?).|-! Byte| 359| Centra ruins related (beat odin?).|-! Long| 360| Choice of FH music.|-! Byte| 364-368| Randomly generated code for Centra Ruins.|-! Byte| 369-370| Ultimecia Castle flags|-! Byte| 371| unused in fields|-! Byte| 372-376| Ultimecia boss/timer/item flags|-! Byte| 377| Ultimecia organ note controller|-! Byte| 378| Centra Ruins timer (controls blackout messages from Odin)|-! Byte| 379| unused in fields|-! Word| 380| Squall health during mech fight.|-! Byte| 382-383| unused in fields|-! Byte| 384| Something about Laguna's time periods and GFs.|-! Byte| 385| Laguna dialogue in pub. Only the +2 bit is ever set. Don't change the +1 bit.|-! Byte| 387| Winhill progress?|-! Byte| 388| Timber Maniacs HQ talk flags (main lobby)|-! Byte| 389| Timber Maniacs HQ talk flags (office room)|-! Byte| 390| Edea talk flags at her house|-! Byte| 391| Laguna talk flags (in his office, disc 3)|-! Byte| 392| unknown (used in Edea's house and in the Balamb Garden computer system)|-! Byte| 393-399| unused in fields|-! Long| 400 and 404| Related to monsters killed in Winhill, but I don't think it actually does anything. Will investigate.|-! Byte| 408| unused in fields|-! Byte| 409| Balamb Garden computer system|-! Byte| 410-431| unused in fields|-! Byte| 432| BG Main hall flags|-! Byte| 433| Flags. Switches are assigned all over BG. No idea what any of them control.|-! Byte| 434| Flags. Switches are assigned all over BG. No idea what any of them control.|-! Byte| 435| Flags. Switches are assigned all over BG. No idea what any of them control.|-! Byte| 436| Moomba friendship level in the prison? Some actions cause these flags to be set.|-! Byte| 437| In BG on Disc 2, keeps track<of who's in your party. In the prison, it's the current floor you're on.|-! Byte| 438| Cid vs Norg event flags|-! Byte| 439| Cid vs Norg event flags|-! Byte| 440| Event flags. (+1 Quad ambush, +2 quad item giver, +4/+8 Infirmary helped, +16 Nida, +64 Kadowaki Elixir, +128 Training center)|-! Byte| 441| Cid vs Norg event flags|-! Byte| 442| Rinoa Garden tour flags|-! Word| 443| Zell Health in Prison (Hacktuar)|-! Byte| 445-447| Propagator defeated flags|-! Word| 448| Unknown|-! Byte| 450-451| Various magazine/B> usually is analogous talk flags|-! Byte| 452| Lunatic Pandora areas visited?|-! Byte| 453-455| Moomba teleport variables|-! Byte| 456-457| unused in fields|-! Byte| 458-459| Used with MUSICSKIP in some Balamb Garden areas|-! Byte| 460| Random flags (some used for Card Club)|-! Byte| 461-473| unused in fields|-! Byte| 474| Random flags (some used for Card Club)|-! Byte| 475-478| CC Group variables|-! Byte| 479| If set to one musical part0,disables all random battles during area loading.|-! Byte| 480| State of students in classroom (what they're doing).|-! Bytesuch as | 481| Controls a Trumpet partconversation in the cafeteria.|-! Signed Word| 482| Error ratio of missiles|-! Byte| 484| Missile Base progression?|-! Byte| 485| ToUK Progression (initially 0b111010101, +2 on finish quest. No other pops)|-! Byte| 486| ToUK room? (used to control map jumps in the maze)|-! Byte| 487| Missile base progression (also does something in BG2F classroom)|-! Byte| 488| Alternate Party Flags. Irvine +1/+16, Quistis +2/+32, Rinoa +4/+64, Zell +8/+128. A <Bsub>pattern1</Bsub> would be analogous to all |-! Byte| 489| Random talk flags?|-! Byte| 490| Cafeteria cutscene|-! Byte| 491| ToUK stuff|-! Byte| 492| I think this is a door opener for the missile base if you choose a short time limit.|-! Byte| 493| Missile base timer related?|-! Byte| 494-527| unused in fields|-! Signed Word| 528| Sub-story progression (it's a progression variable for individual segments of the musical parts game)|-! Byte| 530| X-ATM related (defeated it in battle?)|-! Byte| 531| Functionally unused. Read from at dollet, only manipulated in debug rooms.|-! Byte| 532| Controls footstep sounds at dollet (sand to concrete)|-! Byte| 533| not investigated|-! Byte| 534| not investigated|-! Byte| 535| not investigated|-! Byte| 536| not investigated|-! Byte| 537| not investigated|-! Byte| 538| not investigated|-! Byte| 539| not investigated|-! Byte| 540-591| unused in fields|-! Byte| 592-593| Seems to control angles and character facing.|-! Byte| 594| unused in fields|-! Byte| 595| not investigated|-! Byte| 596| not investigated|-! Byte| 597| not investigated|-! Byte| 598| not investigated|-! Byte| 599| not investigated|-! Byte| 600| not investigated|-! Byte| 601| not investigated|-! Byte| 602| not investigated|-! Byte| 603| not investigated|-! Byte| 604| not investigated|-! Byte| 605| not investigated|-! Byte| 606| not investigated|-! Byte| 607| not investigated|-! Byte| 608| not investigated|-! Byte| 609| not investigated|-! Byte| 610| not investigated|-! Byte| 611| not investigated|-! Byte| 612| not investigated|-! Byte| 613| not investigated|-! Byte| 614| not investigated|-! Byte| 615| not investigated|-! Byte| 616| not investigated|-! Byte| 617| not investigated|-! Byte| 618| not investigated|-! Byte| 619| not investigated|-! Byte| 620| not investigated|-! Byte| 621| not investigated|-! Byte| 622| not investigated|-! Byte| 623| not investigated|-! Byte| 624| not investigated|-! Byte| 625| Balamb visited flags (+8 Zell's room)|-! Byte| 626| not investigated|-! Byte| 627| not investigated|-! Byte| 628| unused in fields|-! Byte| 629| not investigated|-! Byte| 630| not investigated|-! Byte| 631| not investigated|-! Byte| 632| not investigated|-! Byte| 633| not investigated|-! Word| 634| not investigated|-! Byte| 636| not investigated|-! Byte| 637| unused in fields|-! Byte| 638| not investigated|-! Byte| 639| unused in fields|-! Byte| 640| not investigated|-! Byte| 641| not investigated|-! Byte| 642| not investigated|-! Byte| 643| not investigated|-! Byte| 644| not investigated|-! Byte| 645| not investigated|-! Byte| 646| not investigated|-! Byte| 647| not investigated|-! Byte| 648| not investigated|-! Byte| 649| not investigated|-! Byte| 650-655| unused in fields|-! Word| 656| not investigated|-! Byte| 658| not investigated|-! Byte| 659| not investigated|-! Byte| 660| not investigated|-! Byte| 661| not investigated|-! Byte| 662| not investigated|-! Byte| 663| not investigated|-! Byte| 664| not investigated|-! Byte| 665| not investigated|-! Word| 666| not investigated|-! Byte| 668| not investigated|-! Byte| 669-671| unused in fields|-! Word| 672| not investigated|-! Byte| 674| unused in fields|-! Byte| 675| not investigated|-! Byte| 676| unused in fields|-! Byte| 677| not investigated|-! Byte| 678| not investigated|-! Byte| 679| unused in fields|-! Byte| 680| not investigated|-! Byte| 681| not investigated|-! Byte| 682| not investigated|-! Byte| 683| not investigated|-! Byte| 684| not investigated|-! Byte| 685| not investigated|-! Byte| 686| not investigated|-! Byte| 687| not investigated|-! Byte| 688| not investigated|-! Byte| 689| not investigated|-! Byte| 690| not investigated|-! Byte| 691| not investigated|-! Byte| 692-719| unused in fields|-! Byte| 720| Squall's costume (0=normal, 1=student, 2=SeeD, 3=Bandage on forehead)|-! Byte| 721| Zell's Costume (ie0=normal, 1=student,2=SeeD)|-! ByteTrumpet| 722| Selphie's costume (0=normal, Drums1=student, Piano2=SeeD)|-! Byte| 723| Quistis' Costume (0=normal, etc1=SeeD) |-! Word| 724| Dollet mission time|-! Word| 726| not investigated|-! Byte| 728| Does lots of things.<sub>3</sub>|-! Byte| 729| not investigated|-! Byte| 730| Flags (+1 Joined Garden Festival Committee, +4 Gave Selphie tour of BG, +16 Kadowaki asks for one songCid, +32 and +64 Tomb of Unknown Kind hints?, +128 Beat all card people?)|-! Byte| 731| unused in fields|-! Word| 732| not investigated|-! Byte| 734| Split Party Flags (+1 Zell, +2 Irvine, +4 Rinoa, +8 Quistis, +16 Selphie).<sub>2</sub>|-! Byte| 735| not investigated|-! Byte| 736-751| unused in fields|-! Byte| 752| not investigated|-! Byte| 753-1023| unused in fields|-! Byte| Above 1023| Temporary variables used pretty much everywhere.|}
The format was designed to be generic so that the most important data can be read by all= Notes =sequencers#1. Think of a MIDI file as a musical version of an ASCII text file (exceptthat When the MIDI file contains binary data)party splits in disc 2, and each party member in the various sequencer programs as text editorsall capable inactive party except Selphie has one of reading that file. But, unlike ASCII, MIDI file format saves data in <B>chunks</B>(ie, groups of bytes preceded by an ID and size) which can be parsed, loaded, skipped, etc.Therefore, SMF format is flexible enough the eight bits changed for a particular sequencer to storeits own proprietary, "extra" data in such a way that another sequencer won't be confused whenloading the file and can safely ignore this extra stuff that it doesn't needvariable.For example, maybe One member has a sequencer wants to save a "flag byte"that indicates whether the user has turned on an audible metronome click. The sequencer can savethis flag byte in such a way that another sequencer can skip this byte withouthaving to understand what that byte is for. In the future4 most significant bits, the SMF format can also beextended to include new "official" chunks that all sequencer programs may elect to load and use.This can be done without making old data files obsolete, nor making old sequencers no longerable to load the new files. So, the format is designed to beextensible in a backwardly compatible way. Of course, SMF files may be used by other MIDI software than just sequencers.Since SMF files can store any and all types of MIDI messages, including System Exclusivemessages, they may be used to store/load data by all kinds of MIDI software, such as has a PatchEditor that wants to save some System Exclusive messages it received from a MIDI moduleflag in the 4 least significant bits. (The"timestamp" for each message may be irrelevant to such a Patch Editor. But itIt's easilyignored for programs done this way so that don't really need it). In conclusionwhen the characters appear, any software that saves or loads MIDI data should use SMF format for its datafiles. ==== MIDI File Format: Chunks ==== Data is always saved within a <B>chunk</B>. There can be many chunks inside of a MIDI file. Each chunk can be a they animate towards different size (and likely will be). A chunk's size is how many (8-bit)bytes are contained locations in the chunk. The data bytes in a chunk are typically related in some way. For examplefield, all rather than stacking on top of the bytes in one chunk may be for one particular sequencer trackeach other. The bytes for another sequencer track may be put ina different chunk#2. So, a chunk is simply a group of related bytes. Each chunk must begin with a 4 character (ie, 4 ascii bytes) <B>ID</B> which tells what "type"of chunk this is. The next 4 bytes must form a 32-bit length (ie, size) of the chunk. <U>All chunks must begin with these two fields</U> (ie, 8 bytes), This byte contains flags for which are referred to as the<B>chunk header</B>. Here's what a chunk's header looks like if you defined it in C:<pre>struct CHUNK_HEADER{ char ID[4]; unsigned long Length; };</pre><B><FONT COLOR=RED>NOTE:</FONT></B> The <B>Length</B> does not include the 8 byte chunkheader. It simply tells you how many bytes of data characters are in the chunk <U>following this header</U>. And hereSquall's an example chunk header (with bytes expressed in hex) if you examined it with a hex editor: 4D 54 68 64 00 00 00 06 Note that the first 4 bytes make up party when the ascii ID of <B>MThd</B> (ie, the first fourbytes are the ascii values for 'M', 'T', 'h', and 'd'). The next 4 bytes tell us that there shouldbe 6 more data bytes party splits in the chunk (and after that we should find the next chunk header or the endof the file). === MIDI File Format: MThd Chunk === The MThd header has an ID of <B>MThd</B>, and a Length of <B>6</B>. Let's examine the 6 data bytes (which follow the MThd header) in an MThd chunk. The first two data bytes tell the <B>Format</B> (which I prefer to call "type")disc 2.There are actually #3 different types (ie, formats) of MIDI files. A type List of 0 means everything that 728 holds throughout the filecontains one single track containing midi data on possibly all 16 midi channels. If your sequencersorts/stores all of its midi data in one single block of memory with the data in the order that it'sgame:* SeeD field exam "playedConduct", then it should read/write this type. A type of 1 means that the file contains one ormore simultaneous score (ie, all start from an assumed time of 0lose points when you do something wrong at Dollet) tracks, perhaps each on a single midichannel. Together, all of these tracks are considered one sequence or pattern. If yoursequencer separates its midi data * Train job attempts (i.e. tracksTimber) into different blocks of memory but plays them backsimultaneously (ie, as one "pattern"), it will read/write this type. A type * Tomb of 2 means that thefile contains one or more sequentially independant single-track patternsUnknown King student ID. If your sequencerseparates its midi data into different blocks of memory, but plays only one block at a time (ie,each block is considered a different "excerpt" or "song"), then it will read/write this type. The next 2 bytes tell how many tracks are stored * Who you took to space in the file, <B>NumTracks</B>disc 3. Of course,for format type 0, this is always 1#4. For the other 2 types, there can be numerous tracks. The last two bytes indicate how many Pulses (i.e. clocks) Per Quarter Note (abbreviated as PPQN) resolution the time-stamps are based upon, <B>Division</B>. For example, if your sequencer has 96 ppqn, this field would be (controlling restriction unlocking in hex): 00 60 <B><FONT COLOR=RED>NOTE:</FONT></B> The 4 bytes that make up Ultimecia's Castle uses this to figure out where to jump the <B>Length</B> are stored in (Motorola) "Big Endian" byte order, not (Intel) "Little Endian" reverse byte orderparty after they've broken a seal. (ie, The 06 is the fourth byte insteadof the first of the four). In fact, all MIDI files begin with the above <B>MThd header</B> (and thatIt's unknown how you know that SETPLACE actually sets this, it'sa MIDI file). Alternately, if not always related to the first byte of Division is negative, then this represents the divisionof a second that the time-stamps are based upon. The first byte will be -24, -25, -29, field ID or -30,corresponding to the 4 SMPTE standards representing frames per secondSETPLACE parameter. The second byte (apositive number) This variable is the resolution within a frame (ie, subframe)also set at Balamb Garden's front gate manually. Typical values may be 4 (MIDITime Code), 8, 10, 80 (SMPTE bit resolution), or 100:5You can specify millisecond-based timing by List of everything that 341 holds throughout the data bytes of -25 and 40 subframes. Here's what an MThd chunk looks like if you defined it in Cgame:* First flashback team<pre>struct MTHD_CHUNK{ /* HereSelphie's the 8 byte header that all chunks must have */ char ID[4]; /* This will be 'M','T','h','d' */ unsigned long Length; /* This will be 6 */  /* Here are the 6 bytes */ unsigned short Format; unsigned short NumTracks; unsigned short Division;};</pre> And herecurrent action when escaping from Deling's an example of a complete MThd chunk mansion (with headerchanges the dialogue) if you examined it in a hex editor:<pre>* FH Concert Crappiness4D 54 68 64 MThd ID00 00 00 06 Length of the MThd chunk is always 6.00 01 The Format type is 1.00 02 There are 2 MTrk chunks * Something in this file.E7 28 Each increment of deltaB-time represents a millisecondGarden classroom during the paratrooper attack.</pre>

Navigation menu