mirror of
https://github.com/kwsch/PKHeX
synced 2024-12-22 02:13:10 +00:00
5bcccc6d92
* Revises legality checks to account for traveling between the three game islands (PLA/BDSP/SWSH) * Adds conversion mechanisms between the three formats, as well as flexible conversion options to backfill missing data (thanks GameFreak/ILCA for opting for lossy conversion instead of updating the games). * Adds API abstractions for HOME data storage format (EKH/PKH format 1, aka EH1/PH1). * Revises some APIs for better usage: - `PKM` now exposes a `Context` to indicate the isolation context for legality purposes. - Some method signatures have changed to accept `Context` or `GameVersion` instead of a vague `int` for Generation. - Evolution History is now tracked in the Legality parse for specific contexts, rather than only per generation.
254 lines
10 KiB
C#
254 lines
10 KiB
C#
using System;
|
|
using System.Collections.Generic;
|
|
using static PKHeX.Core.LegalityCheckStrings;
|
|
|
|
namespace PKHeX.Core
|
|
{
|
|
/// <summary>
|
|
/// Verifies the transfer data for a <see cref="PKM"/> that has been irreversably transferred forward.
|
|
/// </summary>
|
|
public sealed class TransferVerifier : Verifier
|
|
{
|
|
protected override CheckIdentifier Identifier => CheckIdentifier.Encounter;
|
|
|
|
public override void Verify(LegalityAnalysis data)
|
|
{
|
|
throw new Exception("Don't call via this.");
|
|
}
|
|
|
|
public void VerifyTransferLegalityG12(LegalityAnalysis data)
|
|
{
|
|
VerifyVCOTGender(data);
|
|
VerifyVCNatureEXP(data);
|
|
VerifyVCShinyXorIfShiny(data);
|
|
VerifyVCGeolocation(data);
|
|
}
|
|
|
|
private void VerifyVCOTGender(LegalityAnalysis data)
|
|
{
|
|
var pkm = data.pkm;
|
|
if (pkm.OT_Gender == 1 && pkm.Version != (int)GameVersion.C)
|
|
data.AddLine(GetInvalid(LG2OTGender));
|
|
}
|
|
|
|
private void VerifyVCNatureEXP(LegalityAnalysis data)
|
|
{
|
|
var pkm = data.pkm;
|
|
var met = pkm.Met_Level;
|
|
|
|
if (met == 100) // check for precise match, can't receive EXP after transfer.
|
|
{
|
|
var nature = Experience.GetNatureVC(pkm.EXP);
|
|
if (nature != pkm.Nature)
|
|
data.AddLine(GetInvalid(LTransferNature));
|
|
return;
|
|
}
|
|
if (met <= 2) // Not enough EXP to have every nature -- check for exclusions!
|
|
{
|
|
var pi = pkm.PersonalInfo;
|
|
var growth = pi.EXPGrowth;
|
|
var nature = pkm.Nature;
|
|
bool valid = VerifyVCNature(growth, nature);
|
|
if (!valid)
|
|
data.AddLine(GetInvalid(LTransferNature));
|
|
}
|
|
}
|
|
|
|
private static bool VerifyVCNature(int growth, int nature) => growth switch
|
|
{
|
|
// exp % 25 with a limited amount of EXP does not allow for every nature
|
|
0 => (0x01FFFF03 & (1 << nature)) != 0, // MediumFast -- Can't be Brave, Adamant, Naughty, Bold, Docile, or Relaxed
|
|
4 => (0x001FFFC0 & (1 << nature)) != 0, // Fast -- Can't be Gentle, Sassy, Careful, Quirky, Hardy, Lonely, Brave, Adamant, Naughty, or Bold
|
|
5 => (0x01FFFCFF & (1 << nature)) != 0, // Slow -- Can't be Impish or Lax
|
|
_ => true,
|
|
};
|
|
|
|
private static void VerifyVCShinyXorIfShiny(LegalityAnalysis data)
|
|
{
|
|
// Star, not square. Requires transferring a shiny and having the initially random PID to already be a Star shiny.
|
|
// (15:65536, ~1:4096) odds on a given shiny transfer!
|
|
var xor = data.pkm.ShinyXor;
|
|
if (xor is <= 15 and not 0)
|
|
data.AddLine(Get(LEncStaticPIDShiny, ParseSettings.Gen7TransferStarPID, CheckIdentifier.PID));
|
|
}
|
|
|
|
private static void VerifyVCGeolocation(LegalityAnalysis data)
|
|
{
|
|
if (data.pkm is not PK7 pk7)
|
|
return;
|
|
|
|
// VC Games were region locked to the Console, meaning not all language games are available.
|
|
var within = Locale3DS.IsRegionLockedLanguageValidVC(pk7.ConsoleRegion, pk7.Language);
|
|
if (!within)
|
|
data.AddLine(GetInvalid(string.Format(LOTLanguage, $"!={(LanguageID)pk7.Language}", ((LanguageID)pk7.Language).ToString()), CheckIdentifier.Language));
|
|
}
|
|
|
|
public void VerifyTransferLegalityG3(LegalityAnalysis data)
|
|
{
|
|
var pkm = data.pkm;
|
|
if (pkm.Format == 4) // Pal Park (3->4)
|
|
{
|
|
if (pkm.Met_Location != Locations.Transfer3)
|
|
data.AddLine(GetInvalid(LEggLocationPalPark));
|
|
}
|
|
else // Transporter (4->5)
|
|
{
|
|
if (pkm.Met_Location != Locations.Transfer4)
|
|
data.AddLine(GetInvalid(LTransferEggLocationTransporter));
|
|
}
|
|
}
|
|
|
|
public void VerifyTransferLegalityG4(LegalityAnalysis data)
|
|
{
|
|
var pkm = data.pkm;
|
|
int loc = pkm.Met_Location;
|
|
if (loc == Locations.Transfer4)
|
|
return;
|
|
|
|
// Crown met location must be present if transferred via lock capsule
|
|
switch (pkm.Species)
|
|
{
|
|
case (int)Species.Celebi:
|
|
if (loc is not (Locations.Transfer4_CelebiUnused or Locations.Transfer4_CelebiUsed))
|
|
data.AddLine(GetInvalid(LTransferMet));
|
|
break;
|
|
case (int)Species.Raikou or (int)Species.Entei or (int)Species.Suicune:
|
|
if (loc is not (Locations.Transfer4_CrownUnused or Locations.Transfer4_CrownUsed))
|
|
data.AddLine(GetInvalid(LTransferMet));
|
|
break;
|
|
default:
|
|
data.AddLine(GetInvalid(LTransferEggLocationTransporter));
|
|
break;
|
|
}
|
|
}
|
|
|
|
public void VerifyTransferLegalityG8(LegalityAnalysis data)
|
|
{
|
|
var pkm = data.pkm;
|
|
if (pkm is PA8 pa8)
|
|
{
|
|
VerifyTransferLegalityG8a(data, pa8);
|
|
return;
|
|
}
|
|
if (pkm is PB8 pb8)
|
|
{
|
|
VerifyTransferLegalityG8b(data, pb8);
|
|
return;
|
|
}
|
|
|
|
// PK8
|
|
int species = pkm.Species;
|
|
if (!PersonalTable.SWSH.IsPresentInGame(species, pkm.Form)) // Can't transfer
|
|
{
|
|
data.AddLine(GetInvalid(LTransferBad));
|
|
return;
|
|
}
|
|
|
|
var enc = data.EncounterMatch;
|
|
if (enc.Version == GameVersion.GO || enc is WC8 {IsHOMEGift: true})
|
|
{
|
|
VerifyHOMETracker(data, pkm);
|
|
}
|
|
else if (pkm.Format >= 8 && !pkm.IsNative)
|
|
{
|
|
if (enc is EncounterStatic7 {IsTotem: true} s)
|
|
{
|
|
if (Legal.Totem_NoTransfer.Contains(s.Species))
|
|
data.AddLine(GetInvalid(LTransferBad));
|
|
if (pkm.Form != FormInfo.GetTotemBaseForm(s.Species, s.Form))
|
|
data.AddLine(GetInvalid(LTransferBad));
|
|
}
|
|
|
|
if (enc.Generation < 8)
|
|
VerifyHOMETransfer(data, pkm);
|
|
VerifyHOMETracker(data, pkm);
|
|
}
|
|
}
|
|
private void VerifyTransferLegalityG8a(LegalityAnalysis data, PA8 pk)
|
|
{
|
|
// Tracker value is set via Transfer across HOME.
|
|
if (!pk.IsNative)
|
|
VerifyHOMETracker(data, pk);
|
|
|
|
if (!PersonalTable.LA.IsPresentInGame(pk.Species, pk.Form)) // Can't transfer
|
|
data.AddLine(GetInvalid(LTransferBad));
|
|
}
|
|
|
|
// bdsp logic
|
|
private void VerifyTransferLegalityG8b(LegalityAnalysis data, PB8 pk)
|
|
{
|
|
// Tracker value is set via Transfer across HOME.
|
|
if (!pk.IsNative)
|
|
VerifyHOMETracker(data, pk);
|
|
|
|
if (!PersonalTable.BDSP.IsPresentInGame(pk.Species, pk.Form)) // Can't transfer
|
|
data.AddLine(GetInvalid(LTransferBad));
|
|
}
|
|
|
|
private void VerifyHOMETransfer(LegalityAnalysis data, PKM pkm)
|
|
{
|
|
if (pkm is not IScaledSize s)
|
|
return;
|
|
|
|
if (pkm.LGPE || pkm.GO)
|
|
return; // can have any size value
|
|
if (s.HeightScalar != 0)
|
|
data.AddLine(GetInvalid(LTransferBad));
|
|
if (s.WeightScalar != 0)
|
|
data.AddLine(GetInvalid(LTransferBad));
|
|
}
|
|
|
|
private void VerifyHOMETracker(LegalityAnalysis data, PKM pkm)
|
|
{
|
|
// Tracker value is set via Transfer across HOME.
|
|
// Can't validate the actual values (we aren't the server), so we can only check against zero.
|
|
if (pkm is IHomeTrack {Tracker: 0})
|
|
{
|
|
data.AddLine(Get(LTransferTrackerMissing, ParseSettings.Gen8TransferTrackerNotPresent));
|
|
// To the reader: It seems like the best course of action for setting a tracker is:
|
|
// - Transfer a 0-Tracker pkm to HOME to get assigned a valid Tracker
|
|
// - Don't make one up.
|
|
}
|
|
}
|
|
|
|
public IEnumerable<CheckResult> VerifyVCEncounter(PKM pkm, IEncounterTemplate encounter, ILocation transfer, IList<CheckMoveResult> Moves)
|
|
{
|
|
if (pkm.Met_Location != transfer.Location)
|
|
yield return GetInvalid(LTransferMetLocation);
|
|
|
|
var expecteEgg = pkm is PB8 ? Locations.Default8bNone : transfer.EggLocation;
|
|
if (pkm.Egg_Location != expecteEgg)
|
|
yield return GetInvalid(LEggLocationNone);
|
|
|
|
// Flag Moves that cannot be transferred
|
|
if (encounter is EncounterStatic2Odd) // Dizzy Punch Gifts
|
|
FlagIncompatibleTransferMove(pkm, Moves, 146, 2); // can't have Dizzy Punch at all
|
|
|
|
bool checkShiny = pkm.VC2 || (pkm.VC1 && GBRestrictions.IsTimeCapsuleTransferred(pkm, Moves, encounter).WasTimeCapsuleTransferred());
|
|
if (!checkShiny)
|
|
yield break;
|
|
|
|
if (pkm.Gender == 1) // female
|
|
{
|
|
if (pkm.PersonalInfo.Gender == 31 && pkm.IsShiny) // impossible gender-shiny
|
|
yield return GetInvalid(LEncStaticPIDShiny, CheckIdentifier.PID);
|
|
}
|
|
else if (pkm.Species == (int)Species.Unown)
|
|
{
|
|
if (pkm.Form is not (8 or 21) && pkm.IsShiny) // impossibly form-shiny (not I or V)
|
|
yield return GetInvalid(LEncStaticPIDShiny, CheckIdentifier.PID);
|
|
}
|
|
}
|
|
|
|
private static void FlagIncompatibleTransferMove(PKM pkm, IList<CheckMoveResult> Moves, int move, int gen)
|
|
{
|
|
int index = Array.IndexOf(pkm.Moves, move);
|
|
if (index < 0)
|
|
return; // doesn't have move
|
|
|
|
var chk = Moves[index];
|
|
if (chk.Generation == gen) // not obtained from a future gen
|
|
Moves[index].FlagIllegal(LTransferMove, CheckIdentifier.CurrentMove);
|
|
}
|
|
}
|
|
}
|