mirror of
https://github.com/kwsch/PKHeX
synced 2024-12-19 17:03:12 +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.
161 lines
5.2 KiB
C#
161 lines
5.2 KiB
C#
using System;
|
|
|
|
namespace PKHeX.Core;
|
|
|
|
/// <summary>
|
|
/// Effort Level stat values gained via applied Grit items.
|
|
/// </summary>
|
|
public interface IGanbaru
|
|
{
|
|
byte GV_HP { get; set; }
|
|
byte GV_ATK { get; set; }
|
|
byte GV_DEF { get; set; }
|
|
byte GV_SPE { get; set; }
|
|
byte GV_SPA { get; set; }
|
|
byte GV_SPD { get; set; }
|
|
}
|
|
|
|
public static class GanbaruExtensions
|
|
{
|
|
/// <summary>
|
|
/// Overall maximum value permitted (adding the base factor and gained value).
|
|
/// </summary>
|
|
public const byte TrueMax = 10;
|
|
|
|
private static readonly byte[] GanbaruMultiplier = { 0, 2, 3, 4, 7, 8, 9, 14, 15, 16, 25 };
|
|
|
|
/// <summary>
|
|
/// Gets the max possible value that can be legally stored for the specific stat <see cref="index"/>.
|
|
/// </summary>
|
|
public static byte GetMax(this IGanbaru _, PKM pk, int index) => GetMaxGanbaru(pk, index);
|
|
|
|
/// <summary>
|
|
/// Gets the max possible value that can be legally stored for the specific stat <see cref="index"/>.
|
|
/// </summary>
|
|
public static byte GetMaxGanbaru(this PKM pk, int index)
|
|
{
|
|
var iv = pk.GetIV(index);
|
|
return GetMaxGanbaru(iv);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the max possible value that can be legally stored for a stat with value <see cref="iv"/>.
|
|
/// </summary>
|
|
private static byte GetMaxGanbaru(int iv)
|
|
{
|
|
var bias = GetBias(iv);
|
|
return (byte)(TrueMax - bias);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the added boost for a stat with a base potential <see cref="iv"/>.
|
|
/// </summary>
|
|
public static byte GetBias(int iv) => iv switch
|
|
{
|
|
>= 31 => 3,
|
|
>= 26 => 2,
|
|
>= 20 => 1,
|
|
_ => 0,
|
|
};
|
|
|
|
/// <summary>
|
|
/// Sets all values to the maximum. Attack and Speed are set to 0 if the corresponding IV is zero.
|
|
/// </summary>
|
|
public static void SetSuggestedGanbaruValues(this IGanbaru g, PKM pk)
|
|
{
|
|
g.GV_HP = GetMaxGanbaru(pk.IV_HP);
|
|
g.GV_ATK = pk.IV_ATK == 0 ? (byte)0: GetMaxGanbaru(pk.IV_ATK);
|
|
g.GV_DEF = GetMaxGanbaru(pk.IV_DEF);
|
|
g.GV_SPE = pk.IV_SPE == 0 ? (byte)0 : GetMaxGanbaru(pk.IV_SPE);
|
|
g.GV_SPA = GetMaxGanbaru(pk.IV_SPA);
|
|
g.GV_SPD = GetMaxGanbaru(pk.IV_SPD);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the values are at the favorable maximum per <see cref="SetSuggestedGanbaruValues"/>.
|
|
/// </summary>
|
|
public static bool IsGanbaruValuesMax(this IGanbaru g, PKM pk)
|
|
{
|
|
var result = true;
|
|
result &= g.GV_HP == GetMaxGanbaru(pk.IV_HP);
|
|
result &= g.GV_ATK >= (pk.IV_ATK == 0 ? 0 : GetMaxGanbaru(pk.IV_ATK));
|
|
result &= g.GV_DEF == GetMaxGanbaru(pk.IV_DEF);
|
|
result &= g.GV_SPE >= (pk.IV_SPE == 0 ? 0 : GetMaxGanbaru(pk.IV_SPE));
|
|
result &= g.GV_SPA == GetMaxGanbaru(pk.IV_SPA);
|
|
result &= g.GV_SPD == GetMaxGanbaru(pk.IV_SPD);
|
|
return result;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Sets all values to 0.
|
|
/// </summary>
|
|
public static void ClearGanbaruValues(this IGanbaru g)
|
|
{
|
|
g.GV_HP = 0;
|
|
g.GV_ATK = 0;
|
|
g.GV_DEF = 0;
|
|
g.GV_SPE = 0;
|
|
g.GV_SPA = 0;
|
|
g.GV_SPD = 0;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the stat calculation modifier using the saved <see cref="gv"/> and base <see cref="iv"/>.
|
|
/// </summary>
|
|
public static byte GetGanbaruMultiplier(byte gv, int iv) => GanbaruMultiplier[Math.Min(gv + GetBias(iv), TrueMax)];
|
|
|
|
/// <summary>
|
|
/// Sets one of the <see cref="IGanbaru"/> values based on its index within the array.
|
|
/// </summary>
|
|
/// <param name="pk">Pokémon to modify.</param>
|
|
/// <param name="index">Index to set to</param>
|
|
/// <param name="value">Value to set</param>
|
|
public static byte SetGV(this IGanbaru pk, int index, byte value) => index switch
|
|
{
|
|
0 => pk.GV_HP = value,
|
|
1 => pk.GV_ATK = value,
|
|
2 => pk.GV_DEF = value,
|
|
3 => pk.GV_SPE = value,
|
|
4 => pk.GV_SPA = value,
|
|
5 => pk.GV_SPD = value,
|
|
_ => throw new ArgumentOutOfRangeException(nameof(index)),
|
|
};
|
|
|
|
/// <summary>
|
|
/// Sets one of the <see cref="IGanbaru"/> values based on its index within the array.
|
|
/// </summary>
|
|
/// <param name="pk">Pokémon to check.</param>
|
|
/// <param name="index">Index to get</param>
|
|
public static byte GetGV(this IGanbaru pk, int index) => index switch
|
|
{
|
|
0 => pk.GV_HP,
|
|
1 => pk.GV_ATK,
|
|
2 => pk.GV_DEF,
|
|
3 => pk.GV_SPE,
|
|
4 => pk.GV_SPA,
|
|
5 => pk.GV_SPD,
|
|
_ => throw new ArgumentOutOfRangeException(nameof(index)),
|
|
};
|
|
|
|
/// <summary>
|
|
/// Checks if any of the <see cref="IGanbaru"/> values are below a reference's minimum value.
|
|
/// </summary>
|
|
/// <param name="pk">Pokémon to check.</param>
|
|
/// <param name="obj">Reference to check</param>
|
|
public static bool IsGanbaruValuesBelow(this IGanbaru pk, IGanbaru obj)
|
|
{
|
|
if (pk.GV_HP < obj.GV_HP)
|
|
return true;
|
|
if (pk.GV_ATK < obj.GV_ATK)
|
|
return true;
|
|
if (pk.GV_DEF < obj.GV_DEF)
|
|
return true;
|
|
if (pk.GV_SPA < obj.GV_SPA)
|
|
return true;
|
|
if (pk.GV_SPD < obj.GV_SPD)
|
|
return true;
|
|
if (pk.GV_SPE < obj.GV_SPE)
|
|
return true;
|
|
return false;
|
|
}
|
|
}
|