Difference between revisions of "FF8/Variables"
(Corrected link to Cheat Engine table) |
|||
Line 2: | Line 2: | ||
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. | 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 [https://www.mediafire.com/?ucolf65ewq1yoty | + | 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 [https://www.mediafire.com/?ucolf65ewq1yoty Cheat Engine table] to track them as you play. |
Items in grey are unused by field scripts (some of them may be used in battle scripts). | Items in grey are unused by field scripts (some of them may be used in battle scripts). |
Revision as of 22:41, 5 December 2020
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.
Items in grey are unused by field scripts (some of them may be used in battle scripts).
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 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 |
Word | 443 | Zell Health in Prison (Hacktuar) |
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-478 | CC Group variables |
Byte | 479 | If set to 0, disables all random battles during area loading. |
Byte | 480 | State of students in classroom (what they're doing). |
Byte | 481 | Controls a conversation 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.1 |
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 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 (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.