This is an old revision of the document!
This page lists various asm hacks that can be applied to the game. Larger code listings should be placed on their own page.
These hacks are from various sources and may be intended for different assemblers or for different configurations of an assembler. If you use the patch, please give credit to the author!
Most hacks are applied to the game engine bank (bank 7). These will not work as-is with a ROM expanded by Editroid, which moves the game engine to bank $F. The offset needs to be adjusted accordingly. Add $20000 to file offsets to get the new game engine bank offset. Also, the expanded ROMs make use of previously unused ROM space that ASM hacks will commonly be placed in, so the ASM may need to be placed at a different address.
Small tweaks that can be made to change behavior of the game. Tweaks that apply to the game engine page (bank $7) need to be adjusted to bank $F for an expanded ROM). To get the file offset for the game engine bank, add $10010 to the address ($30010 for expanded ROMs). For level banks, subtract $8000 from the pointer, and add level bank offset (Brinstar = $4010, Norfair = $8010, Tourian = $C010, Kraid = $10010, Ridley = $14010).
Locations are specified as BANK:ADDRESS
.PATCH 07:D663 LDA #$?? ; Sets bomb timer (originally #$18)
.PATCH 07:$D15D LDA $0307 ; Allows Samus to drop bombs while in air more easily
;(Substitute appropriate level bank) .PATCH ??:95CE .db #$?? ; Damage to Samus caused by enemies - low byte (example .db #$80 results in loss of 8 energy when hurt by enemy) .PATCH ??:95CF .db #$?? ; Damage to Samus caused by enemies - high byte (typically #$00. example: .db #$85 would result in additional damage of 850 when hurt by enemy)
Hacks too large to be listed here are linked to below.
This patch changes the starting area. It works by replacing the normal “start-new-game” routine with a simpler one that acts as though the player entered a password to start in the desired level. One drawback of this method is that the player can still enter a blank password and begin in Brinstar.
InitializeGame = $92D4 NewStartingArea = 1 ; 0 = Brinstar, 1 = Norfair, 2 = Kraid, 3 = Tourian, 4 = Ridley .PATCH 00:932B lda #NewStartingArea sta PasswordByte08 jmp InitializeGame
This simple patch changes how doorways affect scrolling. Usually, a normal doorway tile, show in green with “Show Physics” in Editroid, toggles between horizontal and vertical scrolling (connects a horizontal and vertical room), and a horizontal-doorway tile, shown in yellow in Editroid, sets scrolling to horizontal (connects two horizontal rooms).
With this patch, a green (normal) doorway will always set scrolling to vertical and a yellow (horizontal) doorway will always set scrolling to horizontal.
.PATCH 07:E237 ; (0F:E237 for expanded ROMs) LDA #$00
The patch can easily be applied with a hex editor. Go to offset $1E247 in the file ($3E247 for expanded ROMs) and change
A4 57 to
In the original Metroid, there is only one tile that has doorways physics (two, actually: one for each doorway type). This makes for a very boring doorway. This patch increases the number of tiles with doorway physics to allow more variety in the doorways.
Change the values of
NormalDoorwayTiles = $A ; (10) HorizontalDoorwayTiles = $A ; (10) .PATCH 07:E807 ; 0F:E807 for expanded ROMs CMP #($A0 + NormalDoorwayTiles) BCC $E811 CMP #($A0 + NormalDoorwayTiles + HorizontalDoorwayTiles) BCS $E813
Or, using a hex editor go to $1E817 ($3E817 in an expanded ROM), and change
C9 A0 F0 06 C9 A1 D0 04
C9 (A0 + normal doorway tiles) 90 06 C9 (A0 + normal doorway tiles + horizontal doorway tiles) B0 04
The normal doorway tiles will start at tile A0, and horizontal doorway tiles will come right after the normal doorway tiles. Since these tiles are already in use, you will need to re-arrange the tiles and fix the combos that use them.
By FurryKef. This hack causes enemies to disappear when the player enters a doorway, and to re-appear as Samus is entering the next room. The idea is to avoid the issue of enemies getting trapped in the doorway during screen transitions, and killing the hell out of the player. It also avoid the issue of enemies in the next room attacking the player before he has time to dodge the enemy.
The intended assembler is WLA. It is not clear whether this patch is intended for a normal or expanded ROM.
; Behavioral patch - enemies now freeze while moving through doors ; No more being hit by enemies while moving through 'em! ; This hooks into the start of UpdateEnemies in Dirty McDingus's code. .bank 16 slot 1 .orga $F345 .section "freeze enemies patch" size 12 overwrite lda $56 ; Nonzero when traveling through door beq + rts ; In door; don't update enemies + jsr FreezeEnemiesRestoration nop nop nop nop .ends ; This section starts at AccessSavedGame and ends at the end ; of SavedDataTable .orga $CA35 .section "patch scratch" size 191 overwrite ; Restores the behavior overwritten by "freeze enemies patch" FreezeEnemiesRestoration: ldx #$50 - jsr $F351 ; DoOneEnemy ldx $4B ; PageIndex jsr $F1F4 ; Xminus16 bne - rts .ends
By Stinktier. In the original metroid engine, the code instructs the CPU to add a constant to the player objects' (samuses) y position offset every so often, before checking if it is possible to go one pixel up. This is samuses' upper line in her hit box. Unfortunately and possibly mistakenly, the engine happens to add this constant twice during the special occasion of checking if samus is able to break from her morph ball mode; once in the subroutine which is called when the 'up' button is pressed while in ball mode, and then again in the aforementioned standard procedure subroutine for checking upward collisions. This results in a glitch where you by un-morphing can stand and jump through certain solid objects, as the collision detection line is way past the solid object.
During gameplay of the original level design, this bug is perfectly concealed by the design choice of letting almost all 'blocks' (or combos, as they are called in Editroid) consist of 2×2 sets of 8x8px tiles with homogenous properties; they are all either 'solid' or 'air'. The few odd combos are placed where they don't provoke the bug, as you wouldn't roll under a 'mario pipe' or a 'volcano'. The bug fix is therefore necessary if (and only when) you make combos that consist of both 'air' tiles and 'solid' tiles. Having this option available is significantly expanding what is possible to do with the level design.
The actual bug fix is to eliminate the addition in the first subroutine, which is called exclusively during the unmorphing event and nowhere else.