Mega Man Legacy Collection ROM Extractor

mmlc_extract.py

#!/usr/bin/env python

# Program for extracting the NES roms of each game in the Mega Man Legacy
# Collection for PC
# To use it, launch it in the same folder as Proteus.exe.

# NOTE: CybertKitsune figured out the password for data.pie which contains collection sounds and graphics.
# Extract it with 7-Zip and the password as follows:
# P091uWEdwe4lI6StDNMNlkodPGvJ38bL3HW6t3BCMYdFi83FXKu7k0NsHP8caDKS

# iNES Headers for Mega Man 1-6
HEADERS = [b'\x4E\x45\x53\x1A\x08\x00\x21\x00\x00\x00\x00\x00\x00\x00\x00\x00',
           b'\x4E\x45\x53\x1A\x10\x00\x10\x00\x00\x00\x00\x00\x00\x00\x00\x00',
           b'\x4E\x45\x53\x1A\x10\x10\x40\x00\x00\x00\x00\x00\x00\x00\x00\x00',
           b'\x4E\x45\x53\x1A\x20\x00\x40\x00\x00\x00\x00\x00\x00\x00\x00\x00',
           b'\x4E\x45\x53\x1A\x10\x20\x40\x00\x00\x00\x00\x00\x00\x00\x00\x00',
           b'\x4E\x45\x53\x1A\x20\x00\x40\x00\x00\x00\x00\x00\x00\x00\x00\x00']

# Offsets for each game's English ROM in the .exe file
# v1.1.1.29         OFFSET     SIZE             OFFSET      SIZE
OFFSETS = [{'PRG': [0x2AEEB0, 0x20000], 'CHA': None},
           {'PRG': [0x8ED70, 0x40000], 'CHA': None},
           {'PRG': [0xCEDB0, 0x40000], 'CHA': [0x10EDB0, 0x20000]},
           {'PRG': [0x12EDF0, 0x80000], 'CHA': None},
           {'PRG': [0x1AEE30, 0x40000], 'CHA': [0x1EEE30, 0x40000]},
           {'PRG': [0x22EE70, 0x80000], 'CHA': None}]

# Offsets for each game's Japanese ROM in the .exe file
# v1.1.1.29         OFFSET     SIZE             OFFSET      SIZE
JAPANOFFSETS = [{'PRG': [0x512230, 0x20000], 'CHA': None},
           {'PRG': [0x2F20F0, 0x40000], 'CHA': None},
           {'PRG': [0x332130, 0x40000], 'CHA': [0x372130, 0x20000]},
           {'PRG': [0x392170, 0x80000], 'CHA': None},
           {'PRG': [0x4121B0, 0x40000], 'CHA': [0x4521B0, 0x40000]},
           {'PRG': [0x4921F0, 0x80000], 'CHA': None}]

