mirror of
https://github.com/gbdev/awesome-gbdev.git
synced 2025-09-03 04:32:35 +02:00
Added Infinity game and cleaned up contribuitions guidelines
Still needs to highlights the sources document.
This commit is contained in:
Antonio Vivace
@@ -1,17 +0,0 @@
|
||||
# Contribution Guidelines
|
||||
|
||||
Please ensure your pull request adheres to the following guidelines:
|
||||
|
||||
- Search previous suggestions before making a new one, as yours may be a duplicate.
|
||||
- Suggested packages should be tested and documented.
|
||||
- Make an individual pull request for each suggestion.
|
||||
- Use the following format: `[resource](link) - Description.`
|
||||
- Additions should be added to the bottom of the relevant category.
|
||||
- New categories, or improvements to the existing categorization are welcome.
|
||||
- Keep descriptions short and simple, but descriptive.
|
||||
- Start the description with a capital and end with a full stop/period.
|
||||
- Check your spelling and grammar.
|
||||
- Make sure your text editor is set to remove trailing whitespace.
|
||||
- The pull request should have a useful title and include a link to the package and why it should be included.
|
||||
|
||||
Thank you!
|
||||
73
README.md
73
README.md
@@ -23,49 +23,49 @@ Here you can find everything to get started and master the development of unoffi
|
||||
- [#gbdev on EFnet](http://chat.efnet.org/?channels=gbdev)
|
||||
|
||||
## Documentation
|
||||
- [GameBoy Programming Manual](http://www.romhacking.net/documents/544/) **Official Game Boy** hardware manual by Nintendo. Pretty much everything in the console is covered and explained in this manual. This should be your first and main resource to start understanding what game boy is.
|
||||
- [The Cycle-Accurate Game Boy Docs](https://github.com/AntonioND/giibiiadvance/blob/master/docs/TCAGBD.pdf)
|
||||
- [GameBoy Programming Manual](http://www.romhacking.net/documents/544/) **Official Game Boy** hardware manual by Nintendo. Pretty much everything in the console is covered and explained in this manual. This should be your first and main resource to start understanding what game boy is.
|
||||
- [The Cycle-Accurate Game Boy Docs](https://github.com/AntonioND/giibiiadvance/blob/master/docs/TCAGBD.pdf)
|
||||
- [Pan Docs](http://bgb.bircd.org/pandocs.htm) the single most comprehensive technical reference to GameBoy that is available to the public.
|
||||
- [The Game Boy, a hardware autopsy](https://www.youtube.com/channel/UC008MpfclY6ap-QGzoTMNKg) A video series explaining how exactly a Game Boy works.
|
||||
- [GBSOUND.txt](https://github.com/bwhitman/pushpin/blob/master/src/gbsound.txt)
|
||||
- [gbdev Sources](https://github.com/avivace/awesome-gbdev/blob/master/SOURCES.md) a collection of demos, homebrews and full games with complete sources (in C and ASM)
|
||||
- [GBSOUND.txt](https://github.com/bwhitman/pushpin/blob/master/src/gbsound.txt)
|
||||
- [DMG Schematics](http://gbdev.gg8.se/wiki/articles/DMG_Schematics)
|
||||
- [GB Instructions](http://www.chrisantonellis.com/files/gameboy/gb-instructions.txt) Gameboy Assembly Language Commands
|
||||
- [GB ASM Tips](http://www.chrisantonellis.com/files/gameboy/gb-asm-tips.txt) by GeeBee
|
||||
- [ASMotor Manual](http://www.chrisantonellis.com/files/gameboy/asmotor-v0.1.0-manual.pdf) (RGBDS)
|
||||
- [GBDK libraries documentation](http://gbdk.sourceforge.net/doc/gbdk-doc.pdf)
|
||||
- [gbdev FAQs](http://www.devrs.com/gb/files/faqs.html) must read by Jeff Frohwein
|
||||
- [GameBoy CPU InstructionSet Sheet (GCISheet)](http://www.devrs.com/gb/files/GBCPU_Instr.html)</span>
|
||||
- [GB Instructions](http://www.chrisantonellis.com/files/gameboy/gb-instructions.txt) Gameboy Assembly Language Commands
|
||||
- [GB ASM Tips](http://www.chrisantonellis.com/files/gameboy/gb-asm-tips.txt) by GeeBee
|
||||
- [ASMotor Manual](http://www.chrisantonellis.com/files/gameboy/asmotor-v0.1.0-manual.pdf) (RGBDS)
|
||||
- [GBDK libraries documentation](http://gbdk.sourceforge.net/doc/gbdk-doc.pdf)
|
||||
- [gbdev FAQs](http://www.devrs.com/gb/files/faqs.html) must read by Jeff Frohwein
|
||||
- [GameBoy CPU InstructionSet Sheet (GCISheet)](http://www.devrs.com/gb/files/GBCPU_Instr.html)</span>
|
||||
- [GameBoy CPU Manual](http://marc.rawer.de/Gameboy/Docs/GBCPUman.pdf) Assembly Language Commands, Timings and Opcodes
|
||||
- [Assembly Language Programming Course](http://cratel.wichita.edu/cratel/ECE238Spr08) Machine and assembly language programming concepts that illustrate basic principles and techniques. Application through study of the Z80 chip and Gameboy programming assignments (Center for Research in Arts, Technology, Education, and Learning CRATEL at Withicha State Universiy).
|
||||
- [Building a GameBoy emulator in JavaScript](http://imrannazar.com/GameBoy-Emulation-in-JavaScript) by _Imran Nazar_
|
||||
- [gbdev Sources](https://github.com/avivace/awesome-gbdev/blob/master/SOURCES.md) a collection of demos, homebrews and games with complete sources (in C and ASM)
|
||||
- [Building a GameBoy emulator in JavaScript](http://imrannazar.com/GameBoy-Emulation-in-JavaScript) by _Imran Nazar_
|
||||
- [Game Boy Camera RE](https://github.com/AntonioND/gbcam-rev-engineer) Documentation about GB Camera and tools used to reverse engineer it by using Arduino UNO
|
||||
|
||||
## Development Softwares and Tools
|
||||
- [rgbds](https://github.com/bentley/rgbds) The main gb devkit. Assembler and linker package, currently updated. This is your main tool to write code in **ASM**.
|
||||
- [The GameBoy Developer's Kit (GBDK)](http://gbdk.sourceforge.net/) A set of tools that enable to develop programs for the Nintendo GameBoy system, either in **C** or in assembly. GBDK includes a set of libraries for the most common requirements and generates image files for use with a real GameBoy.
|
||||
- [rgbds](https://github.com/bentley/rgbds) The main gb devkit. Assembler and linker package, currently updated. This is your main tool to write code in **ASM**.
|
||||
- [The GameBoy Developer's Kit (GBDK)](http://gbdk.sourceforge.net/) A set of tools that enable to develop programs for the Nintendo GameBoy system, either in **C** or in assembly. GBDK includes a set of libraries for the most common requirements and generates image files for use with a real GameBoy.
|
||||
- [BGB](http://bgb.bircd.org/) Powerful GameBoy **emulator** and **debugger**. Provides an accurate hardware emulation.
|
||||
- [Gameboy Tile Data Generator](http://www.chrisantonellis.com/gameboy/gbtdg/) HTML5 / JS web application that will **convert bitmap images to hexidecimal data** appropriate for use in tile based graphical applications, specifically GB.
|
||||
- [rgbds_textmate](https://github.com/Bananattack/rgbds_textmate) Some syntax highlighting rules for coding in Z80 assembly as a Textmate language plugin. Works in Sublime Text 2 and 3\. The syntax is particularly designed for [RGBDS](http://www.otakunozoku.com/rednex-gameboy-development-system/) and Gameboy-specific Z80 instructions.
|
||||
- [Harry Mulder's GB Development](http://www.devrs.com/gb/hmgd/intro.html) Some sources and home of GameBoy Tile Designer and GameBoy Map Builder tools
|
||||
- [rgbds_textmate](https://github.com/Bananattack/rgbds_textmate) Some syntax highlighting rules for coding in Z80 assembly as a Textmate language plugin. Works in Sublime Text 2 and 3\. The syntax is particularly designed for [RGBDS](http://www.otakunozoku.com/rednex-gameboy-development-system/) and Gameboy-specific Z80 instructions.
|
||||
- [Harry Mulder's GB Development](http://www.devrs.com/gb/hmgd/intro.html) Some sources and home of GameBoy Tile Designer and GameBoy Map Builder tools
|
||||
- [Gambatte](http://sourceforge.net/projects/gambatte/) Open-source, cross-platform and accurate **emulator** for gb/gbc
|
||||
- [GBT PLAYER](https://github.com/AntonioND/gbt-player) A music player library and converter kit for Game Boy that can be used with RGBDS.
|
||||
|
||||
## Programming Tutorials
|
||||
asm
|
||||
- [ASMSchool](http://gameboy.mongenel.com/asmschool.html) In this page you can find: a set of lessons by Duo about coding in Assembly for GB/GBC (from the basics to the first program), 2 lessons about disassembling and some old articles (about asm programming) written by various coders.
|
||||
- [dev'rs ASM section](http://www.devrs.com/gb/asmcode.php) a lot of working demos and sources
|
||||
- [assembly tutorial by David Pello](http://wiki.ladecadence.net/doku.php?do=show&id=tutorial_de_ensamblador) Good document to actually learn to produce working asm code for gb. Brief explainations of many important topics. Many examples with commented source code. (spanish only)
|
||||
- [assembly tutorial by David Pello](http://92.19.232.58:82/files/GameBoy_RGBDS_ASM_Tutorial.zip) The english version by _a cat_
|
||||
- [Beginners Guide to Reverse Engineering GB](http://www.bennvenn.com/Beginners_Guide_To_Reverse_Engineering.htm)
|
||||
- [ASMSchool](http://gameboy.mongenel.com/asmschool.html) In this page you can find: a set of lessons by Duo about coding in Assembly for GB/GBC (from the basics to the first program), 2 lessons about disassembling and some old articles (about asm programming) written by various coders.
|
||||
- [dev'rs ASM section](http://www.devrs.com/gb/asmcode.php) a lot of working demos and sources
|
||||
- [assembly tutorial by David Pello](http://wiki.ladecadence.net/doku.php?do=show&id=tutorial_de_ensamblador) Good document to actually learn to produce working asm code for gb. Brief explainations of many important topics. Many examples with commented source code. (spanish only)
|
||||
- [assembly tutorial by David Pello](http://92.19.232.58:82/files/GameBoy_RGBDS_ASM_Tutorial.zip) The english version by _a cat_
|
||||
- [Beginners Guide to Reverse Engineering GB](http://www.bennvenn.com/Beginners_Guide_To_Reverse_Engineering.htm)
|
||||
- [Writing a Gameboy game in ASM - Intro to Binary and Hexadecimal](http://siobyte.xyz/1-gameboy-tutorial/)
|
||||
- [Gameboy DMA transfer routines](http://siobyte.xyz/fast-dma/)
|
||||
|
||||
gbdk
|
||||
- [Grooves Game Boy Programming](https://github.com/gbdk-salvage/grooves-game-boy-programming)
|
||||
- [8-Bit Wonderland](http://belial.blarzwurst.de/gbpaper/paper.pdf) Well-written introductory document about how Game Boy works and how to start developing working code for it.
|
||||
- [GameBoy home of Flavor](http://www.personal.triticom.com/~erm/GameBoy/) Some full games and sources
|
||||
- [How to Write a Simple Side Scrolling Game](http://pastebin.com/F3tHLj68)
|
||||
- [Grooves Game Boy Programming](https://github.com/gbdk-salvage/grooves-game-boy-programming)
|
||||
- [8-Bit Wonderland](http://belial.blarzwurst.de/gbpaper/paper.pdf) Well-written introductory document about how Game Boy works and how to start developing working code for it.
|
||||
- [GameBoy home of Flavor](http://www.personal.triticom.com/~erm/GameBoy/) Some full games and sources
|
||||
- [How to Write a Simple Side Scrolling Game](http://pastebin.com/F3tHLj68)
|
||||
- [Just another simple tutorial](http://pastebin.com/gzT47MPJ)
|
||||
- [GBDK Tutorial by Ryan Carson](https://refreshgames.co.uk/2016/04/18/gameboy-tutorial-rom/) Fairly minimal game demo for getting started with GBDEK
|
||||
|
||||
@@ -78,11 +78,11 @@ gbdk
|
||||
## Cartridges
|
||||
- [AntonioND's docs](https://github.com/AntonioND/giibiiadvance/tree/master/docs) corrected schematics and infos on cartridge header data
|
||||
- [Gekkio's Gameboy cartridge types](http://gekkio.fi/)blog/2015-02-14-mooneye-gb-gameboy-cartridge-types.html)
|
||||
- [Gekkio](http://gekkio.fi/blog/)'s cartridge analysis [DMG-BEAN-02](http://gekkio.fi/blog/2015-05-18-mooneye-gb-cartridge-analysis-dmg-bean-02.html), [MBC1](http://gekkio.fi/blog/2015-05-17-mooneye-gb-cartridge-analysis-fortress-of-fear.html), [no MBC](http://gekkio.fi/blog/2015-02-28-mooneye-gb-cartridge-analysis-tetris.html)
|
||||
- [Gameboy Cartridges Schematics](http://www.devrs.com/gb/files/gb.html)
|
||||
- [Reiner Ziegler's GameBoy page](http://www.reinerziegler.de/readplus.htm) Commercial and homemades programmable cartridges and programming systems. Tutorials, wiring and schematics provided.
|
||||
- [MBC1+Ram+Battery cartridge Schematic](http://www.devrs.com/gb/files/mbc1.gif) by Jeff Frohwein
|
||||
- [MBC1 and MBC2 cartridges circuits](http://fms.komkon.org/GameBoy/Tech/Carts.html) and explaination on how these MBC actually bank switch and control RAM.
|
||||
- [Gekkio](http://gekkio.fi/blog/)'s cartridge analysis [DMG-BEAN-02](http://gekkio.fi/blog/2015-05-18-mooneye-gb-cartridge-analysis-dmg-bean-02.html), [MBC1](http://gekkio.fi/blog/2015-05-17-mooneye-gb-cartridge-analysis-fortress-of-fear.html), [no MBC](http://gekkio.fi/blog/2015-02-28-mooneye-gb-cartridge-analysis-tetris.html)
|
||||
- [Gameboy Cartridges Schematics](http://www.devrs.com/gb/files/gb.html)
|
||||
- [Reiner Ziegler's GameBoy page](http://www.reinerziegler.de/readplus.htm) Commercial and homemades programmable cartridges and programming systems. Tutorials, wiring and schematics provided.
|
||||
- [MBC1+Ram+Battery cartridge Schematic](http://www.devrs.com/gb/files/mbc1.gif) by Jeff Frohwein
|
||||
- [MBC1 and MBC2 cartridges circuits](http://fms.komkon.org/GameBoy/Tech/Carts.html) and explaination on how these MBC actually bank switch and control RAM.
|
||||
- [GB Rom List](https://docs.google.com/spreadsheets/d/1cOS__xEj8bBT7cqEDgJcYStKuFAS8mMA4uErx9kA40M/edit?usp=sharing) Navigable table of every GB game released with details on their cartridges(RAM, ROM, PCB type,..)
|
||||
- [Game Boy cartridge PCB photos](http://gekkio.fi/blog/2016-03-19-game-boy-cartridge-pcb-photos.html)
|
||||
|
||||
@@ -90,24 +90,23 @@ gbdk
|
||||
- [fpgaboy](https://github.com/trun/fpgaboy) Implementation Nintendo's GameBoy console on an FPGA
|
||||
- [php-terminal-gameboy-emulator](https://github.com/gabrielrcouto/php-terminal-gameboy-emulator) A PHP Terminal GameBoy Emulator
|
||||
- [JavaScript GameBoy Color Emulator](https://github.com/taisel/GameBoy-Online) A GameBoy Color emulator that utilizes HTML5 canvas and JavaScript audio APIs to provide a full emulation of the console
|
||||
- [weplay](https://github.com/rauchg/weplay) Collaborative gameboy emulation powered 100% by JavaScript
|
||||
- [weplay](https://github.com/rauchg/weplay) Collaborative gameboy emulation powered 100% by JavaScript
|
||||
- [gbasm](https://github.com/BonsaiDen/gbasm) A JavaScript based compiler for Gameboy z80 assembly code
|
||||
- [Piglet](https://github.com/danShumway/Piglet) A LUA driven AI that plays classic gameboy color games using experimentation. In active development.
|
||||
- [The GameBoy Project](http://marc.rawer.de/Gameboy/Docs/GBProject.pdf) A work by 6 students of Fachhochschule Karlsruhe University. The document provides a **study on the hardware** and detailed constructional information for the realisation of three 8 bitbidirectional parallel ports.
|
||||
- [gbdk-n](https://github.com/rotmoset/gbdk-n) This project aims to update the gbdk libraries to be compatible with new versions of SDCC and provide helpers for building roms. WIP
|
||||
- [Wiz by Andrew G. Crowell](https://github.com/Bananattack) A high-level assembly language for writing homebrew on retro console platforms (Game Boy, NES, Atari 2600, and more). WIP
|
||||
- [Mooneye-gb](https://github.com/Gekkio/mooneye-gb) Work-In-Progress emulator made in Rust. The main goals of this project are accuracy and documentation. Existing emulators are very accurate but are not documented very clearly, so they are not that good references for emulator developers. This project is meant to document as clearly as possible _why_ certain behaviour is emulated in a certain way. This also means writing a lot of test ROMs to figure out corner cases and precise behaviour on real hardware.
|
||||
- [gbdk-n](https://github.com/rotmoset/gbdk-n) This project aims to update the gbdk libraries to be compatible with new versions of SDCC and provide helpers for building roms. WIP
|
||||
- [Wiz by Andrew G. Crowell](https://github.com/Bananattack) A high-level assembly language for writing homebrew on retro console platforms (Game Boy, NES, Atari 2600, and more). WIP
|
||||
- [Mooneye-gb](https://github.com/Gekkio/mooneye-gb) Work-In-Progress emulator made in Rust. The main goals of this project are accuracy and documentation. Existing emulators are very accurate but are not documented very clearly, so they are not that good references for emulator developers. This project is meant to document as clearly as possible _why_ certain behaviour is emulated in a certain way. This also means writing a lot of test ROMs to figure out corner cases and precise behaviour on real hardware.
|
||||
- [Gatesboy](https://web.archive.org/web/*/http://www.gatesboy.com/)* non-gaming purposes applications development.
|
||||
- [RealBoy blog](https://realboyemulator.wordpress.com/) Articles about the GB hardware and an interesting analysis of the start up phase (bootstrap).
|
||||
- [pdroms.de](http://pdroms.de/news/gameboy/) Gameboy releases.
|
||||
- [Gameboy Demospotting](http://gameboy.modermodemet.se/en) A collection of demos.
|
||||
- [RealBoy blog](https://realboyemulator.wordpress.com/) Articles about the GB hardware and an interesting analysis of the start up phase (bootstrap).
|
||||
- [pdroms.de](http://pdroms.de/news/gameboy/) Gameboy releases.
|
||||
- [Gameboy Demospotting](http://gameboy.modermodemet.se/en) A collection of demos.
|
||||
- [Nintendo's fake logos](http://fuji.drillspirits.net/?post=87) Every cartdrige has to show the authentic logo to be considered valid and be runned, but obviously some companies managed to exploit the check system.
|
||||
- [GBDK Developers](http://gbdk-developers.com/) Active blog about everything related to the scene. Features insights and interviews.
|
||||
|
||||
## Contributing
|
||||
Help is appreciated. This list mainly need clear and explicative descriptions for every resource.
|
||||
If want to suggest some resources, make an individual pull request for each suggestion and be sure to include a clear title and a link to your suggested resource (or list them in an issue).
|
||||
See also the [Contribution guidelines](https://github.com/avivace/awesome-gbdev/blob/master/CONTRIBUTING.md).
|
||||
|
||||
## License
|
||||
|
||||
|
||||
12
SOURCES.md
12
SOURCES.md
@@ -1,13 +1,15 @@
|
||||
# gbdev Sources
|
||||
This is a list of demos,full homebrews or games for GameBoy with complete sources available. If you have a notable work you think should be here, feel free to contribute with a pull request or an issue(see also the [Contribution guidelines](https://github.com/avivace/awesome-gbdev/blob/master/CONTRIBUTING.md)).
|
||||
|
||||
## Honorable Mentions
|
||||
- [Infinity](https://github.com/infinity-gbc/infinity)
|
||||
|
||||
## ASM
|
||||
|
||||
- [Tuff](https://github.com/BonsaiDen/Tuff.gb)
|
||||
- [2048-gb](https://github.com/Sanqui/2048-gb)
|
||||
- [2048-gb](https://github.com/Sanqui/2048-gb)
|
||||
- [Snake](https://bitbucket.org/Sanqui/snake/src/?at=master)
|
||||
- [PlantBoy](https://github.com/siObyte/PlantBoy)
|
||||
- [PlantBoy](https://github.com/siObyte/PlantBoy)
|
||||
- [Lazerpong](https://github.com/huderlem/lazerpong)
|
||||
- [Back to Color](https://github.com/AntonioND/back-to-color)
|
||||
- [Geometrix](https://github.com/AntonioND/geometrix)
|
||||
@@ -16,6 +18,6 @@ This is a list of demos,full homebrews or games for GameBoy with complete source
|
||||
## C
|
||||
- [flappybird-gb](https://github.com/LuckyLights/flappybird-gb)
|
||||
- [Novascape](http://ludumdare.com/compo/ludum-dare-34/?action=preview&uid=6823)
|
||||
- [Squishy the Turtle](https://github.com/cppchriscpp/SquishyTheTurtle)
|
||||
- [Quadratino](https://github.com/avivace/quadratino)
|
||||
- [Doctor How](https://github.com/elfgames/doctorhow)
|
||||
- [Squishy the Turtle](https://github.com/cppchriscpp/SquishyTheTurtle)
|
||||
- [Quadratino](https://github.com/avivace/quadratino)
|
||||
- [Doctor How](https://github.com/elfgames/doctorhow)
|
||||
|
||||
Reference in New Issue
Block a user