aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorAstatin <[email protected]>2024-12-10 15:16:02 +0900
committerAstatin <[email protected]>2024-12-10 15:16:02 +0900
commitef8e7fe62b49fcc184f8046d7aea6471cfc638c9 (patch)
treeab0b93e78eae8ff73954c149f4419c2f67206ae5 /README.md
parent9af81e83a630f45f915649c5ad5144e848ccfae8 (diff)
Add readme
Diffstat (limited to 'README.md')
-rw-r--r--README.md49
1 files changed, 49 insertions, 0 deletions
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 [email protected]: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))