# In case the addresses above change in a new EXE build, search for these hex numbers:
# Mega Man 1 PRG - 00000000010101016268626969686869
# Mega Man 2 PRG - 00000000586058606060606060686068
# Mega Man 3 PRG - 9090909098909094949090B590909090
# Mega Man 3 CHA - 027979A37E3E00009EA7A7FF423E000000000304091F333F0000000306011D13000080E0F0F8F8F700000000E0F0F0F81F0E010101070F0F0E00000000010700FFFF1E88FDFBFBFB7F7FFFF7E3F1F100000080E0F0F8F8F400000000E0F0F0F8008040408080000000008080000000000304091F333F2C20000306011D130C0080E0F0F8F8F434140000E0F0F0F83818000000000F1F0F0700000000000E07033F1D74CCC4E6E5F41A010070F8F8DECFFE860203030604087F870302020503070304091F333FEC20000306011D130CC080E0F0F8F8F437140000E0F0F0F8381BFCFE7E1C00000000787C1C0000000000001E7FA3FF7F1E0000000E5E5E0E0000000003070707030100000003030301002C20A0E0D0E8C7E40C0000808090F8FB341419193222C61E3B1B16162C1C3CFCC0E0F0F8F8F870C00040E0F0707000002C20202010387F7F0C0000000000383F34171811098705363818170F37F8F8EC0000C0E0F0F0F0E0000000C0E0E0E000202010080F1C1E0F00000000000B0D0019183024CF3F7FFE16172F1B37CFB6BC0202070C0E1E1F1F00000007070F0C0E010103827C80808001010201837F7F7F80C0301838BCFCFC0000C0F0F07818382020D02820101070C0C02010180F0F0F181833244408080817172C1838F0F0F0C0E0F0F8F8F8700000C0E0F0707000008080800080402070000000000080C0E09EFFFFFF7E3E00009EFF21FF423E0000EA710206070F1F1F7100010303010F00FF1F1D31E9E7F0F0FCF9F3CFC7C0E000E0F0F8F8F0000000C0E0F0B0000000007F3F040E0F1F3F3F3F00030707031F006FFD7838C5C3E0E0DC3EFFC78380C000F0F8FCFCF880000060F0F8D88000000002020100000000000101000000000000FC988CFE7F7FFEFC5860707C3E0E7C001F0E0103071F3F3F0E00000101071F00FFFF1E08D5E3E3E37F7FFFF7E3C1C100FCB840E0F0FCFEFE380080C0C0F0FC008FC7E3FFF0F0F1C37FFFFFF0E0E0C001F8F8C8048CFCF8F0F0F0F0F87878F0E09EFFFFFF7E3E3C009EFF23FF46020400027979A37E3E3C009EA7A7FF46020400060F1F1F0F07030100060F0E060301000304099FB3FFECA0000306011D93CCC080E0F0F9F9F737170000E0F0F0F93B1B5A5A5A49414B5B7B3C3C3C3E3E3E3E3E5E3E1C0403060E073F1F0703010307000000000000003F7F000000000000003F000000007EC15F7000000000007EFFFF3F7F5A4849DFDDFFFFFFFFFFFFFFFF0003070F1F3F3F3F1C0100060F1F1F1C000000010101070F0F
# Mega Man 4 PRG - 027979A37E3E00009EA7A7FF423E000000000304091F333F0000000306011D13000080E0F0F8F8F700000000E0F0F0F81F0E010101070F0F0E00000000010700FFFF1E88FDFBFBFB7F7FFFF7E3F1F100000080E0F0F8F8F400000000E0F0F0F8008040408080000000008080000000000304091F333F2C20000306011D130C0080E0F0F8F8F434140000E0F0F0F83818000000000F1F0F0700000000000E07033F1D74CCC4E6E5F41A010070F8F8DECFFE860203030604087F870302020503070304091F333FEC20000306011D130CC080E0F0F8F8F437140000E0F0F0F8381BFCFE7E1C00000000787C1C0000000000001E7FA3FF7F1E0000000E5E5E0E0000000003070707030100000003030301002C20A0E0D0E8C7E40C0000808090F8FB341419193222C61E3B1B16162C1C3CFCC0E0F0F8F8F870C00040E0F0707000002C20202010387F7F0C0000000000383F34171811098705363818170F37F8F8EC0000C0E0F0F0F0E0000000C0E0E0E000202010080F1C1E0F00000000000B0D0019183024CF3F7FFE16172F1B37CFB6BC0202070C0E1E1F1F00000007070F0C0E010103827C80808001010201837F7F7F80C0301838BCFCFC0000C0F0F07818382020D02820101070C0C02010180F0F0F181833244408080817172C1838F0F0F0C0E0F0F8F8F8700000C0E0F0707000008080800080402070000000000080C0E09EFFFFFF7E3E00009EFF21FF423E0000EA710206070F1F1F7100010303010F00FF1F1D31E9E7F0F0FCF9F3CFC7C0E000E0F0F8F8F0000000C0E0F0B0000000007F3F040E0F1F3F3F3F00030707031F006FFD7838C5C3E0E0DC3EFFC78380C000F0F8FCFCF880000060F0F8D88000000002020100000000000101000000000000FC988CFE7F7FFEFC5860707C3E0E7C001F0E0103071F3F3F0E00000101071F00FFFF1E08D5E3E3E37F7FFFF7E3C1C100FCB840E0F0FCFEFE380080C0C0F0FC008FC7E3FFF0F0F1C37FFFFFF0E0E0C001F8F8C8048CFCF8F0F0F0F0F87878F0E09EFFFFFF7E3E3C009EFF23FF46020400027979A37E3E3C009EA7A7FF46020400060F1F1F0F07030100060F0E060301000304099FB3FFECA0000306011D93CCC080E0F0F9F9F737170000E0F0F0F93B1B5A5A5A49414B5B7B3C3C3C3E3E3E3E3E5E3E1C0403060E073F1F0703010307000000000000003F7F000000000000003F000000007EC15F7000000000007EFFFF3F7F5A4849DFDDFFFFFFFFFFFFFFFF0003070F1F3F3F3F1C0100060F1F1F1C000CFF06060303FFC0
# Mega Man 5 PRG - A526C90ED009A5F9C90890034C9682A5
# Mega Man 5 CHA - 0304091F333F2C20000306011D130C0080E0F0F8F8F434140000E0F0F0F838180202070C0E1E1F1F00000007070F0C0E010103827C80808001010201837F7F7F80C0301838BCFCFC0000C0F0F07818381F0E0103071F3F3F0E00000101071F00FFFF1E08D5E3E3E37F7FFFF7E3C1C100FCB840E0F0FCFEFE380080C0C0F0FC00027979A37E3E0000
# Mega Man 6 PRG - 0000000000000000000000000000000000000000027979A3

if __name__ == '__main__':
    # Read in entire .exe file
    f = open("Proteus.exe", "rb")
    try:
        exe = f.read()
    finally:
        f.close()

    for i, game in enumerate(HEADERS):
        for section in ['PRG', 'CHA']:
            if OFFSETS[i][section]:
                start = OFFSETS[i][section][0]
                size = OFFSETS[i][section][1]
                end = start + size
                game += exe[start:end]
        out = open("Mega Man " + str(i+1) + " (U) (Legacy Collection).nes", "wb")
        try:
            out.write(game)
        finally:
            out.close()
    
    for i, game in enumerate(HEADERS):
        for section in ['PRG', 'CHA']:
            if JAPANOFFSETS[i][section]:
                start = JAPANOFFSETS[i][section][0]
                size = JAPANOFFSETS[i][section][1]
                end = start + size
                game += exe[start:end]
        # The Japanese versions are identical to the original Japanese cartridges.
        out = open("Rockman " + str(i+1) + " (J).nes", "wb")
        try:
            out.write(game)
        finally:
            out.close()

Thanks for updating this script, not just with updated offsets, but also with additional Japanese ROMs and even the collection password.

would be possibile to extract NSF files from the exe?