Skip to content

Releases: LibreShark/hammerhead

v1.3.0

12 Jul 16:54
v1.3.0
7a7d7cc
Compare
Choose a tag to compare

N64 GS ROMs

  • Add support for configuring user preferences
    • Enable/disable scrolling, set background pattern/color, etc.
  • Add support for reordering key codes and changing the default key code
  • Key codes are automatically re-computed when writing to a ROM file
    • The two 32-bit CRCs and the 32-bit entry point addresses are automatically recalculated for all key codes whenever N64GsRom.WriteChangesToBuffer() is called
dotnet run --project dotnet/src/src.csproj -- \
    n64 gs config \
        libreshark-pro-v4.05-20230711-cheatocodes.bin \
            --rename-keycodes \
            --keycode-order=zelda,mario,diddy,yoshi \
            --selected-game=2 \
            --sound \
            --menu-scroll=false \
            --bg-scroll=false \
            --bg-pattern=logo \
            --bg-color=blue \
            --update-timestamp

Supported file formats

Full support

Firmware (ROM) files:

File format Detect Read Write Extract
N64 GameShark ROMs Yes Yes Yes Yes
N64 Xplorer 64 ROMs Yes Yes Yes

Cheat code files:

File format Detect Read Write
N64 GameShark Datel cheats Yes Yes Yes
N64 Xplorer 64 FCD cheats Yes Yes Yes
Hammerhead JSON cheats Yes Yes Yes
N64 EverDrive-64 X7 cheats Yes Yes Yes

In progress

File format Detect Read Write Extract
GB GameShark v2.x ROMs Yes Yes
GBC Code Breaker ROMs Yes Yes
GBC GameShark v3.x ROMs Yes Yes
GBC GameShark v4.x ROMs Yes Yes
GBC Shark MX ROMs Yes Yes
GBC Xploder ROMs Yes Yes
GBA Datel GameShark ROMs Yes Yes
GBA FCD GameShark & Code Breaker ROMs Yes Yes

Planned

File format Detect Read Write
GBC GameShark v3.x cheats (*.gcf)
OpenEmu XML cheats
N64 Project 64 v1.x cheats
N64 Project 64 v3.x cheats

Limited support

File format Detect Read Write Extract
GBC BrainBoy / Monster Brain ROMs Yes
GBA TV Tuner ROMs Yes
N64 GB Hunter ROMs Yes

v1.2.5

