Welcome to the assembly-coded wonderland of SIMON! Are you ready to test your memory skills and relive some retro magic? This game isn't just about winning—it's about embracing the pure, unfiltered awesomeness of assembly coding. So grab your virtual joystick, and let’s jump into this nostalgic ride! 🚀✨

• 🌟 About the Game
• ✨ Features
• 🔧 Getting Started
  • 📋 Prerequisites
  • 💾 Installation
• 🎮 How to Play
• 🖼️ Gameplay Preview
• 📝 Code Logic
• 🤔 Contributing
• 💄 License
• 📨 Contact

SIMON is the classic memory game we all know and love—brought back to life in Assembly language for DOS! 🖥️✨ Your mission, should you choose to accept it, is to remember and repeat increasingly complex sequences of keys. It's more than a game; it's an 8-bit retro party for your brain! 🎉

Think you're up for the challenge? Put your memory to the ultimate test and let's find out! 🧠💪

• Pure Assembly Code: Forget about fancy high-level programming—this game is made from scratch with the raw magic of assembly! 💻🧤
• Interactive Gameplay: Think you have what it takes to follow the sequence? SIMON is here to put you to the test! 🕰️
• Colorful Interface: Okay, maybe “colorful” by DOS standards... but hey, it's got character! 🌈😉
• Sound Effects: Beeps, boops, and bloops—classic gaming sounds to make you feel right at home! 🔊🎶
• Retro Vibes: Immerse yourself in the nostalgia of yesteryear, when floppy disks ruled and graphics were... well, simpler. 😎🕹️

To hop into this time machine and play SIMON, you'll need:

• A DOS emulator like DOSBox. Yep, we're going old-school! 💾
• An assembler like MASM or TASM. (Gotta get those assembly vibes!) 🔧
• Basic knowledge of how to assemble and run assembly programs. You got this! 💪

1. Clone the Repository:

   git clone https://github.com/yourusername/simon-assembly-game.git

   Easy-peasy! 🍋

2. Assemble the Code:

   Open your DOS emulator and navigate to the game directory. Time to work your magic! 🦉

   masm simon.asm;
   link simon.obj;

   Who knew coding could feel so nostalgic? 😌

3. Run the Game:

   simon.exe

   And boom—you’re ready to rock 'n' roll! 🎸

1. Start the Game:

   After running simon.exe, you'll be greeted by the legendary title screen. Get ready for the ultimate brain workout! 💥

   

2. Understand the Keys:

   • q = Green 🌿
   • w = Red 🔴
   • a = Blue 🔵
   • s = Yellow 🌼
   • ESC = End Game 😭

3. Game Mechanics:

   • Press ENTER to Start: And let the fun begin! 🚀

   • Watch the Sequence: The game will show you a sequence of keys. Keep those eyes peeled! 👀

     

   • Repeat the Sequence: Got it memorized? Now it's your turn! Tap those keys! ⌨️✨

   • Progress: Each round, the sequence gets longer, and your brain gets a bigger workout! How far can you go before your memory says “nope”? 🤯

   • Victory: Nailed it? Awesome! Revel in your moment of triumph! 🎉🏆

     

   • Defeat: Slip up? Don’t worry, it happens to the best of us! Dust yourself off and try again! 💔🕰️

     

4. Exit the Game:

   • Press ESC at any time to bow out.
   • After the game ends, press ENTER to return to DOS and bask in the glow of your assembly journey. ✨

Check out the action behind the scenes! 👀🎮

Ever wondered what's happening under the hood of this assembly masterpiece? Let's dive into the code logic and explore how SIMON comes to life! 🔍🧠

The game is written in 8086 Assembly language for DOS, utilizing BIOS and DOS interrupts for screen manipulation, keyboard input, and sound generation. Here's a high-level breakdown of the code structure:

1. Initialization: Set up data segments and display the start screen.
2. Main Game Loop: Generate and display the sequence, get user input, and check for correctness.
3. Display Functions: Handle drawing the game interface and updating the squares.
4. Sound Functions: Play tones corresponding to each square.
5. Utility Functions: Clear the screen, position the cursor, hide the cursor, etc.

Defines messages for display, key mappings, and temporary variables.

.data
titleMsg db "SIMON - A MEMORY GAME$", 0Dh, 0Ah, "$"
; ... other messages
keysToMove db 'w', 'a', 'q', 's' ; Key sequence
temp dw 3 ; Sequence length

