View source for Generation I item codes

'''Item codes''' are assembly instructions encoded in an item list (either the item pack or the player's PC). They are used as payloads of [[arbitrary code execution]] exploits, and are usually the most convenient for that purpose, because the contents of an item list are easy to manipulate (e.g. by switching and tossing items).

For a list of hex values for all Generation I Items and their corresponding assembly instructions, see [[the Big HEX List]].

Most of the following example setups are for the glitch item [[ItemDex/RB:093|8F]]. The most popular bootstrap strategies for 8F jumps to the '''third item in the item pack''' ($D322 in English R/B, $D321 in English Yellow), leaving the first two item slots for 8F itself and possibly any item (that is not part of the code) to be manipulated. Most setups work for all other methods of ACE, such as [[ItemDex/RB:106|-gm]] or [[Arbitrary code execution#Via text boxes|text box ACE]], as long as they jump to the third item in the item pack during bootstrap.

Some of the item codes further assume that the jump is made by a "jp hl" instruction, which means that hl also contains the address of the third item. That means those item codes will not work with the "super-compressed" setups that jump to the code with "jp $xxyy" (or any other jump instruction), unless further steps are taken to set hl to the desired value.

See [http://forums.glitchcity.info/index.php?topic=6638.0 the forum topic on 8F] for more examples of item codes. Item codes can also be generated from assembly code with the help of tools like [[GBz80 to Items]], or by manually referring to [[the Big HEX List]].

== Fix -gm bootstrap ==
Due to limitations on space and the available character set, the [[ItemDex/RB:106#Initial luckytyphlosion bootstrap|initial bootstrap strategy for -gm]] designed by luckytyphlosion jumps to the ''second'' item in the item pack, which might make it inconvenient to make use of existing item codes and/or manipulate items. The below item code<ref name="lucky_guide">[https://pastebin.com/iGyyJstG Rough -gm guide (v0.1)] by luckytyphlosion</ref> is designed to fix this by modifying the initial bootstrap, inserting two "inc hl" instructions before "jp hl":
 -gm
 Thunderstone x1
 TM17 x2
 X Accuracy x79
 Protein x2
 Antidote x62
 HP Up x2
 Water Stone x2
 Burn Heal x34
 Parlyz Heal x62
 TM33 x2
 X Speed x34
 TM01 x[any qty]

After setting up the item list and using -gm once, the jump target of -gm will be changed to the third item in the item pack.

The code is designed to be spelled with distinct items that are easy to buy in the Celadon Department Store. As a result, there are a lot of dummy instructions that can be adjusted according to the player's situation.
 <b>ld hl, $D901</b>
 ld [bc], a
 <b>ld l, $4F</b>
 <b>inc h</b>        ; hl = $DA4F
 ld [bc], a
 dec bc
 <b>ld a, $23</b>    ; opcode for "inc hl"
 ld [bc], a
 <b>ld [hli], a</b>
 ld [bc], a
 inc c
 <b>ld [hli], a</b>
 rrca
 <b>ld a, $E9</b>    ; opcode for "jp hl"
 ld [bc], a
 ld b,e
 <b>ld [hli], a</b>
 <b>ret</b>

==Non-key item duplication==
 8F
 The item to duplicate x1
 X Accuracy x33 (Red/Blue)  OR  X Accuracy x32 (Yellow)
 Revive x201

To obtain the 201 Revive stack, have Revive x73 in the sixth item pack slot, then encounter / capture MissingNo or 'M. It will be a stack of 201 Revives.

Upon using 8F, the quantity of item #2 will be decreased by one. If there was only one item, it will be a stack of zero items. Tossing one of these rolls the quantity back to 255.

==Obtain any item(Red/Blue, compressed)==
Note: This code does not work with the super-compressed 3 to 5 Pokemon setup.

 8F
 [Item to morph] x[any qty]
 TM03 x141
 Full Heal x201  OR  Revive x201

To obtain the TM03 x141 and Full Heal x201 stacks, have TM03 x13 or Full Heal x73 in the sixth item pack slot, then encounter/capture MISSINGNO. or 'M. Alternatively, the "Non-Key item duplication" code above can be run, and tossing TM03 x115 or Full Heal x55 will give the correct quantity.

Upon using 8F, the item in your second item pack slot will morph to the item with the next or previous index number, depending on whether Full Heals or Revives are used. Refer to the [[ItemDex]] to see which items will result.

==Obtain any item==
 8F
 [Item to morph] x[any qty]
 Thunderstone x32 (Red/Blue)  OR  Thunderstone x31 (Yellow)
 TM11 x52  OR  TM11 x53
 TM01 x[any qty]

Upon using 8F, the item in your second item pack slot will morph to the item with the next or previous index number, depending on whether TM11 x52 or x53 was used. Refer to the ItemDex to see which items will result.

==Gameshark-like code==
The following item list will work the same way a game-altering device does.

 8F
 Any item x Any qty
 X Accuracy x(b2)
 Carbon x(b3)
 Max Revive x(b1)
 Poké Ball x201

To obtain the 201 Poké Balls stack, have Poké Balls x73 in the sixth item pack slot, then encounter / capture MissingNo or 'M. It will be a stack of 201 Poké Balls. It is also possible to use the Non-key items duplication code.

This code aims to write code like the Gameshark code "01(b1)(b2)(b3)".

For example, the code 010138CD, which allows to walk through walls, can be transcripted into the following:

 X Accuracy x56
 Carbon x205
 Max Revive x1
 Poké Ball x201

==Get any Pokémon==
The easiest way to get any Pokémon is to use the above "Gameshark-like code" to write the internal ID (see [[the Big HEX List]]) to $D059 (Red/Blue) or $D058 (Yellow). This triggers an encounter with the Pokémon, which can then be caught by a Master Ball (easily obtainable using the previous codes).

An alternative way is to directly give the Pokémon to the player (like how Eevee is legitimately obtained in the game). The advantage is that some glitch Pokémon that cannot be encountered using the "instant encounter" method (ID = 0 or >= 200) can still be acquired this way.

 8F
 Any item x Any qty
 Repel x[SpeciesIndex]
 X Speed x14
 Ultra Ball x64
 TM05 x72 (Red/Blue)  OR  TM05 x89 (Yellow)
 Lemonade x201

Note: Pokémon obtained this way are registered in the Pokédex, so getting [[MissingNo.]] this way will duplicate the 6th item. It would be necessary to toss TM05 x128 before using the code again.

== References ==
<references />
[[Category:Arbitrary code execution]]