<p>-"Break on bad opcode" feature; this can help you figure out where your game is crashing. Middle-clicking on a byte will bring up the <aclass=rvts13href="{ACA99B5B-9CA3-4E69-B7F7-106D70CF76BF}.htm">Game Genie Encoder</a> at that address, so you can easily make Game Genie codes.</p>
<p>The most important feature (at least for me) that was introduced in FCEUXD SP is symbolic debugging. With this new feature it's possible to rename addresses in the disassembly window (like $C022) to easily understandable names (like AddHealthpoints). It's also possible to add comments to lines in the disassembly window.</p>
<p>To be able to use this feature it's necessary to create so called name list files (*.(bank).nl/*.ram.nl, Ex: NES Test Cart (PD).nes.0.nl, NES Test Cart (PD).nes.ram.nl) which contain all names and comments you wish to display in the disassembly window. These files are plain ASCII files of the following format (example follows):</p>
<p>Every line contains two # characters which separate the three parts of one line: The first part (starting with a $ character) is the address to be renamed. Optionally you can add a "/number" part which marks the offsets as a beginning of an array of the given size (the size must be specified in hex form). The second (optional) part is the new name of that address. Whenever the line of that address is shown in the disassembly window an extra line saying "Name: NewName" is shown above it. Instructions referencing this address, for example JSR $C000 are also changed to JSR NewName1 (in that example). The third (optional) part is the comment that's also added above the disassembly line the comment refers to. It works exactly like the additional name line, only the prefix of that line is different. Comment lines start with "Comment: " rather than with "Name: ". Multi-lines comments are possible. Lines starting with a \ character are just appended to the comment of the preceding line. Multi-line comments are also shown in multiple lines in the disassembly window.</p>
<p><br></p>
<p>Let's get back to the example.</p>
<p>The first line contains all three parts. Using this name list file all references to the address</p>
<p>$C000 are replaced with NewName1 and whenever line $C000 is shown in the disassembly window an</p>
<p>additional comment is also visible right above the actual disassembled line.</p>
<p>The second line defines only a comment while the third line defines only a name. Following that</p>
<p>there's a multi-line comment definition for address $C006.</p>
<p>The last line defines an array called NewName4 of size $10 (= 16) bytes starting at offset $C008.</p>
<p><br></p>
<p>Now you know the format of the nl files but you do not yet know the naming convention for the</p>
<p>file names. Due to the bank-swapping nature of the NES it's getting a little bit difficult here.</p>
<p>Each bank needs it's own nl file. The naming convention goes like this: Take the name of the ROM</p>
<p>file and just add ".X.nl" to it where the X is the hexadecimal representation of the number of the</p>
<p>ROM bank. Suppose you have the ROM file "Faxanadu (U).nes" and you want to create a nl file for</p>
<p>ROM bank 15. As 15 is 0x0F in hex the name of the nl file would be "Faxanadu (U).nes.F.nl". All</p>
<p>nl files go into the same directory as the ROM file itself.</p>
<p>You can enable and disable symbolic debugging by clicking the checkbox "Symbolic Debugging" in</p>
<p>the debugger window. To forcibly reload the nl files of the currently active ROM file press the</p>
<p>button with the text "Reload Symbols".</p>
<p><br></p>
<p><br></p>
<p><spanclass=rvts12>Arrays</span></p>
<p><br></p>
<p>The array feature is an easy way to group names and comments for sequential offsets.</p>
<p><br></p>
<p>$C000/5#NewName1#Comment1</p>
<p><br></p>
<p>is equivalent to</p>
<p><br></p>
<p>$C000#NewName1#Comment1</p>
<p><spanclass=rvts11><br></span></p>
<p><br></p>
<p><spanclass=rvts12>Inline Assembler</span></p>
<p><br></p>
<p>The debugger an Inline Assembler designed by Parasyte. To activate it, left-click in the left pane of the debugger, beside the assembly display. To use it, type in some code and press Enter to add it to the patch list. If you make a mistake, press "Undo". Once the patch is set up the way you want it, press "Apply". Be aware that this cannot be undone unless you reload the ROM. Parasyte implemented this feature before I had the Hex Editor working, otherwise I would have implemented a way to undo it from there. Press "Save" to write to the ROM file on disk; note that this will also save any changes you may have done in the Hex Editor.</p>
<pclass=rvps4><spanclass=rvts16>This help file has been generated by the freeware version of </span><aclass=rvts17href="http://www.ibe-software.com/products/software/helpndoc/"target="_blank">HelpNDoc</a></p>
