sprite hit hack, softscale fix

[fceu.git] / out_gp2x / readme_cheat.txt

\r
\r
  FCE Ultra Cheat Guide\r
\r
***** This file was obtained from *****\r
http://mednafen.com/documentation/cheat.html\r
\r
\r
/Last updated November 12, 2003\r
Valid as of FCE Ultra 0.97.4/\r
\r
*Table of Contents:*\r
\r
    * Introduction <#intro>\r
          o Cheat Files <#cheatfiles> \r
    * The Windows Interface <#windows>\r
          o Cheat Search Interface <#windows-search> \r
    * The Text Interface(TODO)\r
    * Examples <#examples>\r
          o "Mega Man 3" Windows Example <#examples-mm3>\r
          o "Over Horizon" Text Interface Example <#examples-oh> \r
    * Tips <#tips> \r
\r
------------------------------------------------------------------------\r
\r
\r
    Introduction\r
\r
FCE Ultra allows cheating by the periodic "patching" of arbitrary\r
addresses in the 6502's memory space with arbitrary values, as well as\r
read substitution. "Read substitution" is the method that would be used\r
on a real NES/Famicom, such as done by the Game Genie and Pro Action\r
Replay. It is required to support GG and PAR codes, but since it is\r
relatively slow when done in emulation, it is not the preferred method\r
when a RAM patch will suffice. Also, in FCE Ultra, read substitution\r
will not work properly with zero-page addressing modes(instructions that\r
operate on RAM at $0000 through $00FF).\r
\r
The RAM patches are all applied a short time before the emulated\r
vertical blanking period. This detail shouldn't concern most people,\r
though. However, this does mean that cheating with games that use\r
bank-switched RAM may be problematic. Fortunately, such games are not\r
very common(in relation to the total number of NES and Famicom games).\r
\r
\r
      Cheat Files\r
\r
Cheats are stored in the "cheats" subdirectory under the base FCE Ultra\r
directory. The files are in a simple plain-text format. Each line\r
represents a one-byte memory patch. The format is as follows(text in\r
brackets [] represents optional parameters):\r
\r
    [S][C][:]Address(hex):Value(hex):[Compare value:]Description \r
\r
Example:\r
\r
    040e:05:Infinite super power.\r
\r
A colon(:) near the beginning of the line is used to disable the cheat.\r
"S" denotes a cheat that is a read-substitute-style cheat(such as with\r
Game Genie cheats), and a "C" denotes that the cheat has a compare value.\r
\r
------------------------------------------------------------------------\r
\r
\r
    The Windows Interface\r
\r
All addresses listed in the cheats window are in unsigned 16-bit\r
hexadecimal format and all values in these windows are in an unsigned\r
8-bit decimal format(the range for values is 0 through 255).\r
\r
The cheats window contains the list of cheats for the currently loaded\r
game on the right side. Existing cheats can be selected, edited, and\r
updated using the "Update" button.\r
\r
\r
      Cheat Search Interface\r
\r
The cheat search interface consists of several components: a list of\r
addresses and associated data for a search, several command buttons, and\r
the search parameters.\r
\r
Each entry in the list is in the format of:\r
\r
    Address:Original Value:Current Value\r
\r
The address is the location in the 6502's address space, the original\r
value is the value that was stored at this address when the search was\r
reset, and the current value is the value that is currently stored at\r
that address. Selecting an item in this list will automatically cause\r
the "Address" field in the cheat information box on the right side of\r
the window to be updated with the selected address.\r
\r
The "Reset Search" button resets the search process; all valid addresses\r
are displayed in the cheat list and the data values at those addresses\r
noted.\r
\r
The "Do Search" buttons performs a search based on the search parameters\r
and removes any non-matching addresses from the address list.\r
\r
The "Set Original to Current" button sets the remembered original values\r
to the current values. It is like the "Reset Search" button, but it does\r
not affect which addresses are shown in the address list. This command\r
is especially useful when used in conjunction with the "O!=C" search\r
filter.\r
\r
The "Unhide Excluded" button shows all addresses that are excluded as a\r
result of any previous searches. It is like the "Reset Search" button\r
except that it does not affect the remembered original values.\r
\r
The numbers assigned the names "V1" and "V2" have different meanings\r
based on which filter is selected. A list of the names of the filters\r
and detailed information on what they do follows("original value"\r
corresponds to the value remembered for a given addres and "current\r
value" is the value currently at that address. Also, if a value is not\r
explicitly said to be shown under a certain condition, then it is\r
obviously excluded.):\r
\r
"O==V1 && C==V2":\r
\r
    Show the address if the original value is equal to "V1" AND the\r
    current value is equal to "V2". \r
\r
"O==V1 && |O-C|==V2":\r
\r
    Show the address if the original value is equal to "V1" AND the\r
    difference between the current value and the original value is equal\r
    to "V2". \r
\r
"|O-C|==V2":\r
\r
    Show the address if the difference between the current value and the\r
    original value is equal to "V2". \r
\r
"O!=C":\r
\r
    Show the address if the original value does not equal the current\r
    value. \r
\r
The following cheat methods/filters automatically perform the function\r
of the "Set Original to Current" button after "Do Search" is pressed.\r
\r
"Value decreased."\r
\r
    Show the address if the value has decreased. \r
\r
"Value increased."\r
\r
    Show the address if the value has increased. \r
\r
------------------------------------------------------------------------\r
\r
\r
    Examples\r
\r
\r
      "Mega Man 3" Windows Example\r