Starts the game by displaying the title and instructions, waits for the player to press ENTER, and then enters the main game loop.

main proc
    ; Setup data segment
    mov ax, @data
    mov ds, ax

    ; Display start screen
    call clearScreen
    ; ... display messages

    ; Wait for ENTER key
waitForEnter:
    mov ah, 00h
    int 16h
    cmp al, 0dh
    jne waitForEnter

    ; Start the game
    call clearScreenWithoutBlink
    call cursorHider
    call drawSquares

    ; Main game loop
loopTheGame:
    inc temp ; Increase sequence length
    ; ... display sequence, get user input, check correctness

Displays the sequence to the player by lighting up squares and playing corresponding sounds.

displayInSeq:
    mov al, [si]
    call PlayAndDraw
    inc si
    inc cx
    cmp cx, temp
    jb displayInSeq

Captures the player's input and compares it with the generated sequence.

userInputSeq:
    push cx
    mov ah, 07h
    int 21h
    call PlayAndDraw
    cmp al, 1bh ; ESC key to exit
    jne notCancel
    jmp exit

notCancel:
    cmp al, [si]
    jne wrongInput
    inc si
    pop cx
    inc cx
    cmp cx, temp
    jb userInputSeq

Handles the logic for updating the display and playing sounds based on the key pressed.

PlayAndDraw proc
    push ax
    ; Check which key was pressed and call corresponding functions
    cmp al, 'q'
    jne ifNotGreen
    call newGreen
    mov bx, 5709 ; Sound frequency for green
    call playMusic
    call newGreen2
    jmp incomplete

    ; ... similar blocks for other keys

incomplete:
    pop ax
    ret
PlayAndDraw endp

Functions like newGreen, newGreen2, newred, etc., draw the colored squares on the screen.

newGreen proc
    mov bl, 0aah ; Light green color code
    mov dl, 29 ; X-axis
    mov dh, 5 ; Y-axis
    call drawLines
    ret
newGreen endp

The playMusic procedure plays a tone corresponding to the square's color.

playMusic proc
    push cx
    mov al, 10110110B
    out 43H, al
    mov ax, bx
    out 42H, al
    mov al, ah
    out 42H, al
    ; ... wait and stop sound
    pop cx
    ret
playMusic endp

• clearScreen: Clears the screen.
• cursorHider: Hides the blinking cursor during gameplay.
• positioningTheCursor: Positions the cursor at a specific location.
• printString: Prints strings to the screen.

1. Start Screen: Displays the title and instructions.
2. Waiting for Start: The game waits for the player to press ENTER.
3. Sequence Display: Shows the sequence by lighting up squares and playing sounds.
4. Player Input: Waits for the player to repeat the sequence.
5. Checking Input: Compares the player's input with the sequence.
   • Correct Input: If the input matches, the game increases the sequence length and loops back.
   • Incorrect Input: Displays the defeat message and exits the game.
6. End Game: Upon completion or exit, displays a message and waits for ENTER to return to DOS.

• Sequence Generation: The sequence is currently static, stored in keysToMove. To make it dynamic, you could implement random key selection.
• Game Loop: The game attempts to loop indefinitely, increasing the difficulty each time.
• Sound and Graphics: Uses low-level BIOS interrupts for sound and graphics, giving it an authentic retro feel.

• Randomized Sequences: Implement a random number generator to create unpredictable sequences.
• Score Tracking: Keep track of the player's score or highest level reached.
• Optimized Code: Refine the assembly code for efficiency and readability.
• Error Handling: Add more robust input validation and error messages.

Feel free to dive into the code and tinker around! The beauty of assembly is that it gives you complete control over the hardware. Happy coding! 👩‍💻👨‍💻

Think you can make SIMON even more awesome? We'd love your help!

• Report Bugs: If you spot a glitch, shout it out! 🐛📢
• Enhance Features: Have an idea for a new twist? Code it up and submit a pull request! 💡🚀
• Optimize Code: Attention, assembly wizards! If you know how to make this faster or cleaner, we want you! 🧝‍♀️✨

This project is open-source and available under the MIT License. Feel free to make it your own! 📝💖

Got questions, want to collaborate, or just feel like saying hi? We're all ears! 👂

• Email: dean97531@gmail.com 📧
• GitHub: LeitAtar 🌐

Enjoy the game and may your memory be unbeatable! 🧠🎉

Happy coding and gaming! 👾💙