Pokémon HeartGold and SoulSilver (pret/pokeheartgold)

HeartGold and SoulSilver (the US releases, which share this code) split the clock's hour into five periods with a 24-entry table: morning from 4:00 to 9:59, day from 10:00 to 16:59, evening from 17:00 to 19:59, night from 20:00 to 23:59, and late night from 0:00 to 3:59. Platinum's table gives every hour the same period (its names are morning, day, twilight, night, and late night). Gold and Silver have three periods: morning from 4:00, day from 10:00, and night from 18:00. pokeheartgold/time-of-day

About: Pokémon HeartGold and SoulSilver Time of day

{
 "morning": [
  4,
  10
 ],
 "day": [
  10,
  17
 ],
 "evening": [
  17,
  20
 ],
 "night": [
  20,
  24
 ],
 "lateNight": [
  0,
  4
 ],
 "goldSilver": {
  "morning": [
   4,
   10
  ],
  "day": [
   10,
   18
  ],
  "night": [
   18,
   4
  ]
 }
}

Cited by: Pokémon HeartGold and SoulSilver, Time of day

HeartGold and SoulSilver fold the five periods into three for wild Pokémon (GF_RTC_GetTimeOfDayWildParamByHour: morning; day or evening; night or late night), and grass encounters pick their species list the same way. IsNighttime is true at night or late night, so from 20:00 to 3:59 (computed from the hour table), and the evolution methods tied to the clock read it: friendship of at least 220 by day (EVO_FRIENDSHIP_DAY) or by night (EVO_FRIENDSHIP_NIGHT), and a held item by day or by night (EVO_ITEM_DAY, EVO_ITEM_NIGHT). pokeheartgold/time-of-day-readers

About: Pokémon HeartGold and SoulSilver Time of day

{
 "wild": {
  "morning": [
   "morning"
  ],
  "day": [
   "day",
   "evening"
  ],
  "night": [
   "night",
   "lateNight"
  ]
 },
 "isNighttime": [
  20,
  4
 ],
 "friendship": 220
}

Cited by: Evolution, Pokémon HeartGold and SoulSilver, Time of day

When a step ends on grass or water, HeartGold and SoulSilver roll twice, each LCRandom() % 100. The first roll must fall below a gate that starts at 40, loses 20 unless the player is cycling or surfing or an unnamed avatar check (sub_0205DE98, still assembly) passes, gains 40 in very tall grass or else 30 when cycling, gains 30, 40, or 60 once a counter of reversed facings (reverseTurnFrameSteps) reaches 2, 3, or 4, and gains or loses 25 for the Pokémon March or the Pokémon Lullaby on the radio, capped at 100. The second must fall below the map's own rate for that terrain, capped at 100. A check comes only once a step counter (encounterInhibitSteps), which a wild battle or a warp clears, is past 3. Platinum's gate is 40, plus 30 in very tall grass or when cycling, adjusted on special dates, with no walking penalty, facing counter, or radio. Before its gate, Platinum adds a grace roll: while its count of attempts is below $8-\min (\lfloor r/10\rfloor ,8)$ for the rate $r$ it is passed (computed), each attempt adds 1 to the count and goes on only if LCRNG_RandMod(100) is below 5; a comment says this covers the first attempts after each map transition or wild battle. HeartGold and SoulSilver's check has no such roll; they skip the check outright while the step counter is 3 or less. pokeheartgold/encounter-rate

About: Pokémon HeartGold and SoulSilver Random encounter

{
 "gate": {
  "base": 40,
  "onFoot": -20,
  "veryTallGrass": 40,
  "cycling": 30,
  "reversals": {
   "2": 30,
   "3": 40,
   "4": 60
  },
  "march": 25,
  "lullaby": -25,
  "cap": 100
 },
 "rate": "map rate in 100, cap 100",
 "skipWhileCounterAtMost": 3
}

The step counter goes up by 1 in FieldSystem_CheckWildEncounter before the check runs, so after it is cleared the next three checks are skipped. A header comment on encounterInhibitSteps reads "don't generate an encounter in the first 4 steps on a new map".

Cited by: Pokémon HeartGold and SoulSilver

