Understanding Save File Structure

var sav1 = SaveUtil.GetSaveFile("red.sav") as SAV1;

if (sav1 != null)
{
    // Gen 1 uses fixed memory offsets
    Console.WriteLine($"Is Japanese: {sav1.Japanese}");
    Console.WriteLine($"Is Yellow: {(sav1.Version == GameVersion.YW)}");
    Console.WriteLine($"Virtual Console: {sav1.IsVirtualConsole}");
}

var sav3 = SaveUtil.GetSaveFile("emerald.sav") as SAV3;

if (sav3 != null)
{
    // Gen 3 has two save slots (A and B)
    Console.WriteLine($"Game: {sav3.Version}"); // RS, E, or FRLG
    Console.WriteLine($"Security Key: {sav3.SecurityKey:X8}");
}

var sav4 = SaveUtil.GetSaveFile("platinum.sav") as SAV4Pt;

if (sav4 != null)
{
    Console.WriteLine($"Save Counter: {sav4.SaveCount}");
    // Footer contains block sizes and checksums
}

var sav5 = SaveUtil.GetSaveFile("white2.sav") as SAV5B2W2;

if (sav5 != null)
{
    Console.WriteLine($"Game: {sav5.Version}");
    // B2W2 has larger save size than BW
}

var sav6 = SaveUtil.GetSaveFile("omega_ruby.sav") as SAV6AO;

if (sav6 != null)
{
    Console.WriteLine($"Trainer Name: {sav6.OT}");
    Console.WriteLine($"Game Sync ID: {sav6.GameSyncID}");
    Console.WriteLine($"Region: {sav6.Region}");
    Console.WriteLine($"Country: {sav6.Country}");
}

var sav7 = SaveUtil.GetSaveFile("ultra_sun.sav") as SAV7USUM;

if (sav7 != null)
{
    Console.WriteLine($"Trainer: {sav7.OT}");
    Console.WriteLine($"Festival Plaza Rank: {sav7.FestaCoins}");
}

var sav8 = SaveUtil.GetSaveFile("main") as SAV8SWSH;

if (sav8 != null)
{
    // Access individual blocks
    var myStatus = sav8.MyStatus;
    var items = sav8.Items;
    var boxInfo = sav8.BoxInfo;
    var zukan = sav8.Zukan;
    
    Console.WriteLine($"OT: {myStatus.OT}");
    Console.WriteLine($"TID: {myStatus.TrainerTID7}");
    Console.WriteLine($"Revision: {sav8.SaveRevisionString}");
    
    // Check DLC content
    switch (sav8.SaveRevision)
    {
        case 0:
            Console.WriteLine("Base game only");
            break;
        case 1:
            Console.WriteLine("Has Isle of Armor DLC");
            break;
        case 2:
            Console.WriteLine("Has Crown Tundra DLC");
            break;
    }
}

var sav9 = SaveUtil.GetSaveFile("main") as SAV9SV;

if (sav9 != null)
{
    // Access typed blocks
    var myStatus = sav9.MyStatus;
    var items = sav9.Items;
    var boxInfo = sav9.BoxInfo;
    var zukan = sav9.Zukan;
    var fashion = sav9.PlayerFashion;
    
    Console.WriteLine($"Trainer: {myStatus.OT}");
    Console.WriteLine($"Last Saved: {sav9.LastSaved.DisplayValue}");
    Console.WriteLine($"Revision: {sav9.SaveRevisionString}");
    
    // Check DLC content
    if (sav9.SaveRevision >= 1)
        Console.WriteLine("Has Teal Mask DLC");
    if (sav9.SaveRevision >= 2)
        Console.WriteLine("Has Indigo Disk DLC");
}

if (sav is ISCBlockArray blockArray)
{
    // Access all blocks
    var allBlocks = blockArray.AllBlocks;
    
    Console.WriteLine($"Total blocks: {allBlocks.Count}");
    
    // Iterate through blocks
    foreach (var block in allBlocks)
    {
        Console.WriteLine($"Key: 0x{block.Key:X8}, Size: {block.Data.Length}");
    }
}

if (sav is SAV8SWSH swsh)
{
    // Get typed values from blocks
    uint money = swsh.GetValue<uint>(0x00000001); // Example key
    
    // Access through typed accessors
    var myStatus = swsh.MyStatus;
    Console.WriteLine($"Money: {myStatus.Money}");
}