11 Jul 03:18
7b76652
Compare
Choose a tag to compare
Fix GitHub workflow permissions for publish action (#29)

v1.2.4

10 Jul 22:22
46f70ab
Compare
Choose a tag to compare
Don't publish changelog (#28)

v1.2.3

10 Jul 22:10
2b6fc73
Compare
Choose a tag to compare
Publish packages (#27)

v1.2.2

10 Jul 21:58
236d758
Compare
Choose a tag to compare

Hopefully fix CI build issues

v1.2.1

10 Jul 21:15
c5a45b4
Compare
Choose a tag to compare

Changelog

  • Bump version to v1.2.1
  • Add rom extract CLI command
  • Decompress embedded N64 GS files using LZARI algorithm and write them to disk
  • Convert embedded images to PNG and write them to disk
  • Add support for LibreShark-branded GS ROM builds
  • Automatically build Hammerhead EXEs for all OSes and publish them with GitHub Releases
  • Refactor code to be more testable
  • Add unit tests

Supported file formats

Full support

File format Detect Read Write Extract
N64 GameShark ROMs Yes Yes Yes Yes
N64 GameShark Datel cheats Yes Yes Yes -
N64 Xplorer 64 ROMs Yes Yes Yes
N64 Xplorer 64 FCD cheats Yes Yes Yes -
Hammerhead JSON cheats Yes Yes Yes -
N64 EverDrive-64 X7 cheats Yes Yes Yes -

In progress

File format Detect Read Write Extract
GB GameShark v2.x ROMs Yes Yes
GBC Code Breaker ROMs Yes Yes
GBC GameShark v3.x ROMs Yes Yes
GBC GameShark v4.x ROMs Yes Yes
GBC Shark MX ROMs Yes Yes
GBC Xploder ROMs Yes Yes
GBA Datel GameShark ROMs Yes Yes
GBA FCD GameShark & Code Breaker ROMs Yes Yes

Planned

File format Detect Read Write Extract
GBC GameShark v3.x cheats (*.gcf) -
OpenEmu XML cheats -
N64 Project 64 v1.x cheats -
N64 Project 64 v3.x cheats -

Limited support

File format Detect Read Write Extract
GBC BrainBoy / Monster Brain ROMs Yes
GBA TV Tuner ROMs Yes
N64 GB Hunter ROMs Yes

v1.2.0

10 Jul 21:00
42260b2
Compare
Choose a tag to compare

Changelog

  • Bump version to v1.2.0
  • Add rom extract CLI command
  • Decompress embedded N64 GS files using LZARI algorithm and write them to disk
  • Convert embedded images to PNG and write them to disk
  • Add support for LibreShark-branded GS ROM builds
  • Automatically build Hammerhead EXEs for all OSes and publish them with GitHub Releases
  • Refactor code to be more testable
  • Add unit tests

Supported file formats

Full support

File format Detect Read Write Extract
N64 GameShark ROMs Yes Yes Yes Yes
N64 GameShark Datel cheats Yes Yes Yes -
N64 Xplorer 64 ROMs Yes Yes Yes
N64 Xplorer 64 FCD cheats Yes Yes Yes -
Hammerhead JSON cheats Yes Yes Yes -
N64 EverDrive-64 X7 cheats Yes Yes Yes -

In progress

File format Detect Read Write Extract
GB GameShark v2.x ROMs Yes Yes
GBC Code Breaker ROMs Yes Yes
GBC GameShark v3.x ROMs Yes Yes
GBC GameShark v4.x ROMs Yes Yes
GBC Shark MX ROMs Yes Yes
GBC Xploder ROMs Yes Yes
GBA Datel GameShark ROMs Yes Yes
GBA FCD GameShark & Code Breaker ROMs Yes Yes

Planned

File format Detect Read Write Extract
GBC GameShark v3.x cheats (*.gcf) -
OpenEmu XML cheats -
N64 Project 64 v1.x cheats -
N64 Project 64 v3.x cheats -

Limited support

File format Detect Read Write Extract
GBC BrainBoy / Monster Brain ROMs Yes
GBA TV Tuner ROMs Yes
N64 GB Hunter ROMs Yes

v1.1.0

05 Jul 17:50
v1.1.0
660c608
Compare
Choose a tag to compare

Supported file formats

Full support:

File format Detect Read Write
N64 GameShark Datel cheats Yes Yes Yes
N64 GameShark ROMs Yes Yes Yes
N64 Xplorer 64 FCD cheats Yes Yes Yes
N64 Xplorer 64 ROMs Yes Yes Yes
Hammerhead JSON cheats Yes Yes Yes
N64 EverDrive-64 X7 cheats Yes Yes Yes

In progress:

File format Detect Read Write
GB GameShark v2.x ROMs Yes Yes
GBC Code Breaker ROMs Yes Yes
GBC GameShark v3.x ROMs Yes Yes
GBC GameShark v4.x ROMs Yes Yes
GBC Shark MX ROMs Yes Yes
GBC Xploder ROMs Yes Yes
GBA Datel GameShark ROMs Yes Yes
GBA FCD GameShark & Code Breaker ROMs Yes Yes

Planned:

File format Detect Read Write
GBC GameShark v3.x cheats (*.gcf)
OpenEmu XML cheats
N64 Project 64 v1.x cheats
N64 Project 64 v3.x cheats

Limited support:

File format Detect Read Write
GBC BrainBoy / Monster Brain ROMs Yes
GBA TV Tuner ROMs Yes
N64 GB Hunter ROMs Yes

v1.0.0

02 Jul 15:57
73f91fd
Compare
Choose a tag to compare

Supported file types:

File format Detect Read Write
GB GameShark v2.x ROMs
GBC BrainBoy / Monster Brain ROMs
GBC Code Breaker ROMs
GBC GameShark v3.x ROMs
GBC GameShark v4.x ROMs
GBC Shark MX ROMs
GBC Xploder ROMs
GBA Datel GameShark ROMs
GBA FCD GameShark & Code Breaker ROMs
GBA TV Tuner ROMs
N64 EverDrive-64 X7 cheats
N64 GameShark Datel cheats
N64 GameShark ROMs
N64 GB Hunter ROMs
N64 Project 64 v1.x cheats
N64 Project 64 v3.x cheats
N64 Xplorer 64 FCD cheats
N64 Xplorer 64 ROMs
OpenEmu cheats