Before the two rolls, HeartGold and SoulSilver adjust the map's rate in this order: the lead Pokémon's ability (unless it is an Egg) doubles it for Arena Trap, No Guard, or Illuminate, halves it for White Smoke, Quick Feet, or Stench, or for Snow Cloak in snow, capped at 100; the Black Flute halves it and the White Flute raises it by half; and a Cleanse Tag or Pure Incense held by the lead Pokémon cuts it to 2/3. Gold and Silver instead double the rate for the Pokémon March or the Ruins of Alph radio and halve it for the Pokémon Lullaby or a Cleanse Tag. pokeheartgold/encounter-rate-modifiers

About: Pokémon HeartGold and SoulSilver Random encounter

{
 "abilityDouble": [
  "arena-trap",
  "no-guard",
  "illuminate"
 ],
 "abilityHalve": [
  "white-smoke",
  "quick-feet",
  "stench",
  "snow-cloak (snow)"
 ],
 "blackFlute": 0.5,
 "whiteFlute": 1.5,
 "cleanseTag": "×2/3"
}

Gold's radio and Cleanse Tag effects are read from the disassembly's comments over the routines, as in pokegold/encounter-rate.

Cited by: Pokémon HeartGold and SoulSilver

HeartGold and SoulSilver have 12 grass slots and 5 surfing slots, picked by one LCRandom() % 100 against bounds in EncounterSlot_WildMonSlotRoll_Land and EncounterSlot_WildMonSlotRoll_Surfing, so they come up 20, 20, 10, 10, 10, 10, 5, 5, 4, 4, 1, and 1 percent and 60, 30, 5, 4, and 1 percent (computed from the bounds). Platinum's GetGroundEncounterSlot and GetWaterEncounterSlot have the same bounds. Gold and Silver have 7 grass slots and 3 water slots, with cumulative bounds in GrassMonProbTable (30, 60, 80, 90, 95, 99, 100) and WaterMonProbTable (60, 90, 100), so 30, 30, 20, 10, 5, 4, and 1 percent and 60, 30, and 10 percent (computed from the differences). pokeheartgold/encounter-slots

About: Pokémon HeartGold and SoulSilver Random encounter

{
 "grass": [
  20,
  20,
  10,
  10,
  10,
  10,
  5,
  5,
  4,
  4,
  1,
  1
 ],
 "surf": [
  60,
  30,
  5,
  4,
  1
 ],
 "of": 100,
 "goldSilver": {
  "grass": [
   30,
   30,
   20,
   10,
   5,
   4,
   1
  ],
  "water": [
   60,
   30,
   10
  ]
 }
}

Cited by: Pokémon HeartGold and SoulSilver

A HeartGold or SoulSilver map's encounter record holds one walking rate and three full species lists for its 12 grass slots, morning, day, and night, sharing one list of levels. Gold and Silver keep a separate grass rate for each time of day and three sets of 7 slots. Platinum keeps one 12-slot list and swaps only slots 2 and 3 for their day or night species outside the morning. pokeheartgold/encounter-time-lists

About: Pokémon HeartGold and SoulSilver Random encounter

{
 "hgss": {
  "rates": 1,
  "lists": 3,
  "slots": 12
 },
 "goldSilver": {
  "rates": 3,
  "lists": 3,
  "slots": 7
 },
 "platinum": {
  "rates": 1,
  "timedSlots": [
   2,
   3
  ]
 }
}

Swarms and the Hoenn and Sinnoh Sound radio shows then overwrite some of the 12 HGSS slots (EncSlots_Update_LandSwarm, EncSlotArray_Update_HoennSinnohSounds); not covered here.

Cited by: Pokémon HeartGold and SoulSilver

HeartGold and SoulSilver's BattleSystem_CalculateBallShakes keeps Platinum's capture math: $a=\lfloor \lfloor Cm/10\rfloor (3M-2H)/3M\rfloor$ for catch rate $C$, ball multiplier $m$ in tenths, max HP $M$ and current HP $H$, ×2 for sleep or freeze and ×15/10 for burn, paralysis, poison, or bad poison, a catch at once when $a$ is 255 or more, and otherwise four 16-bit rolls each below $\lfloor 1048560/\sqrt{\sqrt{\lfloor 16711680/a\rfloor }}\rfloor$, with the Master Ball's shakes set to four after the draw. The Ultra, Great, Poké, and Safari Balls keep Platinum's 20, 15, 10, and 15 (an assembly data table in the decompilation), and a Pal Park or tutorial battle always catches. pokeheartgold/capture-same-math

About: Pokémon HeartGold and SoulSilver Capture

