{"id":18016132,"url":"https://github.com/cpu/wolf","last_synced_at":"2026-04-28T20:02:05.761Z","repository":{"id":89702932,"uuid":"124949525","full_name":"cpu/wolf","owner":"cpu","description":"Ultra-Mega-WIP Homebrew Gameboy Game. Black Metal Platformer. GBZ80 ASM","archived":false,"fork":false,"pushed_at":"2018-04-08T14:27:59.000Z","size":124,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-10-24T10:58:51.858Z","etag":null,"topics":["bgb","black-metal","gameboy","gbz80","homebrew","kvlt","rgbds","rom","wolf","z80","z80asm"],"latest_commit_sha":null,"homepage":"","language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cpu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2018-03-12T20:47:36.000Z","updated_at":"2023-07-20T16:58:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"97ef647f-09a5-4df8-8261-7655dad04475","html_url":"https://github.com/cpu/wolf","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cpu/wolf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cpu%2Fwolf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cpu%2Fwolf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cpu%2Fwolf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cpu%2Fwolf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cpu","download_url":"https://codeload.github.com/cpu/wolf/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cpu%2Fwolf/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32396781,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T19:38:08.556Z","status":"ssl_error","status_checked_at":"2026-04-28T19:37:55.688Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bgb","black-metal","gameboy","gbz80","homebrew","kvlt","rgbds","rom","wolf","z80","z80asm"],"created_at":"2024-10-30T04:16:15.823Z","updated_at":"2026-04-28T20:02:05.723Z","avatar_url":"https://github.com/cpu.png","language":"Assembly","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Wolf](https://binaryparadox.net/d/906c1e6f-ab5a-4c41-b56b-4098fcf6ce31.jpg)\n\n## Wolf\n\nWolf is a simple side scrolling platformer where the screen advances\nautomatically and the player must react.\n\nThis is a **ultra-mega-work-in-progress** homebrew platformer for the original\nGameboy. It is written entirely in GB Z80 ASM using\n[rgbds](https://github.com/rednex/rgbds) for the assembler/linker toolchain.\n\nBeyond simple experimentation Wolf is my first attempt at GB Z80 / Gameboy\ndevelopment. It will probably never be finished and the code is varying degrees\nof unoptimized hot trash.\n\nWolf is **10000%** not finished!\n\n## Development\n\n### Building ROM from source\n\nTo, build the ROM [rgbds](https://github.com/rednex/rgbds) must be installed\nand the `rgbasm`, `rgblink`, and `rgbfix` commands must be in your `$PATH`.\n\n1. Run `make`.\n1. Load `wolf.gb` into an emulator, or [onto a ROM\n   cartridge](https://krikzz.com/store/home/46-everdrive-gb.html) for use in real\n   hardware.\n\n### Development Tools\n\nFor development tools [wine](https://www.winehq.org/) must be installed and the\n`wine` command must be in your `$PATH`.\n\nBy default the `Makefile` assumes all development tools are kept in the\n`$HOME/wine` directory. If you place yours elsewhere be sure to update\n`TOOLS_ROOT` in the `Makefile`.\n\n#### Godmode\n\nTo aid with testing you can also build the ROM with gravity and death disabled:\n\n1. Run `make clean` to remove any previous builds.\n1. Run `make GODMODE=1` to build with no gravity or death.\n\n#### Debugging/Emulating\n\n1. Download [BGB](http://bgb.bircd.org/) and place `bgb.exe` in `$HOME/wine/`\n1. Run `make debug`\n\n**Pro-tip:** BGB can be configured to automatically break on many conditions\nthat can happen when your code is buggy. Enable **all** of the possible debugger\nexceptions that can be found under the **bgp control panel** under the\n**Exceptions** tab:\n\n![BGB Exceptions\nConfiguration](https://binaryparadox.net/d/548a91cf-d399-4db2-8035-472a36b486c6.jpg)\n\nFor more information [see these BGB debugger\ntips/tricks](https://github.com/doeg/gb-skeleton/blob/master/docs/bgb.md).\n\n#### Tile Editing\n\n1. Download [GBTD](http://www.devrs.com/gb/hmgd/gbtd.html) and place `GBTD.EXE`\n   in `$HOME/wine/gbtd.exe` (Note the case change, all caps `.exe`'s are\n   silly...)\n1. Run `make tiles`\n\n#### Map Editing\n\n1. Download [GBMD](http://www.devrs.com/gb/hmgd/gbmb.html) and place `GBMD.EXE`\n   in `$HOME/wine/gbmd.exe` (Note the case change, all caps `.exe`'s are\n   silly...)\n1. Run `make map`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcpu%2Fwolf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcpu%2Fwolf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcpu%2Fwolf/lists"}