From ef8e7fe62b49fcc184f8046d7aea6471cfc638c9 Mon Sep 17 00:00:00 2001 From: Astatin Date: Tue, 10 Dec 2024 15:16:02 +0900 Subject: Add readme --- README.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..02cdb50 --- /dev/null +++ b/README.md @@ -0,0 +1,49 @@ +# Bunnyland (temporary name) + +This is a gameboy game I am coding [live on twitch](https:/www.twitch.tv/astatinchan) ! Come and hang out ! + +# How to compile + +This game is made using Z80 assembly and should be compiled with the assembler I made for it + +The assembler is made in golang, check if you have it on your system, If you do not: + +```bash +# Arch +sudo pacman -S go + +# Debian/Ubuntu +sudo apt install golang + +# Windows: +# I don't know lol +``` + +Clone the assembler: +```bash +git clone https://github.com/AstatinChan/gameboy-asm.git +cd gameboy-asm +``` + +Compile the assembler: +```bash +go build . +``` + +And copy it as `gbasm` somewhere in your $PATH +```bash +sudo cp gameboy-asm /usr/local/bin/gbasm +``` + +We can now download the game sources +```bash +git clone git@github.com:AstatinChan/BunnyLand-Gameboy.git +cd Bunnyland-Gameboy +``` + +And assemble the ROM +```bash +make build/main.rom +``` + +The rom is inside of the build/ directory and can be played with the gameboy emulator of your choice (I also made an emulator you can use [here](https://github.com/AstatinChan/gameboy-emulator)) -- cgit v1.2.3-70-g09d2