Sapphire AI guide

TABLE OF CONTENTS
I. Basic AI principles
II. AI by fight
III. Notes by fight

NOTE: Sapphire's code has been only partially disassembled, so this guide is based mostly on observations and may not be 100% accurate.

----------------------
I. BASIC AI PRINCIPLES
----------------------
- There are many AI clauses. Which clauses are in effect depends on trainer class, but given our current knowledge, it's easiest to simplify trainers as having "good AI" or "bad AI"
- Characteristics of good AI (some exceptions apply):
	> Always try to OHKO if possible. This overrides most other decisions
	> Favor stat-increasing or stat-lowering moves on the first turn of battle (e.g., Harden, Bulk Up, Growl)
	> Choose most damaging move (e.g., Rock Throw over Tackle)
	> If multiple moves will kill, select one at random
	> If faster than the player (you), do not use a Speed-lowering move
	> "Ignore" fixed-damage moves such as Seismic Toss and Sonicboom (they can be used but are never encouraged or discouraged)
	> Discourage confusion moves when the player is at low HP (e.g., Supersonic, Confuse Ray)
	> Dismiss useless moves (e.g., Supersonic if already confused)
- Characteristics of bad AI:
	> Select a move at random
	> Dismiss useless moves in some cases, but not all
	> Do not calculate damage
- When calculating damage, the AI first "simulates" a roll. This is separate from the actual roll that occurs if the move is chosen. For example, if you have 13 HP and a trainer with good AI has one attacking move that does 12-15 damage, it will always choose that move if the simulated roll is 13, 14 or 15, but not necessarily if the simulated roll is 12.
- In double battles, the AI selects a target randomly, then proceeds as normal
- All wild Pokemon will choose a move at random under all circumstances

----------------------
II. AI BY FIGHT
----------------------
Rival 1			Good
Calvin			Bad
Grunt			Bad
Josh			Bad
Tommy			Bad
Roxanne			Good
Clark			Bad
Grunt			Bad
Joey/Jose		Bad
Laura			Bad
Brawly			Good
Grunt			Bad
Grunt			Bad
Rival 2			Good
Wally			Good
Vivian			Bad
Shawn			Bad
Wattson			Good
CTB				Good
Grunt			Bad
Matt			Good
Archie 1		Good
Flannery		Good
Mary			Good
Lori			Good
Berke			Good
Norman			Good
Grunt			Bad
Grunt			Bad
Shelly			Good
Rival 3			Good
Jared			Bad
Kylee			Bad
Winona			Good
Grunt			Bad
Grunt			Bad
Grunt			Bad
Matt			Good
Samantha		Bad
T&L				Good
Shelly			Good
Archie 2		Good
Wallace			Good
Hope			Good
Shannon			Good
Julie			Good
Edgar			Good
Wally			Good
Sidney			Good
Phoebe			Good
Glacia			Good
Drake			Good
Champion		Good

----------------------
III. NOTES BY FIGHT
----------------------
These fights follow "good AI" rules unless otherwise noted. Also see this paste: https://pastebin.com/fhayLRVE

RIVAL 1
- Seems to discourage Leer after turn 1, but can still use it
- Seems to never use Leer when you're below 70% HP
ROXANNE
- Favors Rock Tomb if Mudkip is faster; can't be used otherwise
- Favors Harden on turn 1
- Favors Harden on the turn after you use Growl (~75% likely if nothing else is favored)
- Occasionally uses Tackle even when it can't kill
BRAWLY
- Seems to discourage Leer at all times
- Seems to discourage Bulk Up on subsequent uses
- Arm Thrust's damage calculation only includes the first hit (so 6 HP is generally safe)
RIVAL 2
- Dismisses Growl if your HP is 70% or less (usually 40/57)
- Dismisses Growl on turn 2+ if your Attack stage is 1+
- Rarely uses Growl on turn 2+ if your Attack stage is <1
- Always uses QA if it kills
- Splash is not considered a useless move
WALLY
- Generally spams Double Team
WATTSON
- Discourages Supersonic if your HP is 70% or less; dismisses it at 50% or less
- Voltorb rarely uses Selfdestruct
CTB
- Dismisses Growl if your HP is 70% or less (usually 49/70)
- Dismisses Supersonic if your HP is 50% or less
- Roselia usually uses Stun Spore if Mega Drain doesn't kill
ARCHIE 1
- Discourages Sand-Attack if your HP is 50% or less
- Dismisses Supersonic if your HP is 50% or less
- Sharpedo almost never uses Crunch if it can't kill
FLANNERY
- Slugma is ~40% likely to use Smog, ~30% to Light Screen and ~30% to Sunny Day
- Slugma cannot use Light Screen if it has 50% HP or less
- Slugma cannot use Sunny Day if it has 40% HP or less
- Dismisses Overheat unless it can kill
- Body Slam is ~60% likely, Attract 40%
MARY
- Favors Sing
LORI
- Favors Headbutt
BERKE
- Favors Swords Dance
NORMAN
- Slightly discourages Yawn
- Does not dismiss Yawn if you are asleep
- Never uses Encore
- Second Slaking seems to weigh moves based on damage (Focus Punch is favored, but not guaranteed, when kill AI is the same between moves; Facade is favored over Faint Attack as well)
SHELLY
- Swagger seems unaffected by "confusion move" AI
WINONA
- Favors Double Team
- Favors Protect
- Dismisses Supersonic if your HP is 50% or less
- Discourages Sand-Attack if your HP is 50% or less
- Favors Dragon Dance
MATT
- Dismisses Screech if your HP is 50% or less
T&L
- See this paste: http://pastebin.com/dDCH7V19
SHELLY
- Dismisses Screech if your HP is 50% or less
- Can spam Taunt
- Favors Scary Face, then Swagger
ARCHIE 2
- Favors Scary Face, then Swagger
- Dismisses Confuse Ray if your HP is 50% or less
- Always uses Roar if you are +3 in Attack or Sp. Atk
WALLACE
- Milotic favors Recover if it is below 50% HP
WALLY
- Favors Double Team and Calm Mind
SIDNEY
- Discourages Sand-Attack if your HP is 50% or less
- Favors Double Team
PHOEBE
- First Dusclops is ~30% to use Curse
- Dismisses Confuse Ray if your HP is 50% or less
GLACIA
- Always uses Hail if it's raining
DRAKE
- Shelgon is ~80% to use Rock Tomb, ~10% to Protect and ~10% to Dragon Claw
STEVEN
- Discourages Toxic if your HP is 50% or less
- Dismisses Confuse Ray if your HP is 50% or less