\r
This example will give Mega Man unlimited energy. Immediately after\r
entering the Top Man stage, make your way to the "Add Cheat" window.\r
Push "Reset Search". Go back to playing and move right until the first\r
enemy appears. Allow yourself to be hit twice. Each hit does "2" damage,\r
so you've lost 4 energy bars. Go to the "Add Cheat" window again and\r
select the third filter ("|O-C|==V2") and enter the value 4 next to\r
"V2". Then push "Do Search".\r
\r
Several addresses will appear in the address list. You can try to find\r
the address you want through trial and error, or you can narrow the\r
results down further. We will do the latter.\r
\r
Go back to playing MM3 and get hit one more time and make your way back\r
to the "Add Cheat" window. Your damage is now "6". You can probably see\r
which address that contains your life(it is 00A2). If not, change V2 to\r
6 and push "Do Search" again. This should leave only 00A2.\r
\r
Select that entry in the address list. Shift your attention to the "Add\r
Cheat" box to the right. Type in a meaningful name and the desired\r
value(156; it was the value when you had no damage, so it's safe to\r
assume it's the maximum value you can use). Push the "Add" button and a\r
new entry will appear in the cheats list. The cheat has been added.\r
\r
\r
      "Over Horizon" Text Interface Example\r
\r
This example will give you infinite lives in the NTSC(Japanese) version\r
of "Over Horizon".\r
\r
Start a new game. Notice that when you press "Start" during gameplay,\r
the number of lives you have left is indicated. With no cheating, you\r
start with 3 lives(2 lives left).\r
\r
Activate the cheat interface immediately after starting a new game.\r
Select the "New Cheats" menu and "Reset Search".\r
\r
I'll assume that the number of lives left shown in the game is the same\r
number that's stored in RAM. Now, "Do Search". You're going to use the\r
first search filter. For V1, enter the value 2. For V2, enter the same\r
value. This, coupled with the fact that you just reset the search, will\r
allow you to search for a value "absolutely"(as opposed to changes in\r
the value).\r
\r
Now, "Show Results". When I did it, I received 11 results:\r
\r
	 1) $0000:002:002\r
	 2) $001c:002:002\r
	 3) $001e:002:002\r
	 4) $009d:002:002\r
	 5) $00b9:002:002\r
	 6) $00e3:002:002\r
	 7) $0405:002:002\r
	 8) $0406:002:002\r
	 9) $0695:002:002\r
	10) $07d5:002:002	\r
	11) $07f8:002:002\r
\r
You really can't do much yet(unless you want to spend time doing trial\r
and error cheat additions). Return to the game.\r
\r
After losing a life, go back to the cheat interface, to the "New Cheats"\r
menu, and "Show Results". Here are my results:\r
\r
	 1) $0000:002:002\r
	 2) $001c:002:002\r
	 3) $001e:002:002\r
	 4) $009d:002:002\r
	 5) $00b9:002:041\r
	 6) $00e3:002:002\r
	 7) $0405:002:001\r
	 8) $0406:002:002\r
	 9) $0695:002:002\r
	10) $07d5:002:001\r
	11) $07f8:002:002\r
\r
Notice that two addresses seem to hold the number of lives($0405 and\r
$07d5). You can lose another life and go "Show Results" again, and you\r
should see that $07d5 is the address that holds the number of lives.\r
\r
Now that you know the address that holds the number of lives, you can\r
add a cheat. You can either type in the number from the cheat results\r
list corresponding to the address you want to add a cheat for, or you\r
can remember the address and select "Add Cheat" from the "New Cheats"\r
menu. Do the former.\r
\r
Now you will need to enter a name for the cheat. I suggest something\r
short, but descriptive. "Infinite lives" will work fine. Next, a prompt\r
for the address will show up. Since you selected an item from the list,\r
you can press enter to use the associated address($07d5). Next, you will\r
need to enter a value. It doesn't need to be large(in fact, it probably\r
shouldn't be; abnormally high numbers can cause some games to\r
misbehave). I suggest a value of 2. After this, you should get a prompt\r
that looks like this:\r
\r
   Add cheat "Infinite lives" for address $07d5 with value 002?(Y/N)[N]:\r
\r
Answer "Y". You now have infinite lives.\r
\r
------------------------------------------------------------------------\r
\r
\r
    Tips\r
\r
Games store player information in many different ways. For example, if\r
you have "3" lives in Super Wacky Dodgeball 1989, the game might store\r
it in memory as 2, 3, or 4, or perhaps a different number all together.\r
Also, say that you have 69 life points out of 200 in Mole Mashers. The\r
game might store how many life points you have, or how much damage you\r
have taken. Relative value searches are very valuable because you\r
probably don't know the way that the game stores its player data.\r
\r
Some games, especially RPGs, deal with individual numbers greater than\r
8-bits in size. Most that I've seen seem to store the multiple-byte data\r
least significant byte(lower byte of number) first in memory, though\r
conceivably, it could be stored most significant byte first, or the\r
component bytes of the number could be non-contiguous, though the latter\r
is very unlikely. For example, say I have 5304 experience points in\r
Boring Quest for the Overused Plot Device. To split the number into two\r
eight bit decimal numbers, take 5304 %(modulus) 256. This will give a\r
number that is the lower 8 bits. Next, take 5304 / 256. The integral\r
component of your answer will be the upper 8 bits(or the next 8 bits, if\r
the number is or can be larger than 16 bits) of 5304. Now you will need\r
to search for these numbers. Fortunately, most(all?) RPGs seem to store\r
large numbers exactly as they are shown in the game.\r
\r