{"id":15060413,"url":"https://github.com/mattcurrie/gb-save-states","last_synced_at":"2025-04-04T21:07:16.736Z","repository":{"id":41300895,"uuid":"97279862","full_name":"mattcurrie/gb-save-states","owner":"mattcurrie","description":"💾 Patches to add save state support to Game Boy games when playing on the original hardware","archived":false,"fork":false,"pushed_at":"2025-02-18T09:07:06.000Z","size":741,"stargazers_count":162,"open_issues_count":14,"forks_count":12,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-03-28T20:07:59.869Z","etag":null,"topics":["assembly-language","game-boy","gameboy"],"latest_commit_sha":null,"homepage":"","language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattcurrie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-07-14T23:33:39.000Z","updated_at":"2025-03-28T02:01:46.000Z","dependencies_parsed_at":"2023-02-19T02:31:51.828Z","dependency_job_id":"b19bd7ea-c519-47b5-ab66-2f1f5389bab4","html_url":"https://github.com/mattcurrie/gb-save-states","commit_stats":{"total_commits":119,"total_committers":5,"mean_commits":23.8,"dds":0.04201680672268904,"last_synced_commit":"43053f7f1992fbdf966763c0df70fd30f99f01b7"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattcurrie%2Fgb-save-states","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattcurrie%2Fgb-save-states/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattcurrie%2Fgb-save-states/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattcurrie%2Fgb-save-states/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattcurrie","download_url":"https://codeload.github.com/mattcurrie/gb-save-states/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247249524,"owners_count":20908212,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assembly-language","game-boy","gameboy"],"created_at":"2024-09-24T22:58:25.695Z","updated_at":"2025-04-04T21:07:16.716Z","avatar_url":"https://github.com/mattcurrie.png","language":"Assembly","funding_links":[],"categories":["Related projects","相关项目"],"sub_categories":["Post processing","后加工"],"readme":"# gb-save-states\nPatches to add save state support to Game Boy and Game Boy Color games when playing on the original hardware.\n\n# How to use\n\n## Requirements\n\n- For Game Boy games:\n   - Flash cart that supports 32KB of save RAM and MBC 1/5 mapper\n- For Game Boy Color games, and Game Boy games that originally include save RAM:\n   - Flash cart that supports 128KB of save RAM and MBC 5 mapper, e.g. EZ Flash Jr. or EverDrive-GB X3/X5/X7. Not sure how much save RAM your flash cart supports? [Try this test ROM on your flash cart.](https://github.com/eievui5/sram128/releases/tag/v1.0.1)\n- Original ROM file for the game\n- Patching software that supports bsdiff patches:\n\n   - Windows (command line) - [BsPatch](https://www.romhacking.net/utilities/929/)\n   - macOS (GUI) - [Multi Patch](http://projects.sappharad.com/tools/multipatch.html)\n   - macOS (terminal) - install [Homebrew](https://brew.sh/) and then run ```brew install bsdiff``` in the terminal\n\n\n## Setup\n \n1. Download the .bsdiff patch file for the game from the [patches](patches) directory\n\n\n2. Patch your original ROM with the patch to build a new patched ROM. \n\n   Example for command line/terminal:\n\n   ```\n   bspatch \"B.C. Kid (E) [!].gb\" patched.gb \"B.C. Kid (E) [!].gb.bsdiff\"\n   ```\n\n3. Copy the patched ROM to your flash cartridge\n\n\n## Controls\n\nDue to different button layouts on the GB/GBC and the GBA, there are two different button combinations that can be used to save/load a game.  \n\nAfter pressing the button combo, the screen will flash as the save/load process runs.\n\n\n### Save \n\nCombo 1: Hold \u003ckbd\u003eDown\u003c/kbd\u003e and press \u003ckbd\u003eStart\u003c/kbd\u003e\n\nCombo 2: Hold \u003ckbd\u003eSelect\u003c/kbd\u003e and press \u003ckbd\u003eA\u003c/kbd\u003e\n\n### Load\n\nCombo 1: Hold \u003ckbd\u003eUp\u003c/kbd\u003e and press \u003ckbd\u003eStart\u003c/kbd\u003e\n\nCombo 2: Hold \u003ckbd\u003eSelect\u003c/kbd\u003e and press \u003ckbd\u003eB\u003c/kbd\u003e\n\n# There isn't a patch for my favourite game!\n\nSubmit an [issue](https://github.com/mattcurrie/gb-save-states/issues) and hopefully someone will create a patch for you.\n\nIf you have a bit of Game Boy assembly knowledge then you can create a patch yourself.  [Check out the How To document](src/HOW-TO.md)\n\n# Limitations\n\n- Sound/Music cannot always be restored 100% due to some sound registers being read only. This generally isn't a problem unless loading a save game from the startup menu instead of during gameplay.  Pausing and resuming the game can sometimes resolve any sound problems.\n\n# Notes\n\n- Kirby's Dream Land uses \u003ckbd\u003eSelect\u003c/kbd\u003e + \u003ckbd\u003eDown\u003c/kbd\u003e + \u003ckbd\u003eB\u003c/kbd\u003e and \u003ckbd\u003eSelect\u003c/kbd\u003e + \u003ckbd\u003eUp\u003c/kbd\u003e + \u003ckbd\u003eA\u003c/kbd\u003e to access hidden features on the title screen. To avoid conflicts with the save/load combos, these hidden feature combos have been remapped to \u003ckbd\u003eDown\u003c/kbd\u003e + \u003ckbd\u003eB\u003c/kbd\u003e and \u003ckbd\u003eUp\u003c/kbd\u003e + \u003ckbd\u003eA\u003c/kbd\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattcurrie%2Fgb-save-states","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattcurrie%2Fgb-save-states","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattcurrie%2Fgb-save-states/lists"}