From 6399afedf9ea8b8ccf7d9b96fa0317210cd8807e Mon Sep 17 00:00:00 2001 From: Jan Szoja Date: Sat, 6 Sep 2025 19:37:12 +0100 Subject: [PATCH 1/4] Create README.md --- README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..cf79880 --- /dev/null +++ b/README.md @@ -0,0 +1,33 @@ +# Setup + +## Linux (Ubuntu) + +### 1. Wine + +That is needed for windows applications emulation and the Atita Atari emulator is for windows. +This turorial uses Altira, hence I'm sticking to it, but you might want to try other Linux native Atari emulators. + +```shell +sudo dpkg --add-architecture i386 +sudo apt update + +# on older Ubuntus you might want to add latest repo of winehq +wget -qO- https://dl.winehq.org/wine-builds/winehq.key | sudo apt-key add - +sudo apt install software-properties-common +sudo apt-add-repository "deb http://dl.winehq.org/wine-builds/ubuntu/ $(lsb_release -cs) main" +sudo apt install --install-recommends winehq-stable + +# need to configure it and allow installing other required modules - just agree when asked +winecfg +``` + +### 2. Atari Emulator - Altira + +Just download it from https://virtualdub.org/altirra.html + +### 3. Assembler + +# Links +1. https://linuxize.com/post/how-to-install-wine-on-ubuntu-20-04/ +2. https://virtualdub.org/altirra.html +3. From 630c71ef7e4cfcd188a6f424c477213fe82f5cfb Mon Sep 17 00:00:00 2001 From: Jan Szoja Date: Sat, 6 Sep 2025 19:55:53 +0100 Subject: [PATCH 2/4] Update README.md Info about assemblers --- README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index cf79880..1978993 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,20 @@ Just download it from https://virtualdub.org/altirra.html ### 3. Assembler +The MADS assembler is available for download/clone from github repository: https://github.com/wudsn/wudsn-ide-tools/tree/main/ASM/MADS + +For linux machinne with 64bit system you can try https://github.com/wudsn/wudsn-ide-tools/blob/main/ASM/MADS/mads.linux-x86-64 + +Likely you want to move it to one of the system binaries folders to have it avaliable under `mads` command: +```shell +sudo cp mads.linux-x86-64 /usr/local/bin/mads + +# and check if working +mads --version +``` + # Links 1. https://linuxize.com/post/how-to-install-wine-on-ubuntu-20-04/ 2. https://virtualdub.org/altirra.html -3. +3. https://www.wudsn.com/ +4. https://github.com/wudsn/wudsn-ide-tools/tree/main/ASM/MADS From b1e7ad951a616b32262929d6c6694858acea72a7 Mon Sep 17 00:00:00 2001 From: Jan Szoja Date: Sat, 6 Sep 2025 20:13:07 +0100 Subject: [PATCH 3/4] Filled README section for Windows --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 1978993..6201f7d 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,18 @@ # Setup +## Windows + +### 1. Atari Emulator - Altira + +Just download it from https://virtualdub.org/altirra.html + +### 3. Assembler + +The MADS assembler is available for download/clone from github repository: https://github.com/wudsn/wudsn-ide-tools/tree/main/ASM/MADS + +Copy the whole folder to your C: drive. + + ## Linux (Ubuntu) ### 1. Wine From 1113e206f1e699d90526a9495eeed828c1f31aae Mon Sep 17 00:00:00 2001 From: Jan Szoja Date: Sat, 6 Sep 2025 22:45:27 +0100 Subject: [PATCH 4/4] Update README.md --- README.md | 26 ++++++++++++++++++++++---- 1 file changed, 22 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 6201f7d..dd96342 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,16 @@ +# Description + +This repository contains final code for each episode of [Coding a Roguelike in Atari 8-bit Assembly](https://youtu.be/whhTuBpkcrY?si=NNua2iIBsaxaKKlB) podcasts. + +Ever wanted to write a game on the ATARI 8-Bit? If so, you're not alone! Come along with me on my journey to make a Roguelike on the Atari 8-bit computer in 6502 Assembly language! + +Socials: +- Instagram: / missionedpossible +- Twitter: / missionedposs +- Facebook: / missionedpossible +- Website: http://missionedpossible.com + + # Setup ## Windows @@ -50,10 +63,15 @@ sudo cp mads.linux-x86-64 /usr/local/bin/mads # and check if working mads --version + +# compiling .asm files +masm -lt main.asm ``` # Links -1. https://linuxize.com/post/how-to-install-wine-on-ubuntu-20-04/ -2. https://virtualdub.org/altirra.html -3. https://www.wudsn.com/ -4. https://github.com/wudsn/wudsn-ide-tools/tree/main/ASM/MADS +1. [Coding a Roguelike in Atari 8-bit Assembly podcast](https://youtu.be/whhTuBpkcrY?si=NNua2iIBsaxaKKlB) +2. [How to install wine](https://linuxize.com/post/how-to-install-wine-on-ubuntu-20-04/) +3. [Altirra Atari Emulator](https://virtualdub.org/altirra.html) +4. [WUDSN Atari Demo Group Page](https://www.wudsn.com/) +5. [Assemblers Repository](https://github.com/wudsn/wudsn-ide-tools/tree/main/ASM/MADS) +6. [Atari Memory Map](https://www.atariarchives.org/mapping/memorymap.php)