| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| super:intermediate_guides:credits [2017/12/19 22:23] – nodever2 | super:intermediate_guides:credits [2021/10/14 02:44] (current) – nodever2 |
|---|
| This is a page about editing credits using the credits editor. It can be a bit finicky, and I (Nodever2) was asked to put what I learned about it here. I am by no means an expert on the credits, so __**feel free to add to this page**__ if you learn more! | This is a page about editing credits using the credits editor. It can be a bit finicky, and I (Nodever2) was asked to put what I learned about it here. I am by no means an expert on the credits, so __**feel free to add to this page**__ if you learn more! |
| |
| The bulk of the stuff I learned will be at the end of the document, so even if you've already used the credits editor, **I highly reccomend checking out the last section of this article, "How to NOT Destroy Your Credits"**. | Special thanks to Smiley for researching the credits routines and providing more information for us. |
| |
| First things first, I can refer you to [[http://www.metroidconstruction.com/SMMM/credits.zip | this document]] if you want to learn more about credits editing in general. As of now, this wiki page will only contain some basic tips on actually using the credits editor. | Further reading: [[http://www.metroidconstruction.com/SMMM/credits.zip | This great resource]] can teach you more about the credits in general. It contains additional technical information about the credits. |
| | |
| | ===== Technical Information About The Credits ====== |
| | |
| | The credits are composed of a compressed tilemap (at $97:EEFF) which the game decompresses and precisely loads certain lines from, and displays those lines on-screen. |
| | The game chooses what lines to load based on the credits instruction list at $8C:D91B. This instruction lists' format is as follows: |
| | |
| | ______ Instruction in $8B to execute |
| | | _ Argument for instruction |
| | | | |
| | iiii aaaa |
| | |
| | If the instruction value (''iiii'') is 0000, then the argument (''aaaa'') is a pointer into the uncompressed credits tilemap, telling the game what line of the credits to load (the line pointed to by this pointer). |
| | |
| | My advice (Nodever2 here): SMILE RF's credits editor has.. problems. If you really want the best experience editing the credits, you might be best off doing so without the credits editor; you could use the credits editor to edit and save the credits tilemap, and then repoint the credits instruction list and manually edit it in hex. |
| | SMILE RF seems to not always save the instruction list properly and/or overwrite other data with it without telling you. (This may also be true of the credits tilemap, since it is compressed, so edit that with caution as well). |
| | |
| | The credits tilemap is pointed to by the $D91B here: ''$8B:F6F8 dw 93D9,93D9,D91B'' |
| | If you want to repoint it, start there. (Found by Smiley) |
| |
| ====== Basics of the Credits Editor ====== | ====== Basics of the Credits Editor ====== |
| Here's a quick overview on the credits editor, SMMM-style: | Here's a quick overview on the credits editor, SMMM-style: |
| |
| {{:super:intermediate_guides:creditseditorlabeled.png?700|}} | |
| |
| - Credits placement window | {{:super:intermediate_guides:creditseditorlabeled.png|The Credits Editor}} |
| - Controls for credits placement window | |
| - Credits tile editor | - Credits Line Arranger (aka Credits Instruction List Editor) |
| - (left box): Shows currently selected tile from Credits tile editor | - Controls for Credits Line Arranger |
| | - Credits Tilemap editor |
| | - (left box): Shows currently selected tile from Credits Tilemap editor |
| - (right box): Shows tile that is being hovered over by the mouse cursor | - (right box): Shows tile that is being hovered over by the mouse cursor |
| - Controls for placing tiles into the credits tile editor from the credits tile table (used in conjunction with #7) | - Controls for placing tiles into the Credits Tilemap Editor from the Credits Tile Table (used in conjunction with #7) |
| - Credits tile table | - Credits Tile Table |
| - Save/Reload buttons | - Save/Reload buttons |
| |
| (Names for these boxes are unofficial, if there are better names feel free to replace these names with those. The reason I am defining them here is for reference.) | |
| |
| ---- | ---- |
| |
| ===== Credits Tile Editor ===== | ===== Credits Tilemap Editor ===== |
| |
| If you want to edit names from the credits, it's quite easy. Simple right-click a tile from the Credits Tile Table, and it will show up in Box #4 when selected. Then, click in a line in the Credits Tile Editor to place it on a line there. __note that the credits are broken up into individual lines__. | If you want to edit names from the credits, it's quite easy. Simple right-click a tile from the Credits Tile Table, and it will show up in Box #4 when selected. Then, click in a line in the Credits Tilemap Editor to place it on a line there. __Note that the credits are broken up into individual lines__. |
| |
| I'm assuming the purpose of editing the credits is adding your own, but there isn't a lot of extra lines in the Credits Tile Editor to work with. However, it is disrespectful to remove the names of the Nintendo staff, so I don't recommend doing that. One possible workaround to this problem is to remove the headings from the credits in the Credits placement window (examples of headings: ''PRODUCER, PROGRAM DIRECTOR'', etc.), and then use those lines for your own credits. If you don't have a ton of credits, this will work. if your hack is large enough to need even more lines, then you'll have to do some more advanced editing which is beyond the scope of this tutorial. | I'm assuming the purpose of editing the credits is adding your own, but there isn't a lot of extra lines in the Credits Tilemap Editor to work with. However, it is disrespectful to remove the names of the Nintendo staff, so I don't recommend doing that. One possible workaround to this problem is to remove the headings from the credits in the credits tilemap editor (examples of headings: ''PRODUCER, PROGRAM DIRECTOR'', etc.), and then use those lines for your own credits. If you don't have a ton of credits, this will work. if your hack is large enough to need even more lines, then you'll have to do some more advanced editing which is beyond the scope of this tutorial. |
| |
| ---- | ---- |
| |
| ===== Credits Placement Window ===== | ===== Credits Line Arranger ===== |
| |
| |
| After preparing the lines you want to place/move around, you're ready to move on to the left window (Credits Placement Window). Navigating this window is tricky at first. Here's the basics: You navigate this window by selecting and moving entire lines at a time. Right-click anywhere in this window to select a line, and then use the controls below to edit it. It's that simple! However, there are many pitfalls which you must be careful to avoid, as discussed in the next section..... | After preparing the lines you want to place/move around, you're ready to move on to the left window (Credits Line Arranger). Navigating this window is tricky at first. Here's the basics: You navigate this window by selecting and moving entire lines at a time. Right-click anywhere in this window to select a line, and then use the controls below to edit it. It's that simple! However, there are many pitfalls which you must be careful to avoid, as discussed in the next section..... |
| |
| ---- | ---- |
| A few tips I've learned: | A few tips I've learned: |
| |
| * **MAKE ROM BACKUPS FREQUENTLY!!!** There's a good chance you'll need them, even after reading this. The credits are very finicky. | * **MAKE ROM BACKUPS FREQUENTLY!!!** There's a good chance you'll need them, even after reading this. The credits are very finicky, not to mention how the credits editor likes to crash SMILE. Make sure all other level data edits, etc. are saved too. |
| | |
| | * Make sure you have at least a screen or so of blank space at the end of your credits (shown below) or else the screen won't clear properly, and you will still have credits on the final screens of the game (where you are shown your completion percentage, etc.) |
| | |
| | {{:super:intermediate_guides:brokencreditsexample2.png|An example of credits that don't leave a screen of space at the end, and an example of those that do}} |
| | |
| | //(Notice in this image, the Credits Editor is scrolled all the way to the bottom. You want that empty space!)// |
| | |
| | * Edit the contents of each the Credits Tilemap Editor (box on the right) __//**SEPARATELY**//__ from editing the Credits Line Arranger(box on the left); when changing from one to the other, always save the Line Arranger and re-open the editor. Failure to do this can result in the credits editor spontaneously reverting your changes back to the last time you saved - which may mean a lot of lost progress. |
| |
| * Make sure you have at least a screen of blank space at the end of your credits (shown below) or else the screen won't clear properly, and you will still have credits on the final screens of the game (where you are shown your completion percentage, etc.) | * Sometimes, when you exit and re-open the credits editor, you'll notice that the credits have been changed - typically, you'll see the vanilla bottom section of the credits repeated there, even though you didn't place it [to-do: find out why this happens and how to reproduce consistently]. However, as long as the glitch seen in the next bullet point below doesn't occur, you should be safe (probably? make backups often just in case) to delete the extra stuff that appeared there and replace it with your intended credits. **Because of this, when you're done editing your credits, re-open the editor one last time to make sure this glitch didn't occur.** <del>Pure speculation: This may happen when your credits are shorter than that of vanilla, and the game fills all the extra space with these credits to restore it to it's vanilla length.</del> Thanks to Smiley's research, we now know that this phenomenon is most likely explained by the following: If you edit the credits and it takes up less data than that of vanilla's, SMILE RF is likely (at least in some cases?) not correctly writing the terminating data to the credits instruction list, resulting in the vanilla data still being read by the game after your custom data ends. |
| |
| {{:super:intermediate_guides:brokencreditsexample2.png?400|}} (notice how the Credits Placement Window is scrolled all the way down to the bottom in this image) | {{:super:intermediate_guides:brokencreditsexample3.png|An example of credits where the vanilla credits spontaneously appeared at the bottom when saving}} |
| |
| * Edit the contents of each the Credits Tile Editor (box on the right) __//**SEPARATELY**//__ from editing the Credits Placement Window (box on the left); when changing from one to the other, always save the tilemap and re-open the editor. Failure to do this can result in the credits editor spontaneously reverting your changes back to the last time you saved - which may mean a lot of lost progress. | * Sometimes, the end of your credits (as seen in the editor) will become a horrible glitchy mess (seen below). If this happens, your credits were likely too long. It may be possible to delete all those extra lines that were created and still have functioning credits, but you should assume the glitch credits broke something else in your ROM. I highly recommend to revert to an older backup of your ROM at this point, or use SMILE's File Compare and a hex editor if you need to perform manual repairs. [to-do: find out if this actually breaks your ROM, or if you will be fine if you just delete all the extra crap and move on. For now, to be safe, assume that it does break your ROM.] |
| |
| * Sometimes, when you exit and re-open the credits editor, you'll notice that the credits have been changed - typically, you'll see the vanilla bottom section of the credits repeated there, even though you didn't place it. This can happen [to-do: find out why], but in my experience this doesn't mean that all hope is lost for your credits. Just delete what appeared there and try again. If it happens again, your credits may be too long[?] | {{:super:intermediate_guides:brokencreditsexample1.png|If you see this, your ROM is broken and you're gonna have to do some digging to fix it.}} |
| |
| * Sometimes, the end of your credits (as seen in the editor) will become a horrible glitchy mess (seen below). If this happens, your credits were likely too long. It may be possible to delete all those extra lines that were created and still have functioning credits, but I do not know if other things have been overwritten in your ROM. I highly recommend to revert to an older backup of your ROM at this point, or use SMILE's File Compare feature if necessary. | //(When the in-game credits scroll to this point, the player will most likely see a glitchy mess, followed by a possibly crash of the Credits Editor. Avoid!)// |
| |
| {{:super:intermediate_guides:brokencreditsexample1.png?200|}} | * Some twisted combination of these bugs can cause another bug where SMILE to crashes every time you try to save the credits. If this happens, from what I've seen, your copy of SMILE RF is fine - it's the specific ROM that is causing this. The crash randomly stopped happening to me after I saved the credits of a //different// ROM, strangely enough. |
| |
| (feel free to expand this section if you learn more!) | (feel free to expand this section if you learn more!) |
