FF8/Variables
From Final Fantasy Inside
< FF8
Revision as of 13:15, 6 March 2015 by my_wiki>Shard
By 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 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 (word 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 running as well. In the en-US version of the original and SE releases (and likely most other versions), the varblock begins at 0x18fe9b8. You can use this Cheat Engine table to track them as you play.
Because we don't have a way to analyze the battle scripts yet, some of these variables (even the unused ones) may be used during battles.
| Var type | Var Number | Description |
|---|---|---|
| Byte | 0-3 | unused in fields |
| Long | 4 | Steps (used to generate random encounters) |
| Byte | 8-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.) |
| Word | 26 | Battles escaped. |
| Word | 28 | Enemies killed by Squall |
| Byte | 30-33 | unused in fields |
| Word | 34 | Enemies killed by Quistis |
| Byte | 36-43 | unused in fields |
| Word | 44 | Number of times Squall has died in battle. |
| Byte | 46-49 | unused in fields |
| Word | 50 | Number of times Quistis has died in battle. |
| Byte | 52-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. This is related to SETPLACE somehow.4 |
| Signed Byte | 86 | Has something to do with whether the party is entering a field in a vehicle from the world map. Type of vehicle maybe? |
| Signed Byte | 87 | Built-in engine variable. No idea what it does. Scripts always check if it's equal to 0 or 10. |
| Signed Byte | 88 | Built-in engine variable. Used exclusively on save points. Never written to with field scripts. |
| Byte | 89-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 | unused in fields |
| Byte | 320-332 | Ultimecia Gallery related (pictures viewed?) |
| Byte | 333 | Ultimecia Armory chest flags |
| Byte | 334 | Ultimecia Castle seals. See 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.5 |
| 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 |
| Byte | 443-444 | unused in fields |
| Byte | 445-447 | Propagator defeated flags |
| Word | 448 | Unknown |
| Byte | 450-451 | Various magazine/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 | not investigated |
| Byte | 476 | not investigated |
| Byte | 477 | not investigated |
| Byte | 478 | not investigated |
| Byte | 479 | not investigated |
| Byte | 480 | not investigated |
| Byte | 481 | not investigated |
| Signed Word | 482 | not investigated |
| Byte | 484 | not investigated |
| Byte | 485 | not investigated |
| Byte | 486 | not investigated |
| Byte | 487 | not investigated |
| Byte | 488 | Alternate Party Flags. Irvine +1/+16, Quistis +2/+32, Rinoa +4/+64, Zell +8/+128.1 |
| Byte | 489 | not investigated |
| Byte | 490 | Cafeteria cutscene |
| Byte | 491 | not investigated |
| Byte | 492 | not investigated |
| Byte | 493 | not investigated |
| Byte | 494-527 | unused in fields |
| Signed Word | 528 | Sub-story progression (it's a progression variable for individual segments of the game) |
| Byte | 530 | not investigated |
| Byte | 531 | not investigated |
| Byte | 532 | not investigated |
| 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 (0=normal, 1=student, 2=SeeD) |
| Byte | 722 | Selphie's costume (0=normal, 1=student, 2=SeeD) |
| Byte | 723 | Quistis' Costume (0=normal, 1=SeeD) |
| Word | 724 | Dollet mission time |
| Word | 726 | not investigated |
| Byte | 728 | Does lots of things.3 |
| Byte | 729 | not investigated |
| Byte | 730 | Flags (+1 Joined Garden Festival Committee, +4 Gave Selphie tour of BG, +16 Kadowaki asks for Cid, +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).2 |
| 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. |
Notes
- 1. When the party splits in disc 2, each party member in the inactive party except Selphie has one of the eight bits changed for this variable. One member has a flag in the 4 most significant bits, and the other has a flag in the 4 least significant bits. It's done this way so that when the characters appear, they animate towards different locations in the field, rather than stacking on top of each other.
- 2. This byte contains flags for which characters are in Squall's party when the party splits in disc 2.
- 3. List of everything that 728 holds throughout the game:
- SeeD field exam "Conduct" score (lose points when you do something wrong at Dollet).
- Train job attempts (Timber)
- Tomb of the Unknown King student ID.
- Who you took to space in disc 3.
- 4. The field controlling restriction unlocking in Ultimecia's Castle uses this to figure out where to jump the party after they've broken a seal. It's unknown how SETPLACE actually sets this, it's not always related to the field ID or the SETPLACE parameter. This variable is also set at Balamb Garden's front gate manually.
- 5. List of everything that 341 holds throughout the game:
- First flashback team
- Selphie's current action when escaping from Deling's mansion (changes the dialogue)
- FH Concert Crappiness
- Something in B-Garden classroom during the paratrooper attack.