public void ExploreBlocks(SAV8SWSH sav)
{
    var accessor = sav.Accessor;
    
    // Boolean blocks (1 byte)
    bool hasFlag = accessor.GetBlockValue<bool>(0x12345678);
    
    // Integer blocks (4 bytes)
    uint count = accessor.GetBlockValue<uint>(0x23456789);
    
    // Object blocks (variable size)
    byte[] objectData = accessor.GetBlock(0x34567890).Data.ToArray();
}

var sav = SaveUtil.GetSaveFile("save.sav");

if (sav != null)
{
    Console.WriteLine($"Total Boxes: {sav.BoxCount}");
    Console.WriteLine($"Slots per Box: {sav.BoxSlotCount}");
    Console.WriteLine($"Total Storage: {sav.SlotCount} Pokémon");
    
    // Get box offset for manual access
    int box0Offset = sav.GetBoxOffset(0);
    int box0Slot5Offset = sav.GetBoxOffset(0) + (5 * sav.SIZE_BOXSLOT);
}

Console.WriteLine($"Party Size: {sav.PartyCount}");

for (int i = 0; i < sav.PartyCount; i++)
{
    var pokemon = sav.GetPartySlot(i);
    Console.WriteLine($"Party {i + 1}: {pokemon.Species} Lv.{pokemon.CurrentLevel}");
}

if (sav is SAV9SV sv)
{
    // Strongly-typed access to save data
    var myStatus = sv.Blocks.MyStatus;
    var items = sv.Blocks.Items;
    var zukan = sv.Blocks.Zukan;
    var boxLayout = sv.Blocks.BoxLayout;
    var played = sv.Blocks.Played;
    var config = sv.Blocks.Config;
    
    // Access nested data
    Console.WriteLine($"Trainer: {myStatus.OT}");
    Console.WriteLine($"Play Time: {played.PlayedHours}h {played.PlayedMinutes}m");
    Console.WriteLine($"Boxes Unlocked: {boxLayout.BoxesUnlocked}");
}

var sav = SaveUtil.GetSaveFile("save.sav");

if (sav != null)
{
    var meta = sav.Metadata;
    
    // File information
    Console.WriteLine($"File Name: {meta.FileName}");
    Console.WriteLine($"File Path: {meta.FilePath}");
    
    // Handler information (if special format)
    if (meta.Handler != null)
    {
        Console.WriteLine($"Handler: {meta.Handler.GetType().Name}");
    }
    
    // Exportability
    Console.WriteLine($"Exportable: {sav.State.Exportable}");
    Console.WriteLine($"Edited: {sav.State.Edited}");
}

var sav1 = new SAV1();

// Gen 1 uses simple fixed offsets
// Party: 0x2F2C (INT) or 0x2ED5 (JPN)
// Current Box: 0x30C0 (INT) or 0x302D (JPN)
// Checksum: Inverse sum validation

var sav3 = new SAV3E();

// Gen 3 divides data into 14 sectors
// Each sector: 4KB (0x1000 bytes)
// Sector IDs: 0-13
// Each sector has:
// - Data (0xFF4 bytes)
// - ID (2 bytes)
// - Checksum (2 bytes)
// - Signature (4 bytes)
// - Save Index (4 bytes)

var sav8 = new SAV8SWSH();

// Gen 8 uses dynamic block system
// Each block:
// - Key: uint32 (identifier)
// - Type: byte (bool, int, object, etc.)
// - SubType: byte
// - Data: variable length

// Loading automatically decrypts
byte[] encryptedData = File.ReadAllBytes("main");
var sav = SaveUtil.GetSaveFile(encryptedData); // Auto-decrypts

// When saving, it automatically encrypts
var exportedData = sav.Write();
File.WriteAllBytes("main", exportedData.ToArray()); // Encrypted

var sav = SaveUtil.GetSaveFile("save.sav");

if (sav != null)
{
    if (sav.ChecksumsValid)
    {
        Console.WriteLine("✓ Checksums valid");
    }
    else
    {
        Console.WriteLine("✗ Invalid checksums");
        Console.WriteLine(sav.ChecksumInfo);
    }
}