using System; using System.Collections.Generic; using static System.Buffers.Binary.BinaryPrimitives; namespace PKHeX.Core; /// /// Generation 1 object. /// public sealed class SAV1 : SaveFile, ILangDeviantSave, IEventFlagArray { protected internal override string ShortSummary => $"{OT} ({Version}) - {PlayTimeString}"; public override string Extension => ".sav"; public bool IsVirtualConsole => State.Exportable && Metadata.FileName is { } s && s.StartsWith("sav", StringComparison.Ordinal) && s.Contains(".dat"); // default to GB-Era for non-exportable public int SaveRevision => Japanese ? 0 : 1; public string SaveRevisionString => (Japanese ? "J" : "U") + (IsVirtualConsole ? "VC" : "GB"); public bool Japanese { get; } public bool Korean => false; private readonly PersonalTable1 Table; public override IPersonalTable Personal => Table; public override IReadOnlyList HeldItems => Array.Empty(); public override IReadOnlyList PKMExtensions => Array.FindAll(PKM.Extensions, f => { int gen = f[^1] - 0x30; return gen is 1 or 2; }); public SAV1(GameVersion version = GameVersion.RBY, bool japanese = false) : base(SaveUtil.SIZE_G1RAW) { Version = version; Japanese = japanese; Offsets = Japanese ? SAV1Offsets.JPN : SAV1Offsets.INT; Table = version == GameVersion.YW ? PersonalTable.Y : PersonalTable.RB; Initialize(version); ClearBoxes(); } public SAV1(byte[] data, GameVersion versionOverride = GameVersion.Any) : base(data) { Japanese = SaveUtil.GetIsG1SAVJ(Data); Offsets = Japanese ? SAV1Offsets.JPN : SAV1Offsets.INT; Version = versionOverride != GameVersion.Any ? versionOverride : SaveUtil.GetIsG1SAV(data); Table = Version == GameVersion.YW ? PersonalTable.Y : PersonalTable.RB; if (Version == GameVersion.Invalid) return; Initialize(versionOverride); } private void Initialize(GameVersion versionOverride) { // see if RBY can be differentiated if (Starter != 0 && versionOverride is not (GameVersion.RB or GameVersion.YW)) Version = Yellow ? GameVersion.YW : GameVersion.RB; Box = Data.Length; Array.Resize(ref Data, Data.Length + SIZE_RESERVED); Party = GetPartyOffset(0); // Stash boxes after the save file's end. int stored = SIZE_STOREDBOX; var capacity = Japanese ? PokeListType.StoredJP : PokeListType.Stored; int baseDest = Data.Length - SIZE_RESERVED; for (int box = 0; box < BoxCount; box++) { int boxOfs = GetBoxRawDataOffset(box); UnpackBox(boxOfs, baseDest, stored, box, capacity); } if ((uint)CurrentBox < BoxCount) { // overwrite previously cached box data. UnpackBox(Offsets.CurrentBox, baseDest, stored, CurrentBox, capacity); } var party = GetData(Offsets.Party, SIZE_STOREDPARTY); var partyPL = new PokeList1(party, PokeListType.Party, Japanese); for (int i = 0; i < partyPL.Pokemon.Length; i++) { var dest = GetPartyOffset(i); var pkDat = i < partyPL.Count ? new PokeList1(partyPL[i]).Write() : new byte[PokeList1.GetDataLength(PokeListType.Single, Japanese)]; pkDat.CopyTo(Data, dest); } Span rawDC = stackalloc byte[0x38]; Data.AsSpan(Offsets.Daycare, rawDC.Length).CopyTo(rawDC); byte[] TempDaycare = new byte[PokeList1.GetDataLength(PokeListType.Single, Japanese)]; TempDaycare[0] = rawDC[0]; rawDC.Slice(1, StringLength).CopyTo(TempDaycare.AsSpan(2 + 1 + PokeCrypto.SIZE_1PARTY + StringLength)); rawDC.Slice(1 + StringLength, StringLength).CopyTo(TempDaycare.AsSpan(2 + 1 + PokeCrypto.SIZE_1PARTY)); rawDC.Slice(1 + (2 * StringLength), PokeCrypto.SIZE_1STORED).CopyTo(TempDaycare.AsSpan(2 + 1)); PokeList1 daycareList = new(TempDaycare, PokeListType.Single, Japanese); daycareList.Write().CopyTo(Data, GetPartyOffset(7)); DaycareOffset = GetPartyOffset(7); // Enable Pokedex editing PokeDex = 0; } private void UnpackBox(int srcOfs, int destOfs, int boxSize, int boxIndex, PokeListType boxCapacity) { var boxData = GetData(srcOfs, boxSize); var boxDest = destOfs + (boxIndex * SIZE_BOX); var boxPL = new PokeList1(boxData, boxCapacity, Japanese); for (int i = 0; i < boxPL.Pokemon.Length; i++) { var slotOfs = boxDest + (i * SIZE_STORED); var slotData = Data.AsSpan(slotOfs, SIZE_STORED); if (i < boxPL.Count) new PokeList1(boxPL[i]).Write().CopyTo(slotData); else slotData.Clear(); } } private void PackBox(int boxDest, int boxIndex, PokeListType boxCapacity) { var boxPL = new PokeList1(boxCapacity, Japanese); int slot = 0; for (int i = 0; i < boxPL.Pokemon.Length; i++) { var slotOfs = boxDest + (i * SIZE_STORED); var slotData = Data.AsSpan(slotOfs, SIZE_STORED); PK1 pk = (PK1)GetPKM(slotData.ToArray()); if (pk.Species > 0) boxPL[slot++] = pk; } // copy to box location var boxData = boxPL.Write(); int boxSrc = GetBoxRawDataOffset(boxIndex); SetData(Data, boxData, boxSrc); // copy to active loc if current box if (boxIndex == CurrentBox) SetData(Data, boxData, Offsets.CurrentBox); } private const int SIZE_RESERVED = 0x8000; // unpacked box data private readonly SAV1Offsets Offsets; // Event Flags public int EventFlagCount => 0xA00; // 320 * 8 public bool GetEventFlag(int flagNumber) { if ((uint)flagNumber >= EventFlagCount) throw new ArgumentOutOfRangeException(nameof(flagNumber), $"Event Flag to get ({flagNumber}) is greater than max ({EventFlagCount})."); return GetFlag(Offsets.EventFlag + (flagNumber >> 3), flagNumber & 7); } public void SetEventFlag(int flagNumber, bool value) { if ((uint)flagNumber >= EventFlagCount) throw new ArgumentOutOfRangeException(nameof(flagNumber), $"Event Flag to set ({flagNumber}) is greater than max ({EventFlagCount})."); SetFlag(Offsets.EventFlag + (flagNumber >> 3), flagNumber & 7, value); } protected override byte[] GetFinalData() { var capacity = Japanese ? PokeListType.StoredJP : PokeListType.Stored; for (int box = 0; box < BoxCount; box++) { var boxOfs = GetBoxOffset(box); PackBox(boxOfs, box, capacity); } var partyPL = new PokeList1(PokeListType.Party, Japanese); int pSlot = 0; for (int i = 0; i < 6; i++) { PK1 partyPK = (PK1)GetPKM(GetData(GetPartyOffset(i), SIZE_STORED)); if (partyPK.Species > 0) partyPL[pSlot++] = partyPK; } partyPL.Write().CopyTo(Data, Offsets.Party); // Daycare is read-only, but in case it ever becomes editable, copy it back in. Span rawDC = Data.AsSpan(GetDaycareSlotOffset(loc: 0, slot: 0), SIZE_STORED); Span dc = stackalloc byte[1 + (2 * StringLength) + PokeCrypto.SIZE_1STORED]; dc[0] = IsDaycareOccupied(0, 0) == true ? (byte)1 : (byte)0; rawDC.Slice(2 + 1 + PokeCrypto.SIZE_1PARTY + StringLength, StringLength).CopyTo(dc[1..]); rawDC.Slice(2 + 1 + PokeCrypto.SIZE_1PARTY, StringLength).CopyTo(dc[(1 + StringLength)..]); rawDC.Slice(2 + 1, PokeCrypto.SIZE_1STORED).CopyTo(dc[(1 + (2 * StringLength))..]); dc.CopyTo(Data.AsSpan(Offsets.Daycare)); SetChecksums(); return Data.AsSpan()[..^SIZE_RESERVED].ToArray(); } private int GetBoxRawDataOffset(int box) { if (box < BoxCount / 2) return 0x4000 + (box * SIZE_STOREDBOX); return 0x6000 + ((box - (BoxCount / 2)) * SIZE_STOREDBOX); } // Configuration protected override SaveFile CloneInternal() => new SAV1(Write(), Version); protected override int SIZE_STORED => Japanese ? PokeCrypto.SIZE_1JLIST : PokeCrypto.SIZE_1ULIST; protected override int SIZE_PARTY => Japanese ? PokeCrypto.SIZE_1JLIST : PokeCrypto.SIZE_1ULIST; private int SIZE_BOX => BoxSlotCount*SIZE_STORED; private int SIZE_STOREDBOX => PokeList1.GetDataLength(Japanese ? PokeListType.StoredJP : PokeListType.Stored, Japanese); private int SIZE_STOREDPARTY => PokeList1.GetDataLength(PokeListType.Party, Japanese); public override PKM BlankPKM => new PK1(Japanese); public override Type PKMType => typeof(PK1); public override ushort MaxMoveID => Legal.MaxMoveID_1; public override ushort MaxSpeciesID => Legal.MaxSpeciesID_1; public override int MaxAbilityID => Legal.MaxAbilityID_1; public override int MaxItemID => Legal.MaxItemID_1; public override int MaxBallID => 0; // unused public override int MaxGameID => 99; // unused public override int MaxMoney => 999999; public override int MaxCoins => 9999; public override int BoxCount => Japanese ? 8 : 12; public override int MaxEV => 65535; public override int MaxIV => 15; public override int Generation => 1; public override EntityContext Context => EntityContext.Gen1; protected override int GiftCountMax => 0; public override int OTLength => Japanese ? 5 : 7; public override int NickLength => Japanese ? 5 : 10; public override int BoxSlotCount => Japanese ? 30 : 20; public override bool HasParty => true; private int StringLength => Japanese ? GBPKML.StringLengthJapanese : GBPKML.StringLengthNotJapan; public override bool IsPKMPresent(ReadOnlySpan data) => EntityDetection.IsPresentGB(data); // Checksums protected override void SetChecksums() => Data[Offsets.ChecksumOfs] = GetRBYChecksum(Offsets.OT, Offsets.ChecksumOfs); public override bool ChecksumsValid => Data[Offsets.ChecksumOfs] == GetRBYChecksum(Offsets.OT, Offsets.ChecksumOfs); public override string ChecksumInfo => ChecksumsValid ? "Checksum valid." : "Checksum invalid"; private byte GetRBYChecksum(int start, int end) { byte chksum = 0; for (int i = start; i < end; i++) chksum += Data[i]; chksum ^= 0xFF; return chksum; } // Trainer Info public override GameVersion Version { get; protected set; } public override string OT { get => GetString(Offsets.OT, OTLength); set => SetString(Data.AsSpan(Offsets.OT, OTLength + 1), value.AsSpan(), OTLength, StringConverterOption.ClearZero); } public Span OT_Trash { get => Data.AsSpan(Offsets.OT, StringLength); set { if (value.Length == StringLength) value.CopyTo(Data.AsSpan(Offsets.OT)); } } public override int Gender { get => 0; set { } } public override int TID { get => ReadUInt16BigEndian(Data.AsSpan(Offsets.TID)); set => WriteUInt16BigEndian(Data.AsSpan(Offsets.TID), (ushort)value); } public override int SID { get => 0; set { } } public string Rival { get => GetString(Offsets.Rival, OTLength); set => SetString(Data.AsSpan(Offsets.Rival, OTLength), value.AsSpan(), OTLength, StringConverterOption.Clear50); } public Span Rival_Trash { get => Data.AsSpan(Offsets.Rival, StringLength); set { if (value.Length == StringLength) value.CopyTo(Data.AsSpan(Offsets.Rival)); } } public bool Yellow => Starter == 0x54; // Pikachu public int Starter => Data[Offsets.Starter]; public byte PikaFriendship { get => Data[Offsets.PikaFriendship]; set => Data[Offsets.PikaFriendship] = value; } public int PikaBeachScore { get => BinaryCodedDecimal.ToInt32LE(Data.AsSpan(Offsets.PikaBeachScore, 2)); set => BinaryCodedDecimal.WriteBytesLE(Data.AsSpan(Offsets.PikaBeachScore, 2), Math.Min(9999, value)); } public override string PlayTimeString => !PlayedMaximum ? base.PlayTimeString : $"{base.PlayTimeString} {Checksums.CRC16_CCITT(Data):X4}"; public override int PlayedHours { get => Data[Offsets.PlayTime + 0]; set { if (value >= byte.MaxValue) // Set 255:00:00.00 and flag { PlayedMaximum = true; value = byte.MaxValue; PlayedMinutes = PlayedSeconds = PlayedFrames = 0; } Data[Offsets.PlayTime + 0] = (byte) value; } } public bool PlayedMaximum { get => Data[Offsets.PlayTime + 1] != 0; set => Data[Offsets.PlayTime + 1] = value ? (byte)1 : (byte)0; } public override int PlayedMinutes { get => Data[Offsets.PlayTime + 2]; set => Data[Offsets.PlayTime + 2] = (byte)value; } public override int PlayedSeconds { get => Data[Offsets.PlayTime + 3]; set => Data[Offsets.PlayTime + 3] = (byte)value; } public int PlayedFrames { get => Data[Offsets.PlayTime + 4]; set => Data[Offsets.PlayTime + 4] = (byte)value; } public int Badges { get => Data[Offsets.Badges]; set { if (value < 0) return; Data[Offsets.Badges] = (byte)value; } } private byte Options { get => Data[Offsets.Options]; set => Data[Offsets.Options] = value; } public bool BattleEffects { get => (Options & 0x80) == 0; set => Options = (byte)((Options & 0x7F) | (value ? 0 : 0x80)); } public bool BattleStyleSwitch { get => (Options & 0x40) == 0; set => Options = (byte)((Options & 0xBF) | (value ? 0 : 0x40)); } public int Sound { get => (Options & 0x30) >> 4; set => Options = (byte)((Options & 0xCF) | ((value & 3) << 4)); } public int TextSpeed { get => Options & 0x7; set => Options = (byte)((Options & 0xF8) | (value & 7)); } // yellow only public byte GBPrinterBrightness { get => Data[Offsets.PrinterBrightness]; set => Data[Offsets.PrinterBrightness] = value; } public override uint Money { get => (uint)BinaryCodedDecimal.ToInt32BE(Data.AsSpan(Offsets.Money, 3)); set { value = (uint)Math.Min(value, MaxMoney); BinaryCodedDecimal.WriteBytesBE(Data.AsSpan(Offsets.Money, 3), (int)value); } } public uint Coin { get => (uint)BinaryCodedDecimal.ToInt32BE(Data.AsSpan(Offsets.Coin, 2)); set { value = (ushort)Math.Min(value, MaxCoins); BinaryCodedDecimal.WriteBytesBE(Data.AsSpan(Offsets.Coin, 2), (int)value); } } private readonly ushort[] LegalItems = Legal.Pouch_Items_RBY; public override IReadOnlyList Inventory { get { ushort[] legalItems = LegalItems; InventoryPouch[] pouch = { new InventoryPouchGB(InventoryType.Items, legalItems, 99, Offsets.Items, 20), new InventoryPouchGB(InventoryType.PCItems, legalItems, 99, Offsets.PCItems, 50), }; return pouch.LoadAll(Data); } set => value.SaveAll(Data); } public override int GetDaycareSlotOffset(int loc, int slot) { return DaycareOffset; } public override uint? GetDaycareEXP(int loc, int slot) { return null; } public override bool? IsDaycareOccupied(int loc, int slot) { if (loc == 0 && slot == 0) return Data[Offsets.Daycare] == 0x01; return null; } public override void SetDaycareEXP(int loc, int slot, uint EXP) { // todo } public override void SetDaycareOccupied(int loc, int slot, bool occupied) { // todo } // Storage public override int PartyCount { get => Data[Offsets.Party]; protected set => Data[Offsets.Party] = (byte)value; } public override int GetBoxOffset(int box) { return Data.Length - SIZE_RESERVED + (box * SIZE_BOX); } public override int GetPartyOffset(int slot) { return Data.Length - SIZE_RESERVED + (BoxCount * SIZE_BOX) + (slot * SIZE_STORED); } public override int CurrentBox { get => Data[Offsets.CurrentBoxIndex] & 0x7F; set => Data[Offsets.CurrentBoxIndex] = (byte)((Data[Offsets.CurrentBoxIndex] & 0x80) | (value & 0x7F)); } public bool CurrentBoxChanged { get => (Data[Offsets.CurrentBoxIndex] & 0x80) != 0; set => Data[Offsets.CurrentBoxIndex] = (byte)((Data[Offsets.CurrentBoxIndex] & 0x7F) | (byte)(value ? 0x80 : 0)); } public override string GetBoxName(int box) { return $"BOX {box + 1}"; } public override void SetBoxName(int box, string value) { // Don't allow for custom box names } protected override PKM GetPKM(byte[] data) { if (data.Length == SIZE_STORED) return new PokeList1(data, PokeListType.Single, Japanese)[0]; return new PK1(data); } protected override byte[] DecryptPKM(byte[] data) { return data; } // Pokédex protected override void SetDex(PKM pk) { ushort species = pk.Species; if (!CanSetDex(species)) return; SetCaught(pk.Species, true); SetSeen(pk.Species, true); } private bool CanSetDex(ushort species) { if (species == 0) return false; if (species > MaxSpeciesID) return false; if (Version == GameVersion.Invalid) return false; return true; } public override bool GetSeen(ushort species) => GetDexFlag(Offsets.DexSeen, species); public override bool GetCaught(ushort species) => GetDexFlag(Offsets.DexCaught, species); public override void SetSeen(ushort species, bool seen) => SetDexFlag(Offsets.DexSeen, species, seen); public override void SetCaught(ushort species, bool caught) => SetDexFlag(Offsets.DexCaught, species, caught); private bool GetDexFlag(int region, ushort species) { int bit = species - 1; int ofs = bit >> 3; return GetFlag(region + ofs, bit & 7); } private void SetDexFlag(int region, ushort species, bool value) { int bit = species - 1; int ofs = bit >> 3; SetFlag(region + ofs, bit & 7, value); } public override void WriteSlotFormatStored(PKM pk, Span data, int offset) { // pk that have never been boxed have yet to save the 'current level' for box indication // set this value at this time ((PK1)pk).Stat_LevelBox = pk.CurrentLevel; base.WriteSlotFormatStored(pk, Data, offset); } public override void WriteBoxSlot(PKM pk, Span data, int offset) { // pk that have never been boxed have yet to save the 'current level' for box indication // set this value at this time ((PK1)pk).Stat_LevelBox = pk.CurrentLevel; base.WriteBoxSlot(pk, Data, offset); } private const int SpawnFlagCount = 0xF0; public bool[] EventSpawnFlags { get { // RB uses 0xE4 (0xE8) flags, Yellow uses 0xF0 flags. Just grab 0xF0 bool[] data = new bool[SpawnFlagCount]; for (int i = 0; i < data.Length; i++) data[i] = GetFlag(Offsets.ObjectSpawnFlags + (i >> 3), i & 7); return data; } set { if (value.Length != SpawnFlagCount) return; for (int i = 0; i < value.Length; i++) SetFlag(Offsets.ObjectSpawnFlags + (i >> 3), i & 7, value[i]); } } public override string GetString(ReadOnlySpan data) => StringConverter12.GetString(data, Japanese); public override int SetString(Span destBuffer, ReadOnlySpan value, int maxLength, StringConverterOption option) { return StringConverter12.SetString(destBuffer, value, maxLength, Japanese, option); } }