{"id":26923970,"url":"https://github.com/qguv/undercooked","last_synced_at":"2025-04-02T01:52:55.584Z","repository":{"id":52198740,"uuid":"181371934","full_name":"qguv/undercooked","owner":"qguv","description":"Cooking game for the gameboy dmg, written in assembly. Art by rech!","archived":false,"fork":false,"pushed_at":"2022-12-21T17:50:46.000Z","size":6827,"stargazers_count":12,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-08-02T18:56:19.541Z","etag":null,"topics":["asm","assembly","dmg","game","gameboy","gbz80","rgbds"],"latest_commit_sha":null,"homepage":"https://qguv.github.io/undercooked","language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qguv.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}},"created_at":"2019-04-14T21:36:47.000Z","updated_at":"2023-05-10T14:41:08.000Z","dependencies_parsed_at":"2023-01-30T04:30:55.640Z","dependency_job_id":null,"html_url":"https://github.com/qguv/undercooked","commit_stats":null,"previous_names":[],"tags_count":19,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qguv%2Fundercooked","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qguv%2Fundercooked/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qguv%2Fundercooked/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qguv%2Fundercooked/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qguv","download_url":"https://codeload.github.com/qguv/undercooked/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246741161,"owners_count":20826063,"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":["asm","assembly","dmg","game","gameboy","gbz80","rgbds"],"created_at":"2025-04-02T01:52:55.012Z","updated_at":"2025-04-02T01:52:55.547Z","avatar_url":"https://github.com/qguv.png","language":"Assembly","funding_links":[],"categories":[],"sub_categories":[],"readme":"# undercooked\n\n[![build status](https://github.com/qguv/undercooked/workflows/build/badge.svg?branch=master)](https://github.com/qguv/undercooked/actions?query=workflow%3Abuild+branch%3Amaster)\n\nA cooking game for the 1989 Nintendo Game Boy (DMG-01). Should run on later models, too. Forever free and open source.\n\n\u003cimg src=\"https://raw.githubusercontent.com/qguv/undercooked/master/art/title.png\" /\u003e\u003c/a\u003e\n\n[Play undercooked now in your browser](https://qguv.github.io/undercooked), or [download the ROM](https://qguv.github.io/undercooked) to play in an emulator or burn onto a Gameboy cartridge!\n\n## credits\n\n\u003cimg width=80 src=\"https://retchdots.carrd.co/assets/images/image02.jpg?v81760597676551\" /\u003e [Rachel](https://retchdots.carrd.co/) did the amazing pixel art\n\n[Quint](https://github.com/qguv) wrote the code and music\n\n## building\n\nprerequisite packages:\n\npackage       | purpose\n------------- | -------\nrgbds         | toolchain for cross-compiling for the gameboy architecture\nimagemagick   | image correction tasks for sprites and tiles\nninja         | build system\npython3       | build system\n\n1. run `./configure` to prepare build system (you only have to do this once)\n2. run `ninja` to compile\n3. run gameboy ROM at `obj/main.gb`\n\n## playing\n\n- you can run on real hardware with a flash cart like the GB USB 64M\n- you can run on your regular emulator of choice, `zboy` is fine\n- you can run on `bgb`, a very good emulator with a debugger, using wine (see [this AUR package](https://aur.archlinux.org/packages/bgb))\n\n## developing\n\n- if you run with `bgb -nobatt -watch obj/main.gb`, bgb will reload the newly built ROM whenever you run `ninja` to compile\n- if you add (or remove) a source file and want to link it into the built ROM (or remove the link), edit the `build obj/main.gb` line in `meta/build.ninja.j2`\n- run `./configure` again if you ever need to rebuild the build system\n\n## naming conventions\n\naddresses:\n\n```asm\n.jump_label                 ; jump labels within subroutines\n;convenience_label          ; label for a section of code that's currently entered by fallthrough\n.label_in_macro\\@           ; jump labels within macros\nSomeFunction:               ; a non-exported subroutine\nSomeFunction__abcdehl:      ; a non-exported subroutine reading registers a, b, c, d, e, h, and l as arguments\nSomeData                    ; exported data, probably array/string\n_GBHW_ADDR or _GBHWADDR     ; gameboy hardware address defined in gbhw.inc\nsome_value                  ; ram address or compiler variable\n```\n\nvalues:\n\n```asm\nas3_freq                    ; music frequency (16-bit)\nas3                         ; music note (8-bit index into NoteFreqs)\nSOME_CONSTANT               ; equ-defined constant\n```\n\n## releasing\n\n1. create and push a new tag `vX.Y.Z`\n2. edit and publish the [draft github release](https://github.com/qguv/undercooked/releases) that was just created for you\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqguv%2Fundercooked","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqguv%2Fundercooked","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqguv%2Fundercooked/lists"}