https://github.com/vinheim3/tetris-gb-disasm

https://github.com/vinheim3/tetris-gb-disasm

Last synced: 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/vinheim3/tetris-gb-disasm
• Owner: vinheim3
• License: mit
• Created: 2021-06-01T22:56:35.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-01-19T09:20:58.000Z (over 1 year ago)
• Last Synced: 2024-01-24T15:42:10.195Z (5 months ago)
• Language: Assembly
• Size: 1.21 MB
• Stars: 23
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-gbdev - Tetris - Complete Tetris disassembly. (Reverse Engineering / Game Disassemblies)
• awesome-gb-dev-zh - 俄罗斯方块

README

        
# Common

* Place `tetris.gb` in the `tools/` directory, and `web/` directory

* Former is used for scripts, and `tools/cmp.sh`, and the latter for web visualisations

# Building

* Install RGBDS v0.6.1

* Run `make` within the `disasm` directory

* Run `tools/cmp.sh` to compare built ROM against original ROM

# Web

* Start a web server within the `web/` directory, eg `python3 -m http.server`

* Navigate to the root page to see a list of game screens and sprites

# Project Structure

* `disasm`

  * `code` - dissected and commented asm that runs the game

  * `data` - large blocks of data, layouts are in `.bin` files

  * `gfx` - pngs of 1bpp and 2bpp data

  * `include` - constants, hardware definitions, ram, macros and structs

  * `includes.s` - imported definitions, excluding those that need building, eg ram

* `tools` - misc tools to help with disassembly

* `web` - the html+js in 1 file to visualise

  * `docs` - reference images, and flow .drawio

# Note on improvements

The project serves to describe everything that makes the game function as it does. Some things are not completely clear from the outset. If you need a full guide on a particular concept, eg sound engine, or some part of the disassembly needs further clarification, please feel free to raise an issue