{
 "kind": "shake-checks",
 "catchAtOrAbove": 255,
 "numerator": 1048560,
 "inner": 16711680,
 "rolls": 4,
 "status": {
  "sleepOrFreeze": 2,
  "poisonBurnParalysis": 1.5
 },
 "ultra": 20,
 "great": 15,
 "poke": 10,
 "safari": 15
}

Platinum folds the ball multiplier in before dividing by 10 in one expression; HGSS stores the product first. Both compute $\lfloor Cm/10\rfloor$ in unsigned integers.

Cited by: Capture, Pokémon HeartGold and SoulSilver

In HeartGold and SoulSilver the Apricorn balls change the catch rate itself and leave the multiplier at 10, after which the rate is capped at 255 (a negative one becomes 1) and goes through the usual HP and status steps: the Fast Ball ×4 when the wild species' base Speed is 100 or more, the Level Ball ×2 when the attacking battler's (battlerIdAttacker) level is above the wild Pokémon's, ×4 when half its level (rounded down) is above it, and ×8 when a quarter of its level (rounded down) is, the Lure Ball ×3 when fishing, the Love Ball ×8 for the same species of the opposite gender, and the Moon Ball ×4 for the 14 species of the Nidoran, Clefairy, Jigglypuff, and Skitty families listed in an assembly data table. Crystal's Level Ball skips the HP and status steps, and its disassembly's comments mark the Moon Ball as never boosting, the Love Ball as boosting the same gender, and the Fast Ball as boosting only three species. pokeheartgold/apricorn-balls

About: Pokémon HeartGold and SoulSilver Capture

{
 "fast": {
  "times": 4,
  "baseSpeedAtLeast": 100
 },
 "level": [
  2,
  4,
  8
 ],
 "lure": 3,
 "love": 8,
 "moon": {
  "times": 4,
  "species": 14
 },
 "cap": 255,
 "floor": 1
}

The atlas reads battlerIdAttacker as the player's Pokémon on the turn a ball is thrown. The cap and floor run for every ball past the Safari Ball, not only the Apricorn balls.

Cited by: Capture, Pokémon HeartGold and SoulSilver

HeartGold and SoulSilver's Heavy Ball adds 40 to the catch rate at 409.6 kg or more, 30 at 307.2 kg, and 20 at 204.8 kg, reading weight in tenths of a kilogram from the Pokédex data. Below 204.8 kg its last branch tests the catch rate against 1024 instead of the weight, and a catch rate is at most 255, so every lighter Pokémon loses 20 (a result below 0 becomes 1); a comment in the decompilation calls this a mistake. Crystal subtracts 20 only below 102.4 kg and adds nothing from there to 204.8 kg. pokeheartgold/heavy-ball

About: Pokémon HeartGold and SoulSilver Capture

{
 "addByWeightKg": {
  "409.6": 40,
  "307.2": 30,
  "204.8": 20
 },
 "below204_8": -20,
 "crystal": {
  "below102_4": -20,
  "below204_8": 0,
  "below307_2": 20,
  "below409_6": 30,
  "above": 40
 }
}

A catch rate below 20 minus 20 is negative and becomes 1; a catch rate of exactly 20 becomes 0, which the floor leaves at 0. Crystal's heavier bands are read from its comment, and the lookup table under it (.WeightsTable) agrees.

Cited by: Capture, Pokémon HeartGold and SoulSilver

HeartGold and SoulSilver's TryCriticalHit keeps Platinum's critical-hit rule: the stage sum (+2 Focus Energy, +1 for a HOLD_EFFECT_CRITRATE_UP item, +1 Super Luck, +2 for Chansey or Farfetch'd with its own item, plus the move's boosts) capped at 4, a chance of 1 in 16, 8, 4, 3, or 2, blocked by Battle Armor or Shell Armor unless ignored, by Lucky Chant on the target's side, or by bit 15 of the target's move-effect flags (named MOVE_EFFECT_FLAG_LUCKY_CHANT here), and Sniper turning ×2 into ×3. pokeheartgold/critical-chance

About: Pokémon HeartGold and SoulSilver Critical hit

{
 "byStage": [
  16,
  8,
  4,
  3,
  2
 ],
 "cap": 4,
 "sniper": 3
}

Platinum's header comment says its bit-15 flag is never set. The atlas has not checked whether HGSS sets MOVE_EFFECT_FLAG_LUCKY_CHANT, since some of its battle code is still assembly.

Cited by: Pokémon HeartGold and SoulSilver